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Introduction 


Welcome to Blender! Blender is a free and open-source 3D 
creation Suite. 


With Blender, you can create 3D visualizations such as still 
images, 3D animations and VFX shots. You can also edit 
videos. It is well suited to individuals and small studios who 
benefit from its unified pipeline and responsive 
development process. 


Being a cross-platform application, Blender runs on Linux, 
macOS, as well as Windows systems. It also has relatively 
small memory and drive requirements compared to other 
3D creation suites. Its interface uses OpenGL to provide a 
consistent experience across all supported hardware and 

platforms. 


Who uses Blender? 


Blender has a wide variety of tools making it suitable for 
almost any sort of media production. Professionals, 
hobbyists, and studios around the world use it for creating 
animations, game assets, motion graphics, TV shows, 
concept art, story-boarding, commercials, and feature films. 


Check out the User Stories page on the Blender website for 
more examples. 


Key Features 


e Blender is a fully integrated 3D content creation suite, 

offering a broad range of essential tools, including 

Editing, VEX, Compositing, Texturing, and many types of 

Simulations. 

It is cross platform, with an OpenGL GUI that is uniform 

on all major platforms (and customizable with Python 

scripts). 

e It has a high-quality 3D architecture, enabling fast and 
efficient creation workflow. 

e It boasts active community support. See 
blender.org/community for an extensive list of sites. 

e It has a small executable, which is optionally portable. 


You can download the latest version of Blender here. 


A rendered image being post-processed. 


Blender makes it possible to perform a wide range of tasks, 
and it may seem daunting when first trying to grasp the 
basics. However, with a bit of motivation and the right 
learning material, it is possible to familiarize yourself with 
Blender after a few hours of practice. 


This manual is a good start, though it serves more as a 
reference. There are also many online video tutorials from 
specialized websites. 


Despite everything Blender can do, it remains a tool. Great 
artists do not create masterpieces by pressing buttons or 
manipulating brushes, but by learning and practicing 
subjects such as human anatomy, composition, lighting, 
animation principles, etc. 


3D creation software such as Blender have an added 
technical complexity and jargon associated with the 
underlying technologies. Terms like UV maps, materials, 
Shaders, meshes, and “subdivs” are the media of the digital 


artist, and understanding them, even broadly, will help you 
to use Blender to its best. 


So keep reading this manual, learn the great tool that 
Blender is, and keep your mind open to other artistic and 
technological areas - and you, too, can become a great 
artist. 


Blender’s History 


In 1988, Ton Roosendaal co-founded the Dutch animation 
studio NeoGeo. NeoGeo quickly became the largest 3D 
animation studio in the Netherlands and one of the leading 
animation houses in Europe. NeoGeo created award-winning 
productions (European Corporate Video Awards 1993 and 
1995) for large corporate clients such as the multinational 
electronics company Philips. Within NeoGeo, Ton was 
responsible for both art direction and internal software 
development. After careful deliberation, Ton decided that 
the current in-house 3D tool set for NeoGeo was too old and 
cumbersome to maintain, and needed to be rewritten from 
scratch. In 1995 this rewrite began and was destined to 
become the 3D software creation we all know as Blender. As 
NeoGeo continued to refine and improve Blender, it became 
apparent to Ton that Blender could be used as a tool for 
other artists outside of NeoGeo. 


In 1998, Ton decided to found a new company called Not a 
Number (NaN) as a spin-off of NeoGeo to further market and 
develop Blender. At the core of NaN was a desire to create 
and distribute a compact, cross-platform 3D application for 
free. At the time, this was a revolutionary concept as most 
commercial 3D applications cost thousands of dollars. NaN 
hoped to bring professional level 3D modeling and 
animation tools within the reach of the general computing 
public. NaN’s business model involved providing commercial 
products and services around Blender. In 1999 NaN 
attended its first SIGGRAPH conference in an effort to more 
widely promote Blender. Blender’s first SIGGRAPH 
convention was a huge success and gathered a tremendous 


amount of interest from both the press and attendees. 
Blender was a hit and its huge potential confirmed! 


Following the success of the SIGGRAPH conference in early 
2000, NaN secured financing of €4.5M from venture 
Capitalists. This large inflow of cash enabled NaN to rapidly 
expand its operations. Soon NaN boasted as many as 50 
employees working around the world trying to improve and 
promote Blender. In the summer of 2000, Blender 2.0 was 
released. This version of Blender added the integration of a 
game engine to the 3D application. By the end of 2000, the 
number of users registered on the NaN website exceeded 
250,000. 


Unfortunately, NaN’s ambitions and opportunities did not 
match the company’s capabilities and the market realities of 
the time. This over-extension resulted in restarting NaN with 
new investor funding and a smaller company in April 2001. 
Six months later NaN’s first commercial software product, 
Blender Publisher was launched. This product was targeted 
at the emerging market of interactive web-based 3D media. 
Due to disappointing sales and the ongoing difficult 
economic climate, the new investors decided to shut down 
all NaN operations. The shutdown also included 
discontinuing the development of Blender. Although there 
were clearly shortcomings in the then current version of 
Blender, such as a complex internal software architecture, 
unfinished features and a non-standard way of providing the 
GUI, the enthusiastic support from the user community and 
customers who had purchased Blender Publisher in the past, 
meant that Ton could not justify leaving Blender to fade into 
insignificance. Since restarting a company with a sufficiently 
large team of developers was not feasible, Ton Roosendaal 
founded the non-profit organization, Blender Foundation, in 
March 2002. 


The Blender Foundation’s primary goal was to find a way to 
continue developing and promoting Blender as a 
community-based open source project. In July 2002, Ton 
managed to get the NaN investors to agree to a unique 
Blender Foundation plan to attempt to release Blender as 
open source. The “Free Blender” campaign sought to raise 
€100,000 so that the Foundation could buy the rights to the 
Blender source code and intellectual property rights from 
the NaN investors and subsequently release Blender to the 
open source community. With an enthusiastic group of 
volunteers, among them several ex-NaN employees, a 
fundraising campaign was launched to “Free Blender”. To 
everyone’s surprise and delight the campaign reached the 
€100,000 goal in only seven short weeks. On Sunday, 
October 13, 2002, Blender was released to the world under 
the terms of the GNU GPL. Blender development continues 
to this day, driven by a team of dedicated volunteers from 
around the world led by Blender’s original creator, Ton 
Roosendaal. 


Version/Revision Milestones 


The start! 


e 1.00 - January 1994: Blender in development at 
animation studio NeoGeo. 

e 1.23 - January 1998: SGI version published on the 
web, IrisGL. 

e 1.30 - April 1998: Linux and FreeBSD version, port to 
OpenGL and X11. 

e 1.3x - June 1998: NaN founded. 

e 1.4x - September 1998: Sun and Linux Alpha version 
released. 

e 1.50 - November 1998: First Manual published. 


e 1.60 - April 1999: C-key (new features behind a lock, 
$95), Windows version released. 

e 1.6x - June 1999: BeOS and PPC version released. 

e 1.80 - June 2000: End of C-key, Blender full freeware 
again. 

e 2.00 - August 2000: Interactive 3D and real-time 
engine. 

e 2.10 - December 2000: New engine, physics, and 

Python. 

2.20 - August 2001: Character animation system. 

e 2.21 - October 2001: Blender Publisher launch. 

e 2.2x - December 2001: macOS version. 


Blender goes Open Source 


13 October 2002: 
Blender goes Open Source, lst Blender 
Conference. 


2.25 - October 2002: 
Blender Publisher becomes freely available, and the 
experimental tree of Blender is created, a coder’s 
playground. 


2.26 - February 2003: 
The first truly open source Blender release. 


2.27 - May 2003: 
The second open source Blender release. 


2.28x - July 2003: 
First of the 2.28x series. 


2.30 - October 2003: 
Preview release of the 2.3x Ul makeover presented at the 
2nd Blender Conference. 


2.31 - December 2003: 
Upgrade to stable 2.3x UI project. 


2.32 - January 2004: 
A major overhaul of internal rendering capabilities. 


2.33 - April 2004: 
Game Engine returns, ambient occlusion, new procedural 
textures. 


2.34 - August 2004: 
Particle interactions, LSCM UV mapping, functional YafRay 
integration, weighted creases in subdivision surfaces, 
ramp shaders, full OSA, and many (many) more. 


2.35 - November 2004: 
Another version full of improvements: object hooks, 
curve deforms and curve tapers, particle duplicators and 
much more. 


2.36 - December 2004: 
A stabilization version, much work behind the scenes, 
normal and displacement mapping improvements. 


2.37 - June 2005: 
Transformation tools and widgets, soft bodies, force 
fields, deflections, incremental subdivision surfaces, 
transparent shadows, and multi-threaded rendering. 


2.40 - December 2005: 
Full rework of armature system, shape keys, fur with 
particles, fluids, and rigid bodies. 


2.41 - January 2006: 
Lots of fixes, and some Game Engine features. 


2.42 - July 2006: 


The nodes release, Array modifier, vector blur, new 
physics engine, rendering, lip sync, and many other 
features. This was the release following Project Orange. 


2.43 - February 2007: 
Multiresolution meshes, multi-layer UV textures, multi- 
layer images and multi-pass rendering and baking, 
sculpting, retopology, multiple additional mattes, distort 
and filter nodes, modeling and animation improvements, 
better painting with multiple brushes, fluid particles, 
proxy objects, Sequencer rewrite, and post-production UV 
texturing. 


2.44 - May 2007: 
The big news, in addition to two new modifiers and re- 
awakening the 64-bit OS support, was the addition of 
subsurface scattering, which simulates light scattering 
beneath the surface of organic and soft objects. 


2.45 - September 2007: 
Serious bug fixes, with some performance issues 
addressed. 


2.46 - May 2008: 
The Peach release was the result of a huge effort of over 
70 developers providing enhancements to provide hair 
and fur, a new particle system, enhanced image 
browsing, cloth, a seamless and non-intrusive physics 
cache, rendering improvements in reflections, AO, and 
render baking, a Mesh Deform modifier for muscles and 
such, better animation support via armature tools and 
drawing, skinning, constraints and a colorful Action 
Editor, and much more. It contained the results of Project 
Peach. 


.47 - August 2008: 


Bugfix release. 


2.48 - October 2008: 


The Apricot release, cool GLSL shaders, lights and GE 
improvements, snap, sky simulator, Shrinkwrap modifier, 
and Python editing improvements. This contained the 
results Project Apricot. 


2.49 - June 2009: 


Node-based textures, armature sketching (called Etch-a- 
Ton), Boolean mesh operation improvements, JPEG2000 
Support, projection painting for direct transfer of images 
to models, and a significant Python script catalog. GE 
enhancements included video textures, where you can 
play movies in-game, upgrades to the Bullet physics 
engine, dome (fisheye) rendering, and more API GE calls 
made available. 


Blender 2.5x - The Recode! 


2.5x - From 2009 to August 2011: 


This series released four pre-version (from Alpha 0 in 
November 2009 to Beta in July 2010) and three stable 
versions (from 2.57 - April 2011 to 2.59 - August 2011). It 
was one of the most important development projects, 
with a total refactor of the software with new functions, 
redesign of the internal window manager and 
event/tool/data handling system, and new Python API. 
The final version of this project was Blender 2.59 in 
August 2011. 


Blender 2.6x to 2.7x - Improvements & Stabilizing 


2.60 - October 2011: 


Internationalization of the UI, improvements in the 
animation system and the GE, vertex weight groups 


modifiers, 3D audio and video, and bug fixes. 


2.61 - December 2011: 
The Cycles renderer was added to the trunk, the camera 
tracker was added, dynamic paint for modifying textures 
with mesh contact/approximation, the Ocean modifier to 
simulate ocean and foam, new add-ons, bug fixes, and 
more extensions added for the Python API. 


2.62 - February 2012: 
The Carve library was added to improve Boolean 
operations, support for object tracking was added, the 
Remesh modifier was added, many improvements in the 
GE, matrices and vectors in the Python API were 
improved, plus new add-ons, and many bug fixes. 


2.63 - April 2012: 
Bmesh was merged with the trunk, with full support for n- 
sided polygons, sculpt hiding, a panoramic camera for 
Cycles, mirror ball environment textures and float 
precision textures, render layer mask layers, ambient 
occlusion and viewport display of background images 
and render layers. New import and export add-ons were 
added, and 150 bug fixes. 


2.64 - October 2012: 
A mask editor was added, along with an improved motion 
tracker, OpenColorlO, Cycles improvements, Sequencer 
improvements, better mesh tools (Inset and Bevel were 
improved), new keying nodes, sculpt masking, Collada 
improvements, a new Skin modifier, a new compositing 
nodes back end, and the fixing of many bugs. 


2.65 - December 2012: 
Fire and smoke improvements, anisotropic shader for 
Cycles, modifier improvements, the Bevel tool now 


includes rounding, new add-ons, and over 200 bug fixes. 


2.66 - February 2013: 
Dynamic topology, rigid body simulation, improvements 
in Ul and usability (including retina display support), 
Cycles now supports hair, the Bevel tool now supports 
individual vertex beveling, new Mesh Cache modifier and 
the new UV Warp modifier, new SPH particle fluid solver. 
More than 250 bug fixes. 


2.67 - May 2013: 
Freestyle was added, paint system improvements, 
subsurface scattering for Cycles, Ceres library in the 
motion tracker, new custom Python nodes, new mesh 
modeling tools, better support for UTF-8 text and 
improvements in Text editors, new add-ons for 3D 
printing, over 260 bug fixes. 


2.68 - July 2013: 
New and improved modeling tools, three new Cycles 
nodes, big improvements in the motion tracker, Python 
scripts and drivers are disabled by default when loading 
files for security reasons, and over 280 bug fixes. 


2.69 - October 2013: 
Even more modeling tools, Cycles improved in many 
areas, plane tracking is added to the motion tracker, 
better support for FBX import/export, and over 270 bugs 
fixed. 


2.70 - March 2014: 
Cycles gets basic volumetric support on the CPU, more 
improvements to the motion tracker, two new modeling 
modifiers, some UI consistency improvements, and more 
than 560 bug fixes. 


2.71 - June 2014: 


Deformation motion blur and fire/smoke support is added 
to Cycles, Ul pop-ups are now draggable. There are 
performance optimizations for sculpting mode, new 
interpolation types for animation, many improvements to 
the GE, and over 400 bug fixes. 


2.72 - October 2014: 
Cycles gets volume and SSS support on the GPU, pie 
menus are added and tooltips greatly improved, the 
Intersection modeling tool is added, new Sun Beam node 
for the Compositor, Freestyle now works with Cycles, 
texture painting workflow is improved, and more than 
220 bug fixes. 


2./3 - January 2015: 
Cycles gets improved volumetric support, major upgrade 
to Grease Pencil, Windows gets Input Method Editors 
(IMEs) and general improvements to painting, Freestyle, 
Sequencer and add-ons. 


2.74 - March 2015: 
Support for custom normals, viewport compositing and 
improvements to hair dynamics. 


2.75 - July 2015: 
Integrated stereo/multi-view pipeline, Smooth Corrective 
modifier and new developmental dependency graph. 


2.76 - November 2015: 
Pixar OpenSubdiv support, Viewport and File Browser 
performance boost, node auto-offset, and a text effect 
strip for the Sequencer. 


2.77 - March 2016: 
OpenVDB support for caching of smoke/volumetric 
simulations, improved Cycles subsurface scattering, 
Grease Pencil stroke sculpting and improved workflow, 


and reworked library handling to manage missing and 
deleted data-blocks. 


2.78 - September 2016: 
Cycles support for spherical stereo images for VR, Grease 
Pencil works more similar to other 2D drawing software, 
Alembic import and export support, and improvements to 
Bendy Bones for easier and simpler rigging. 


2.79 - September 2017: 
New Cycles features: Denoising, Shadow catcher, and 
new Principled shader. Other improvements were made 
to Grease Pencil and Alembic. Support was also added for 
application templates. 


Blender 2.8 - Revamped UI 


2.80 - July 2019: 
A totally redesigned UI for easier navigation; improved 
viewport, gizmos, and tools. With Eevee a new physically 
based real-time render engine was created. The Grease 
Pencil got a big overhaul and is now a full 2D drawing 
and animation system. Replacing the old layers, 
collections are a powerful way to organize objects. Other 
improvements: Cycles, Modeling, Animation, 
Import/Export, Dependency Graph. 


2.81 - November 2019: 
Revamped sculpting tools, Cycles Optix accelerated 
rendering, denoising, many Eevee improvements, library 
overrides, Ul improvements and much more. 


2.82 - February 2020: 
UDIM and USD support, Mantaflow for fluids and smoke 
simulation, Al denoising, Grease Pencil improvements, 
and much more. 


2.83 - June 2020: 
3D Viewport virtual reality scene inspection, new volume 
object type, Cycles adaptive sampling, Cycles viewport 
denoising, sculpting improvements, and much more. 


Blender 2.9 - Refining 2.8 


2.90 - August 2020: 
Improved sky texture, Eevee motion blur, sculpting 
improvements, revamped modifier UI, improved 
modeling tools, and faster motion blur in Cycles. 


2.91 - November 2020: 
Outliner improvements, property search, improved mesh 
Boolean operations, animation curves, volume object and 
display improvements, and more refined sculpting tools. 


2.92 - February 2021: 
Geometry nodes, primitive add tool, sculpting 
improvements, Grease Pencil curve editing, Cycles Color 
Attribute baking, APIC fluid simulations, Video Sequencer 
improvements, and much more. 


2.93 - June 2021: 
New geometry nodes, sculpting improvements, Grease 
Pencil Line Art modifier along with other improvements, 


redesigned Cryptomatte workflow, and more. 


Blender 3.0 - Optimizing Performance 


3.0 - December 2021 
Asset Browser added, Cycles X, Eevee Attributes, New 
geometry nodes, animation update, Grease Pencil line art 
improvements, pose library, Open Image Denoising 2-8x 
faster, additional support for AMD on linux. 


3.1 - March 2022 
Major point clouds improvements, Cycles Apple Metal 
GPU support, Subdivision GPU support, image editor 
handles larger images, Major performance gains for 
geometry nodes, context aware search for geometry 
nodes. 


3.2 - June 2022 
Light groups for Cycles, true Shadow caustics, volume 
motion blur, GLTF improvements, AMD GPU Rendering on 
Linux, painting in sculpt mode, WEBp image support. 


3.3 - September 2022 
New hair object, procedural UV nodes, line art shadow 
and contour, Intel GPU rendering support via oneAPI, and 


improvements to library overrides. 


3.4 - December 2022 
Cycles path guiding, sculpting auto masking 
improvements, even more geometry nodes, and UV 
Editing improvements. 


About Free Software and 
the GPL 


When one hears about “free software”, 
the first thing that comes to mind might 

be “no cost”. While this is often true, the Qn 
term “free software” as used by the Free \ 
Software Foundation (originators of the 

GNU Project and creators of the GNU 

General Public License) is intended to 
mean “free as in freedom” rather than in 
the sense of “no cost” (which is usually 
referred to as “free as in free beer” or 
gratis). Free software in this sense is 
software which you are free to use, 
copy, modify, redistribute, with no limit. Contrast this with 
the licensing of most commercial software packages, where 
you are allowed to load the software on a single computer, 
are allowed to make no copies, and never see the source 
code. Free software allows incredible freedom to the end 
user. Since the source code is universally available, there 
are also many more chances for bugs to be caught and 
fixed. 


Powered by 


When a program is licensed under the GNU General Public 
License (the GPL): 


e You have the right to use the program for any purpose. 

e You have the right to modify the program and have 

access to the source codes. 

You have the right to copy and distribute the program. 

e You have the right to improve the program, and release 
your own versions. 


In return for these rights, you have some responsibilities if 
you distribute a GPL’d program. These responsibilities are 
designed to protect your freedoms and the freedoms of 
others: 


e You must provide a copy of the GPL with the program, so 
that recipients are aware of their rights under the 
license. 

e You must include the source code or make the source 
code freely available. 

e If you modify the code and distribute the modified 
version, you must license your modifications available 
under the GPL (or a compatible license). 

e You may not restrict the licensing of the program 
beyond the terms of the GPL (you may not turn a GPL’d 
program into a proprietary product). 


For more on the GPL, check its page on the GNU Project 
website. 


Note 


The GPL only applies to the Blender application and not 
the artwork you create with it; for more info see the 
Blender License. 


The Blender Community 


Being freely available from the start, even while it was 
closed source, considerably helped Blender’s adoption by 
the community. A large, stable, and active community of 
users has gathered around Blender since 1998. The 
community showed its support for Blender in 2002 when 
they helped raise €100,000 in seven weeks to enable 
Blender to go Open Source under the GNU GPL License. 


Independent Sites 


There are several independent websites such as forums, 
blogs, news, and tutorial sites dedicated to Blender. 


One of the largest community forums is Blender Artists, 
where Blender users gather to show off their creations, get 
feedback, ask and offer help and, in general, discuss 
Blender. 


Getting Support 


Blender’s community is one of its greatest features, so apart 
from this user manual, there are many different ways to get 
support from other users, such as Blender Chat, Stack 
Exchange, and Reddit. 


For studios and organizations there is Enterprise support, 
and for studios looking to add Blender to their pipeline, 
Blender Studio contains documentation and training 
material around this topic. If you think you have found an 
issue with Blender, please report a bug. 


More details about support can be found on the support 
page. 


Development 


Being open source, Blender welcomes development from 
volunteers. Communication between developers is done 
mostly through three platforms: 


e The developer.blender.org system 
e Various mailing lists 
e Online Chat (see below) 


If you are interested in helping develop Blender, see the Get 
Involved page. 


Blender Chat 


For real-time discussion, we have blender.chat which uses 
Blender ID for authentication. 


You can join these channels: 


e #today For getting answers from the community. 

e #blender-coders For developers to discuss Blender 
development. 

e #python For support for developers using the Python 
API. 

e #docs For discussion related to Blender’s 
documentation. 


Other Useful Links 


e Blender FAQ (Can | use Blender commercially? What is 
GPL/GNU? ...) 

« Demo and benchmark files 

e Developer’s Ask Us Anything! 


Installing Blender 


Blender is released approximately every three months. You 
can keep up to date with the latest changes through the 
release notes. 


System Requirements 


Blender is available for download on Windows, macOS, and 
Linux. Always check that the graphics drivers are up to date 
and that OpenGL is well supported. Blender has a set of 
minimum and recommended requirements; so make sure 
these are met before trying to install Blender. 


Support for other hardware such as graphic tablets and 3D 
mice are covered later in Configuring Hardware. 


Download Blender 


Blender offers a variety of different binary packages to 
choose from depending on their level of stability. Each 
package has the trade off of newest feature versus stability. 
The package that is right for you depends on your 
requirements for those two. A studio for example might 
want to have /ong-term support, while a hobbyist may want 
newer features, while others may just want to test 
upcoming features. Each package described below has 
something just right for everyone. 


Stable Release 
A package that contains the latest features and is 
considered stable without regressions. A new stable 


version is available about every three months. 


Long-term Support 
A package designed for long-lasting projects requiring a 


features, API changes or improvements. A new long-term 
Support version is available every year. 


Daily Builds 
A package updated daily to include the newest changes 
in development. These versions are not as thoroughly 
tested as the stable release, and might break, although 
they are official and usually not highly experimental. 


Note 


Blender’s source code is available for free to either 
reference or to Build from Source. While normal users are 
not expected to compile Blender, it does have 
advantages: 


e Blender is always up to date. 

e It allows access to any version or branch where a 
feature is being developed. 

e It can be freely customized. 


The procedure for installing a binary, either the latest stable 
release or a daily build, is the same. Follow the steps for 
your platform. 


Note 


Blender doesn’t have a built-in updating system. This 
means you will need to update Blender yourself by 


following the upgrade steps described in the sections 
below. 


Installation Guides 


e Installing_on Linux 

e Installing on macOS 

e Installing on Windows 
e Installing from Steam 


Installing on Linux 


Check the Downloading Blender page to find the minimum 
requirements and the different versions that are available 
for Blender (if you have not done so yet). 


Install from blender.org 


Download the Linux version for your architecture and 
uncompress the file to the desired location (€.g. ~/software or 
/usr/local). 


Blender can now be launched by double-clicking the 
executable. 


When using this method of installation, it is possible to have 
multiple versions of Blender installed. 


For ease of access, you can configure your system by 
adding a menu entry or shortcut for Blender. You may also 
associate blend-files with Blender so that when selected 
from the file browser, they will automatically open in 
Blender. These settings are typically found in conjunction 
with the Window Manager settings. (Gnome or KDE.) 


Install from Package Manager 


Some Linux distributions may have a specific package for 
Blender in their repositories. 


Installing Blender via the distribution’s native mechanisms 
ensures consistency with other packages on the system and 


may provide other features (given by the package 
manager), such as listing of packages, update notifications 
and automatic menu configuration. Be aware, though, that 
the package may be outdated compared to the latest official 
release, or not include some features of Blender. For 
example, some distributions do not build Blender with 
Cycles GPU rendering support, for licensing or other 
reasons. 


If there is a specific package for your distribution, you may 
choose what is preferable and most convenient, otherwise, 
the official binary is available on blender.org. 


Install from Snap 


Snap is a universal package manager designed to work 
across a range of distributions. Assuming snap is already 
installed, Blender can be installed through snap with: 


Snap install blender 


Installing from this method has a benefit that updates to 
Blender are automatically installed. Blender from Snap 
should have a more consistent distribution then individual 
package managers. 


Running from the Terminal 


See Launching from the terminal. 


Graphics System (X11 & 
Wayland) 


Blender supports both X11 and Wayland, see Linux 
Windowing_ Environment for details. 


Avoiding Alt-Mouse Conflict 


Some window managers default to Alt-LMB and Alt-RMB for 
moving and resizing windows. 


Blender uses these for various operations, notably: 


e Emulate 3 Button Mouse. 
e Select Edge Loops. 
e Changing_multiple properties at once. 


To access Blender’s full feature set, you can change the 
window manager settings to use the Meta key instead (also 
called Super or Windows key): 


Gnome 
Enter the following in a command line (effective at next 
login): 


gsettings set org.gnome.desktop.wm.preferences mouse-button- 
modifier '<Super>' 


KDE 


System Settings >» Window Management » Window 
Behavior >» Window Actions, Switch from ‘Alt’ to ‘Meta’ 
key. 


Updating on Linux 


On Linux there are various ways of updating Blender. This 
section covers the most common approaches. 


Updating from blender.org 


When an update for Blender is released, it can be 
downloaded directly from the Blender website and installed 
using the steps described in the section Install from 
blender.org. 


Updating with a Package Manager 


Many Linux distributions have packages for Blender 
available, which can be installed using the distribution’s 
package manager. After installation, Blender can be updated 
using the same steps as updating any other application. 


See also 
The Splash screen Defaults page for information about 


importing settings from previous Blender versions and 
other quick settings. 


Installing on macOS 


Check the Downloading Blender page to find the minimum 
requirements and the different versions that are available 
for Blender (if you have not done so yet). 


Install from DMG 


Blender for macOS is distributed as disk images (dmg-files). 
To mount the disk image, double-click on the dmg-file. Then 
drag Blender.app into the Applications folder. 


Depending on the Security and Privacy preferences of your 


Mac, macOS will request your approval before opening 
Blender for the first time. 


Tip 
How to Make a Portable Installation 
To keep all configuration files and installed add-ons inside 


the Blender application bundle, create a folder named 
config in the LOCAL directory. 


./Blender.app/Contents/Resources/3.4/config/ 


Updating on macOS 


On macOS there are various ways of updating Blender. This 
section covers the most common approach. 


Updating with DMG 


When an update for Blender is released, it can be 
downloaded directly from the Blender website. Install the 
new version by overwriting the current Blender.app in the 
Applications folder. You can rename Blender.app or place it in 
a different folder to have more than one version at a time. 


See also 


The Splash screen Defaults page for information about 
importing settings from previous Blender versions and 
other quick settings. 


Installing on Windows 


Check the Downloading Blender page to find the minimum 
requirements and the different versions that are available 
for Blender (if you have not done so yet). 


Download the zip-file or Windows Installer File. 


Install from Windows Installer 
File 


The Windows installer will let you choose an installation 
folder, and will create an entry in the start menu as well as 
associate blend-files with Blender. It requires administrator 
rights. 


Install from Zip 


When choosing the zip-file, you have to manually extract 
Blender to the desired folder, where you can double-click 
the executable to run Blender. 


No start menu item will be created and no blend-file 
association will be registered, but there is also no need for 
administrator rights. You can register the file association 
manually by clicking Make Default on the System tab of the 
Preferences. Alternatively, you can run blender -r from the 
Command Line. 


Tip 


How to Make a Portable Installation 


To keep all configuration files and installed add-ons in the 
executable folder, create a folder named config in the 
LOCAL directory of the unzipped folder. 


Install from Microsoft Store 


Blender can be installed from the Microsoft Store by 
searching for Blender in the Microsoft Store and installing it. 


Blender can now be launched from the Windows Start menu. 


Updating on Windows 


On Windows there are various ways of updating Blender. 
This section covers the most common approaches. 


Updating from Windows Installer File 


When an update for Blender is released, it can be 
downloaded directly from the Blender website. The Windows 
installer can then be run to install the updated version of 
Blender. To remove a previously installed version of Blender, 
use Windows settings or control panel to uninstall the 
desired version. 


Updating from Zip 
When an update for Blender is released, it can be 


downloaded directly from the Blender website and extracted 
to the desired folder, where you can double-click the 


executable to run Blender. For more information on creating 
a portable version of Blender, see the section Install from 
Zip. 


Note, you do not have to overwrite your existing Blender 


installation. It’s perfectly possible to have multiple versions 
installed side by side. 


Updating from the Microsoft Store 


When an update for Blender is available on the Microsoft 
Store, it will be downloaded and installed automatically. 


See also 
The Splash screen Defaults page for information about 


importing settings from previous Blender versions and 
other quick settings. 


Installing from Steam 


Steam is a software distribution platform. Blender can be 
downloaded and updated using the Steam client by 
following the steps described below on Linux, macOS, or 
Windows. 


Download the Steam client for your operating system. Once 
installed, open the client and login to your Steam account, 
or create one if you haven’t already. Once logged in, 
navigate to the Store tab, search for “Blender”, and press 
the green installation button. Blender should now be 
available in the Library tab of the Steam client. 


See also 


When installing Blender from Steam on Linux and 
Windows, the .blend filename extension will not be 
automatically associated with Blender. To associate blend- 
files with Blender, see the processes described on the 
Linux and Windows installation pages. 


Updating with Steam 


When an update for Blender is available on Steam, Steam 
will automatically update Blender for you. 


Linux Windowing 
Environment 


On Linux Blender supports both X11 and Wayland for official 
releases. 


When Wayland is detected, it is the preferred system, 
otherwise X11 will be used. 


Hint 


The current “Windowing Environment” is listed in File > 
About. 


X11 


This is the windowing environment that has been used most 
widely on Linux & Unix systems. 


There are no near-term plans to deprecate or remove X11 
Support. 


Wayland 


Support for Wayland is a more recent addition, so there may 
be configurations that have not been tested yet. Please 
report a bug if you experience problems. 


Blender has been tested with Gnome-Shell (mutter), KDE 
(plasma) & SWAY (wlroots) based compositors. 


Requirements 


Gnome-Shell 
Under Gnome-Shell the tibdecor library is required. This is 
available as a package on most Linux distribution. 


If the library isn’t found X11 will be used as a fallback. 


Troubleshooting 


Detailed Wayland output can help to track down problems. 
Launch Blender from the command-line with additional 
arguments: 


Blender’s Wayland Logging 

blender --log "“ghost.wl.*" --log-level 2 
Wayland Built-In Logging 

WAYLAND DEBUG=1 blender 
Disable Wayland (forcing X11) 


WAYLAND DISPLAY="" blender 


Known Limitations 


NVidia GPU 
Currently NVidia drivers don’t fully support features 
needed for Wayland support, graphical glitches and 
flickering is a common problem, this is not specific to 
Blender so NVidia users may want to use X11 until driver 
Support improves. 


Feature Comparison 


Feature 


Smooth Scroll 


Multi-Touch 
Gestures 


Reliable 
Cursor 
Warping 


Window 
Positioning 


Window 
Raise/Lower 


X11 Wayland Notes 


x *1 


x *2 


Smooth scrolling with 
track-pads. 


Track-pad and tablet 
Support for 

pinch to zoom, pan and 
orbit. 


Cursor warping is used 
while transforming 

and orbiting the viewport 
for e.g. 


Needed for dragging 
between windows and 
restoring window 
positions on file load. 


Used to bring the render 
window 
to the foreground. 


Other features which both systems support such as Hi-DPI, 
3D-mouse, tablet input, ... etc. have been left out of this list. 


“1 In X11 fast cursor motion may exit the window bounds 
while the cursor is grabbed (transforming for e.g.). 

*2 Wayland doesn’t support setting the window position & 
depth, as this is a design decision it’s unlikely to be 
Supported (see issues for position and depth). 


Configuring Blender 


e Introduction 

o Language 

fe) Input 

o File and Paths 

o Save & Load 
¢« Configuring Peripherals 

o Displays 

o Input Devices 

o Head-Mounted Displays (Virtual Reality) 
« Defaults 

o Saving Defaults 

o Loading _Factory Settings 


See also 


See Preferences for a complete list of options. 


Introduction 


Here are some preferences that you may wish to set initially. 
See the section Preferences for the complete list of available 
settings. 


Language 


Enable Edit > Interface > Translation, and choose the 
Language and what to translate from Interface, Tooltips and 
New Data. 


See Translation for details. 


Input 


If you have a compact keyboard without a separate number 
pad, enable Preferences > Input » Keyboard >» Emulate 
Numpad. This gives you the 3D view shortcuts regularly 
used on the number pad. 


If you do not have a middle mouse button, you can enable 
Preferences > Input » Mouse > Emulate 3 Button Mouse. This 
allows you to hold the Att or 0s key while dragging with the 
mouse, to orbit. 


See Input Preferences for details. 


File and Paths 


At Preferences » File Paths you can set options such as what 
Image Editor (GIMP, Krita...) and Animation Player to use. 


The Temporary Directory sets where to store files such as 
temporary renders and auto-saves. 


Tip 
The // at the start of each path in Blender means the 


directory of the currently opened blend-file, used to 
reference relative paths. 


See File Preferences for details. 


Save & Load 


If you trust the source of your blend-files, you can enable 
Auto Run Python Scripts. This option is meant to protect you 
from malicious Python scripts in blend-files that you got 
from someone else. Many users turn this option on, as 
advanced rigs tend to use scripts of some sort. 


See Save & Load Auto Run Python Scripts Preference. 


Configuring Peripherals 


Displays 


A full HD display or higher is recommended. Multi-monitor 
setups are supported, and workspaces can be configured to 
Span multiple monitors. 


Example of Blender’s multi-monitor support. 


Input Devices 


Blender supports various types of input devices: 


e Keyboard (recommended: keyboard with numeric 
keypad, English layout works best) 

e Mouse (recommended: three button mouse with scroll 
wheel) 

e NDOF Device (also Known as 3D Mouse) 


e Graphic Tablet 


Note 


If you don’t have a middle mouse button or numpad, you 
can emulate these in the Input Preferences. 


Mouse 
Mouse Button Emulation 


If you do not have a 3 button mouse, you will need to 
emulate it by checking the option in the Preferences. 


The following table shows the combinations used: 


3-button LMB MMB RMB 
Mouse 

2-button LMB Alt-LMB RMB 
Mouse 

Keyboard 


Numpad Emulation 


If you do not have a numpad on the side of your keyboard, 
you may want to emulate one. You can then use the number 
row at the top of the keyboard instead, but will no longer 
have access to these keys’ original functions (Such as 
switching between vertex/edge/face selection in Edit Mode). 


See also 


Read more about Numpad Emulation in the Preferences. 


Non-English Keyboards 


If you use a keyboard with a non-English layout, you may 
still benefit from switching to the UK or US layout while 
working with Blender. 


Note 


You can also change the keymap from the Preferences. 
However, this manual assumes you are using the default 
keymap. 


Graphic Tablet 


Graphics tablets can be used to provide a more traditional 
method of controlling the mouse cursor using a pen. This 
can help provide a more familiar experience for artists who 
are used to painting and drawing with similar tools, as well 
as provide additional controls such as pressure sensitivity. 


Note 


If you are using a graphic tablet instead of a mouse and 
pressure sensitivity does not work properly, try to place 
the mouse pointer in the Blender window and then 
unplug/replug your graphic tablet. This might help. 


NDOF (3D Mouse) 


navigate a scene in Blender. Currently only devices made by 
3Dconnexion are supported. These devices allow you to 
explore a scene, and make Fly/Walk Navigation easier to 
control. The NDOF device can be configured in the 
Preferences. These settings can also be accessed directly 
from the viewport using the NDOFMenu button on the NDOF 
device. 


See also 


See Input Preference for more information on configuring 
peripherals. 


Head-Mounted Displays (Virtual 
Reality) 


virtual environment. Attached to the head, they track head 
movements to project a seemingly surrounding world onto 
Small screens in front of the user’s eyes. If the system works 
well, they experience the virtual environment as if they 
were really inside of it. 


Supported Platforms 


Virtual reality support in Blender is implemented through 
the multi-platform OpenXR standard. This standard is new 
and therefore support for it is still limited. 


OpenXR compatible platforms. 


Platform 


HTC Vive Cosmos 


HTC Vive Focus 3 


Monado 


Oculus (Rift and 
Quest) 


SteamVR 


Varjo 


Windows Mixed 
Reality 


Operating 
System 


Windows 


Windows 


GNU/Linux 


Windows 


Windows, 
GNU/Linux 


Windows 


Windows 


Getting Started 


Notes 


Developer Preview 


Developer Preview 


Not recommended 
for general use 
yet. 


Requires Oculus 
v31 Software 
Update. Oculus 
Link required for 
Quest. 


Requires SteamVR 
1.16 or greater. 


Requires Windows 
10 May 2019 
Update (1903). 


The following subsections describe how an HMD can be set 
up for usage with the supported platforms. If this is not 
done, Blender will report an error when trying to start a 
virtual reality session. 


HTC Vive Cosmos 


The dedicated platform for the HTC Vive Cosmos is currently 
targeted at developers and may lack features found in other 
platforms. 


e Follow the steps from the Vive Developer Forums. 
e Enable the VR Scene Inspection add-on in Blender. 


HTC Vive Focus 3 


The dedicated platform for the HTC Vive Focus 3 is currently 
targeted at developers and may lack features found in other 
platforms. 


e Follow the steps from the Vive Developer Forums. 
e Enable the VR Scene Inspection add-on in Blender. 


Monado 


Monado is a free and open source XR platform for Linux. It is 
not yet ready for production usage and should only be used 
for testing purposes. 


e Packages are available for the following distributions: 


o Ubuntu (Eoan, Focal) 
o Debian (bullseye, sid) 


For other systems, it has to be compiled from source, 
which in this case is not recommended for people with 


little experience in compiling software. Follow the 
from Monado to do so 


nevertheless. 
e Enable the in Blender. 
Oculus 


provides full support for OpenXR as of the Oculus 
v31 Software Update. 


e Download and install the 


e Set Oculus as the active OpenXR runtime via the 
General tab in the Oculus App Settings. 


o 


Home 


Store Account Privacy Payment General Beta 
Library Unknown Sources 


Allow apps that have not been reviewed by Oculus to run. Learn more. 
Chats 


Events OpenXR Runtime 
Devices C:\WIND xedRealityRuntimejson. Make Oculus — Set Oculus as active 


ime to run OpenXR applications with the 


Settings Oculus Runtime. 


Library Locations 
This is where we'll put apps you install from the Oculus Store. Learn more. 


Automatic App Updates —@ 


Update apps automatically. 


Friends 
Notifications Bandwidth Limit No Limit » 


Help Center 


e Enable the in Blender. 


SteamVR 


provides full support for OpenXR as of SteamVR 
1.16. 


e Set SteamVR as the active OpenXR runtime via the 
Developer tab in the SteamVR Settings. 


© SteamVR Settings -_ x 


General Enable debugging options in the input 
binding user interface 
Play Area 


Rachboard Allow saving of timing info 
Controllers Show GPU Performance Graph in 

Headset 
Video 

Auto-save timing info on exit Off 
Audio 
Enable global input from overlays Off 
(Experimental) 


Startup / Shutdown 


Current OpenXR Runtime: Windows Mixed Reality 


SET STEAMVR AS OPENXR RUNTIME 


RESET PAGE TO DEFAULT 


Advanced Settings 


Show 


e Enable the in Blender. 


Note 


The SteamVR runtime can also be used for HTC Vive 
Cosmos, Oculus, and Windows Mixed Reality HMDs. 


Varjo 


Varjo includes full OpenXR support with its required Varjo 
Base software. 


e Enable the VR Scene Inspection add-on in Blender. 
Windows Mixed Reality 


Windows Mixed Reality provides full support for OpenXR. To 
check if a PC meets the requirements to run the software, 
Microsoft offers the Windows Mixed Reality PC Check 
application. 


e Make sure the Windows 10 May 2019 Update (1903) is 
installed. 

e If the system meets all requirements, the Mixed Reality 
Portal should already be installed. It is also available in 
the Microsoft Store. 

e Launch the Mixed Reality Portal. Click the menu button 

. in the lower left corner. In the menu it opens, select 
the Set up OpenXR. 

e Enable the VR Scene Inspection add-on in Blender. 


Note 


To switch to Windows Mixed Reality from another OpenXR 
runtime (e.g. SteamVR), download the OpenXR Developer 
Tools from the Microsoft Store and set Windows Mixed 
Reality as the active runtime. 


Windows Mixed Reality OpenXR Runtime 


Installation status 


© The Windows Mixed Reality OpenXR Runtime is installed, but it is not the active OpenXR runtime. 
O Set as active runtime 
Demo Scene 


CO Launch OpenXR demo scene 


Feedback 


To give feedback on the OpenXR API or the Windows Mixed Reality OpenXR Runtime, please visit the following link on the 
Windows Mixed Reality Dev Center. 


Defaults 


When you start Blender for the first time, the interactive 
region of the Splash Screen is replaced with a couple of 
initial preferences to configure how you interact with 
Blender. 


Note 


These options can always be changed later in the 
Preferences. 


Language 
The language used in the user interface. The list is 
broken up into categories determining how complete the 
translations are. More language preferences can be set in 
the Translation Preferences. 


Shortcuts 


Presets for the default keymap for Blender. Note that this 
manual assumes that you use the “Blender” keymap. 


Blender: This is the default keymap. Read more 
about this keymap here. 

Blender 2.7x: This keymap is intended to match an 
older series of Blender versions and is 
designed for people upgrading who do 
not want to learn the updated keymap. 

Industry Compatible: 


Select With 


This keymap is intended to match 
common creation software and is 
intended for people who use many 
different such applications. Read more 
about this keymap here. 


Controls which mouse button, either right or left, is used 
to select items in Blender. 


Spacebar 


Controls the action of Spacebar. These and other shortcuts 
can be modified in the keymap preferences. 


Play: 


Tools: 


Search: 


Theme 


Starts playing through the Timeline. 
This option is good for animation or 
video editing. 

Opens the Toolbar underneath the 
cursor to quickly change the active 
tool. This option is good if doing a lot of 
modeling or rigging. 

Opens up the Menu Search. This option 
is good for someone who is new to 
Blender and is unfamiliar with its 
menus and shortcuts. 


Choose between a light or dark theme for Blender. 
Themes can be customized more in the Preferences. 


Load Previous Version Settings 


Copies preferences and startup files from the previous 
version of Blender and then loads them. 


The settings need to be imported from previous versions 
because the configuration files of each Blender version 


are stored in separate folders. Refer to the Blender’s 
Directory Layout page for the location of these folders. 


There are two areas where Blender’s defaults are stored: 


Preferences 
The Preferences file stores keymap, add-ons theme and 
other options. 


Startup File 
The Startup File stores the scene and UI setup which are 
displayed at startup and when creating a new file (File > 
New). 


Saving Defaults 


The user preferences are automatically saved when 
changed. 


Changing the default startup file can be done via File > 
Defaults >» Save Startup File. See Startup File. 


Loading Factory Settings 


You can revert your customizations to Blender’s defaults: 


Preferences 
The Preferences Load Factory Settings. 


Startup File & Preferences 
File » Defaults » Load Factory Settings. 


Note 


After loading the factory settings, the preferences won't be 
auto-saved. 


See Managing Preferences for details. 


Help System 


Blender has a range of built-in and web-based help options. 


Tooltips 


#-\e8 Object Mode v View Select Add 


Current editor type for this area 


Manipulate objects in a 3D environment 


Tooltip of the Renderer selector in the Info Editor. 


When hovering the mouse cursor over a button or setting, 
after a few instants a tooltip appears. 


Elements 


The context-sensitive Tooltip might contain some of these 
elements: 


Short Description 
Related details depending on the control. 


Shortcut 
A keyboard or mouse shortcut associated to the tool. 


Value 
The value of the property. 


Library 
Source file of the active object. See also Linked Libraries. 


Disabled (red) 
The reason why the value is not editable. 


Python 
When Python Tooltips are enabled, a Python expression is 
displayed for scripting (usually an operator or property). 


Context-Sensitive Manual 
Access 


Reference 

Mode: All modes 

Menu: Context menu > Online Manual 
Shortcut: Fl 


You may want to access help for a tool or area from within 
Blender. 


To do so; hover the cursor over the tool or button you need 
help with and use the keyboard shortcut or context menu 
item to visit pages of this reference manual from within 
Blender. This opens a web page relating to the button under 
the cursor, supporting both tool and value buttons. 


Note 


We do not currently have 100% coverage. You may see an 
alert in the info header if a tool does not have a link to the 
manual. 


Other times, buttons may link to more general sections of 
the documentation. 


Help Menu 


Web Links 


The first options of this menu provide direct links to Blender- 
related websites. The same links can also be found in the 
Splash Screen. 


Manual 
This is a link to the Official Blender Manual (which you 
are now reading). 


Tutorials 
Multiple tutorials to help you learn to use Blender. 


support 
Links to various sites, providing both community and 
professional support. 


User Communities 
Lists of many different community sites and support 
venues. 


Developer Community 
Blender’s developer forum. 


Python API Reference 
Python application programming interface (API) 


Report a Bug 
The Blender Bug Tracker (registration needed). 


Save System Info 


This extracts system information which can be useful for 
including in bug reports, inspecting the configuration, or 
diagnosing problems. 


You will be prompted to save a text file called system- 
info.txt. 


It contains the following sections: 


Blender 
This section shows you the Blender version, details about 
the build configuration, and the path in which Blender is 
running. 


Python 
The version and path of your Python installation. 


Directories 
Paths used for scripts, data files, presets and temporary 
files. 


Those directories are configured using the Preferences 
Editor. 


OpenGL 
Shows the OpenGL version, the name of the 
manufacturer, and the capabilities of your hardware and 
driver. 


Enabled Add-Ons 
Lists add-ons currently in use. 


User Interface 


Window System 


Introduction 
Splash Screen 
Topbar 
Workspaces 
Status Bar 
Areas 
Regions 

Tabs & Panels 


Keymap 


¢ Common Shortcuts 


e Default Keymap 
e Industry Compatible Keymap 


Interface Controls 


Buttons and Controls 


e Menus 
¢ Eyedropper 
¢ Decorators 


Extended Controls 


Data-Block Menu 
List View 

Color Picker 

Color Ramp Widget 
Color Palette 

Curve Widget 
Search 

Nodes 


Tools & Operators 


Tool System 
Operators 
Undo & Redo 
Annotations 
Selecting 


Window System 
Introduction 


After starting Blender and closing the Splash Screen, the 
Blender window should look similar to the image below. 


The default startup Blender window. 


Blender’s interface is separated into three main parts: 


e The Topbar at the very top, consists of the main menu, 
which is used for saving, importing and exporting files, 
configuring settings, and rendering among other 
functions. 

e Areas in the middle, which is the main workspace 

e The Status Bar at the bottom, which displays shortcut 
suggestions and relevant statistics. 


Blender’s default Screen Layout. Topbar (blue), 
Areas (green) and Status Bar (red). 


Customization 


Keyboard shortcuts 


Blender makes heavy use of keyboard shortcuts to speed up 
work. These can be customized in the Keymap Editor. 


Theme colors 


Blender allows for most of its interface colors to be changed 
to suit the needs of the user. If you find that the colors you 
see on screen do not match those in the Manual, it could be 
that your default theme has been altered. Creating a new 
theme or selecting/altering a pre-existing one can be done 
by opening the Preferences and clicking on the Themes tab. 


Accessibility 


Blender has several options for visibility customization, 
including resolution scale, and the ability to load custom 
fonts. These settings can be configured in the Interface 
Preferences. 


Splash Screen 


When starting Blender, the splash screen appears in the 
center of the window. It contains options to create new 
projects or open recent ones. A more detailed description 
can be found below. 


tting Start 


General @) Manual 
a 


2D Animation sia} Blender Website 
Sculpting sia} Credits 

VFX 

Video Editing 


Open. saa} Release Notes 


<4) Recover Last Session Development Fund 


Blender Splash Screen. 


To close the splash screen and start a new project, click 
anywhere outside the splash screen (but inside the Blender 
window) or press Esc. The splash screen will disappear 


revealing the default screen. To reopen the splash screen, 
click on the Blender icon in the Topbar and select Splash 
Screen. 


Information Region 
The upper part of the splash screen contains the splash 
image with the Blender version in the top right. 


Interactive Region 
The interactive region is the bottom half of the splash 
screen. 


New File 
Start a new project based on a template. 


Recent Files 
Your most recently opened blend-files. This gives 
quick and easy access to your recent projects. 


Open 
Allows opening an existing blend-file. 


Recover Last Session 
Blender will try to recover the last session based on 
temporary files. See Recovering Data. 


Links 
Links to the official web site. The same links can be 
found in the Help Menu of the Topbar. 


Note 


When starting Blender for the first time, the Interactive 
Region contains a Quick Set Up Process. 


Topbar 


Menus 
ZX) File Edit Render Window Help 


Blender Menu 


Splash Screen 
Open the Splash Screen. 


About Blender 
Opens a menu displaying the following information about 
Blender: 


Version: The Blender version. 

Date: Date when Blender was compiled. 

Hash: The Git Hash of the build. This can be useful to 
give to support personnel when diagnosing a 
problem. 

Branch: Optional branch name. 

Windowing Environment: On Linux, this will show 
either Wayland or X11 depending on the windowing 
environment that Blender is running on. 

Release Notes: Open the latest release notes. 
Credits: Open credits website. 

License: Open License website. 

Blender Website: Open main Blender website. 
Blender Store: Open the Blender store. 
Development Fund: Open the developer fund 
website. 


Install Application Template 
Install a new application template. 


File Menu 


The options to manage files are: 


New Ctrl-N 
Clears the current scene and loads the selected 
application template. 


Open Ctrl-0 
Open a blend-file. 


Open Recent Shift-Ctrl-0 
Displays a list of the most recently opened blend-files. 
Select any of the file names in the list to open that blend- 
file. 


Revert 
Reopens the current file to its last saved version. 


Recover 
Recover Last Session 
This will load a blend-file that Blender automatically 
Saves just before exiting. So this option enables you to 
recover your last work session, e.g. if you closed 
Blender by accident. 


Recover Auto Save 
This will open an automatically saved file to recover it. 


Save Ctrl-s 
Save the current blend-file. 


Save AS... Shift-Ctrt-S 


Opens the File Browser to specify file name and location 
of save. 


Save Copy... 
Saves a copy of the current file. 


Link... 
Links data from an external blend-file (library) to the 
current one. The editing of that data is only possible in 
the external library. Link and Append are used to load in 
only selected parts from another file. See Linked 
Libraries. 


Append... 
Appends data from an external blend-file to the current 
one. The new data is copied from the external file, and 
completely unlinked from it. 


Data Previews 
Tools for managing data-block previews. 


Import 
Blender can use information stored in a variety of other 
format files which are created by other graphics 
programs. See Import/Export. 


Export 
Normally you save your work in a blend-file, but you can 
export some or all of your work to a format that can be 
processed by other graphics programs. See 
Import/Export. 


External Data 
External data, like texture images and other resources, 
can be stored inside the blend-file (packed) or as 
separate files (unpacked). Blender keeps track of all 


unpacked resources via a relative or absolute path. See 
pack or unpack external data. 


Automatically Pack Into .blend 
This option activates the file packing. If enabled, every 
time the blend-file is saved, all external files will be 
saved (packed) in it. 


Pack All Into .blend 
Pack all used external files into the blend-file. 


Unpack Into Files 


Unpack all files packed into this blend-file to external 
ones. 


Make All Paths Relative 
Make all paths to external files Relative Paths to 
current blend-file. 


Make All Paths Absolute 
Make all paths to external files absolute (= full path 
from the system’s root). 


Report Missing Files 
This option is useful to check if there are links to 
unpacked files that no longer exist. After selecting this 
option, a warning message will appear in the Info 
editor’s header. If no warning is shown, there are no 
missing external files. 


Find Missing Files 
In case you have broken links in a blend-file, this can 
help you to fix the problem. A File Browser will show 
up. Select the desired directory (or a file within that 
directory), and a search will be performed in it, 
recursively in all contained directories. Every missing 


file found in the search will be recovered. Those 
recoveries will be done as absolute paths, so if you 
want to have relative paths you will need to select 
Make All Paths Relative. 


Note 


Recovered files might need to be reloaded. You can 
do that one by one, or you can save the blend-file 
and reload it again, so that all external files are 
reloaded at once. 


Clean Up 
Unused Data-Blocks 
Remove unused data-blocks from both the current 
blend-file and any Linked Data (cannot be undone). 
See the Outliner for more information. 


Recursive Unused Data-Blocks 
Remove all unused data-blocks from both the current 


blend-file and any Linked Data including any indirectly 
used data-blocks i.e. those only used by unused data- 


blocks. 


Unused Linked Data-Blocks 
Remove unused data-blocks from only Linked Data. 


Recursive Unused Linked Data-Blocks 


Remove all unused data-blocks from only Linked Data 


including any indirectly used data-blocks i.e. those 
only used by unused data-blocks. 


Unused Local Data-Blocks 
Remove all unused data-blocks from only the current 
blend-file. 


Recursive Unused Local Data-Blocks 
Remove all unused data-blocks from only the current 
blend-file including any indirectly used data-blocks i.e. 
those only used by unused data-blocks. 


Defaults 
This menu manages the startup file which is used to 
store the default scene, workspace, and interface 
displayed when creating a new file. 


Initially this contains the startup scene included with 
Blender. This can be replaced by your own customized 
setup. 


Save Startup File 
Saves the current blend-file as the startup file. 


Load Factory Settings 
Restores the default startup file and preferences. 


When an Application Templates is in use the following 
operators are shown: 


Load Factory Blender Settings 
Loads the default settings to the original Blender 
settings without the changes made from the current 
application template. 


Load Factory (Application Template Name) Settings 


Loads the default settings to the original application 
template. 


See also 
Managing Preferences. 


Quit ctr1-Q 


Closes Blender. The current scene is saved to a file called 
“quit.blend” in Blender’s temporary directory (which can 
be found on the “File Paths” tab of the Preferences). 


Edit Menu 


Undo/Redo/History 
See Undo & Redo. 


Menu Search 
Find a menu based on its name. 


Operator Search 
Execute an operator based on its name (Developer 
Extras only). 


Rename Active Item 
Rename the active object or node; see Rename tool for 
more information. 


Batch Rename 
Renames multiple data types at once; see Batch Rename 
tool for more information. 


Lock Object Modes 
Prevents selecting objects that are in a different mode 
than the current one. 


Note 


This option can prevent accidental mode changes, such 
as when you're trying to select a bone in Pose Mode to 
animate it, but instead click a piece of background 
scenery (which would normally select that piece and 
switch to Object Mode). 


You may want to disable Lock Object Modes for example 
when weighting rigged objects or sculpting/painting 
where you intentionally want to switch between objects 
in different modes. 


Preferences 
Open the Preferences window. 


Render Menu 


Render Image F12 
Render the active scene at the current frame. 


Render Animation Ctrt-F12 
Render the animation of the active scene. 


See also 
e Rendering_Animations for details. 


Render Audio 
Mix the scene’s audio to a sound file. 


See also 
e Rendering_audio for details. 


View Render F11 


Show the Render window. (Press again to switch back to 
the main Blender window.) 


View Animation Ctrl-F11 
Playback rendered animation in a separate player. 


See also 


e Animation player for details. 
e Preferences for selecting a different animation 
player than the default one. 


Lock Interface 
Lock interface during rendering in favor of giving more 
memory to the renderer. 


Window Menu 


New Window 
Create a new window by copying the current window. 


New Main Window 
Create a new window with its own workspace and scene 
selection. 


Toggle Window Fullscreen 
Toggle the current window fullscreen. 


Next Workspace 
Switch to the next workspace. 


Previous Workspace 
Switch to the previous workspace. 


Show Status Bar 
Choose whether the Status Bar at the bottom of the 
window should be displayed. 


Save Screenshot 
Capture a picture of the current Blender window. A File 
Browser will open to choose where the screenshot is 
saved. 


Save Screenshot (Editor) 


Capture a picture of the selected Editor. Select the Editor 
by clicking LmB within its area after running the operator. 
A File Browser will open to choose where the screenshot 
is saved. 


Help Menu 


See Help System. 


Workspaces 


Layout Modeling Sculptin 


This set of tabs is used to switch between Workspaces, 
which are essentially predefined window layouts. 


Scenes & Layers 


Sv Scene x v ilaly View Layer Bal %< 


These data-block menus are used to select the current 
Scene and View Layer. 


Workspaces 


Workspaces are essentially predefined window layouts. Each 
Workspace consists of a set of Areas containing Editors, and 
is geared towards a specific task such as modeling, 
animating, or scripting. You’ll typically switch between 
multiple Workspaces while working on a project. 


Workspaces are located at the Topbar. 


Controls 


Tabs 
Click on the tabs to switch between the workspaces. You 
can also use the keyboard shortcuts Ctr1l-PageUp and Ctrl- 
PageDown. Double-click a tab to rename the workspace. 


Add + 
Click on the Add button to add a new workspace. 


Context menu RMB 
The context menu contains options to duplicate, delete 
and reorder workspaces. 


Default Workspaces 


Blender’s default startup shows the “Layout” workspace in 
the main area. This workspace is a general workspace to 
preview your scene and contains the following Editors: 


e 3D Viewport on top left. 

e Outliner on top right. 

e Properties on bottom right. 
e Timeline on bottom left. 


Blender’s ‘Layout’ Workspace with four editors. 


3D Viewport (yellow), Outliner (green), Properties 
(blue) and Timeline (red). 


Blender also has several other workspaces added by 
default: 


Modeling: For modification of geometry by modeling 
tools. 

Sculpting: For modification of meshes by sculpting 
tools. 

UV Editing: For mapping of image texture coordinates 


to 3D surfaces. 
Texture Paint: 


For coloring image textures in the 3D 
Viewport. 

Shading: For specifying material properties for 
rendering. 

Animation: For making properties of objects 
dependent on time. 

Rendering: For viewing and analyzing rendering 
results. 

Compositing: For combining and post-processing of 
images and rendering information. 

Geometry Nodes: 
For procedural modeling using Geometry 
Nodes. 

Scripting: For interacting with Blender’s Python API 
and writing scripts. 


Additional Workspaces 


Blender has a couple additional Workspaces to choose from 
when adding a new Workspace: 


2D Animation 


2D Animation: General workspace to work with Grease 
Pencil. 

2D Full Canvas: 
Similar to “2D Animation” but contains a 
larger canvas. 


VFX 


Masking: For creating 2D masks for compositing or 
video editing. 
Motion Tracking: 


For calculating camera motion and 
stabilizing video footage. 


Video Editing 


Video Editing: For sequencing together media into one 
video. 


Save and Override 


The workspaces are saved in the blend-file. When you open 
a file, enabling Load UI in the File Browser indicates that 
Blender should use the file’s screen layout rather than the 
current one. 


A custom set of workspaces can be saved as a part of the 
Defaults. 


Workspace Settings 


Reference 

Editor: Properties 

Menu: Active Tool and Workspace Settings » 
Workspace 

Mode 


Switch to this Mode when activating the workspace. 


Filter Add-ons 


Determines which Add-ons are enabled in the active 
workspace. When unchecked, the global add-ons will be 


used. When checked, you can enable individual add-ons in 
the list below. 


Status Bar 


The Status Bar is located at the bottom of the Blender 
window and displays contextual information such as 
keyboard shortcuts, messages, and statistical information. 
The Status Bar can be hidden by disabling Show Status Bar 
in Window menu or by dragging from the top edge down. 


Status Bar. 


Keymap Information 


The left side of the Status Bar displays mouse button 
shortcuts and the keymap of the active tool. In editors with 
a Toolbar, tapping Alt (Or Option on macOS) shows the 
hotkeys to change to a desired tool. 


Tip 


This functionality can be disabled with the Alt Click Tool 
Prompt preference in the Keymap Preferences). 


Status Messages 


The middle of the Status Bar displays information about in- 
progress operations. 


a: Sequence Render 


Running Task 
Shows the progress of the currently running task (Such as 
rendering or baking). Hovering the mouse pointer over 
the progress bar will display a time estimate. The task 
can be aborted by clicking the cancel button (x icon). 


Report Message 
Informational messages or warnings, such as after saving 
a file. They disappear after a short time. Click them to 
Show the full message in the Info Editor. 


Resource Information 


The right side of the Status Bar displays information about 
the Blender instance. Which information is shown can be 
chosen by clicking RMB. 


Scene Statistics 
Collection 
Name of the active Collection. 


Active Object 
Name of the active selected object. 


Geometry 
Displays information about the current scene 
depending on the mode and object type. This can be 
the number of vertices, faces, triangles, or bones. 


Objects 
Number of the selected objects and the total count. 


System Memory 
Estimate of Blender’s RAM consumption. In a single- 
instance single-machine scenario, this estimate provides 
a measurement against the hardware limit of the 
machine. 


Blender Version 
The version of Blender that is currently running. 


Areas 


The Blender window is divided 
into a number of rectangles 
called Areas. Areas reserve 
screen space for Editors, such as 
the 3D Viewport or the Outliner. 
Each editor offers a specific 
piece of functionality. = ee 


Areas are grouped into 
Workspaces, which are geared 


towards particular tasks Area boundaries are 
(modeling, animating and so on). indicated by rounded 

corners (yellow 
Note highlights). 


While some keyboard shortcuts 
in Blender are global (such as ctrt-s for saving), many 
depend on which editor the mouse cursor is hovering over. 


As an example, say you just selected two objects in the 
Outliner and want to join them. If you pressed the shortcut 
for this (ctrl-3) while the cursor is still in the Outliner, 
nothing would happen as the shortcut isn’t valid there; you 
first need to move your cursor to the 3D Viewport. 


Resizing 


You can resize areas by dragging their borders with Lms. 
Move your mouse cursor over the border between two 
areas, so that the cursor changes to a double-headed arrow, 


and then click and drag. 


Splitting 


Splitting an area will create a 
new area. Placing the mouse 
Cursor in an area corner will 
change the cursor to a cross (+) 
to indicate that pressing down 
LMB will activate splitting or 
joining. Dragging from an area 
corner inward will sp/it the area. 
You define the split direction by dragging either horizontally 
or vertically. 


Joining 


Dragging from an area corner 
outward will join two areas. The 
area that will be closed shows a 
dark overlay. You can select 
which area will be closed by 
moving the mouse over it. 
Release the LB to complete the 
join. If you press Esc or RMB before 
releasing the mouse, the 
operation will be canceled. 


Properties is being 
joined to the Outliner. 


Tip 


The cursor will also turn into a cross when hovering over 
either end of the border between two areas. When splitting 


or joining, it’s best not to start dragging from this border, 
but from a corner inside one of the areas. 


Area Options 


RMB On the border opens the Area Options. 


Vertical/Horizontal Split 
Shows an indicator line that lets you select the area and 
position where to split. Tab switches between 
vertical/horizontal. 


Join Areas 
Shows the join direction overlay. 


Swap Areas 
Swaps this area with the adjacent one. 


Swapping Contents 


You can swap the contents of two areas by pressing Ctrl-LMB 
on one of the corners of the initial area, dragging towards 
the target area, and releasing the mouse there. The two 
areas do not need to be side-by-side, though they must be 
inside the same window. 


Duplicate Area into new 
Window 


Reference 


Menu: View > Area > Duplicate Area into new 
Window 


A new floating window containing an area can be created 
from View > Area > Duplicate Area into new Window. (Not 
available in some editors.) 


The new window is a fully functional window, which is part 
of the same instance of Blender. This can be useful, e.g. if 
you have multiple monitors. 


You can also create a new window from an existing area by 
pressing Shift-LMB ON an area corner, then dragging outward 
Slightly. 


Toggle Maximize Area 


Reference 
Menu: View > Area > Toggle Maximize Area 
Shortcut: Ctrl-Spacebar 


Expands the Area so it fills the whole window (while keeping 
the Topbar and Status Bar visible). To return to normal size, 
use the keyboard shortcut again or click the Back to 
Previous button in the Topbar. 


Toggle Fullscreen Area 


Reference 


Menu: View > Area > Toggle Fullscreen Area 
Shortcut: Ctrl-Alt-Spacebar 


Expands the Area so it fills the whole window, hiding the 
Topbar, Status Bar, and even the secondary regions 
(toolbars etc.) of the Area’s own editor. To return to normal 
size, use the keyboard shortcut again or click the icon in the 
Area’s top right corner (only becomes visible when 
hovering). 


Regions 


Every Editor in Blender is divided into Regions. Regions can 
have smaller structuring elements like tabs and panels with 
buttons, controls and widgets placed within them. 


The regions of the 3D Viewport showing the Sidebar 
and the Adjust Last Operation panel after adding a 
Cube. 


Header (green), Main region (yellow), Toolbar (blue), 
Sidebar (red) and Adjust Last Operation panel (pink). 


Main Region 


At least one region is always visible. It is called the Main 
region and is the most prominent part of the editor. 


Each editor has a specific purpose, so the main region and 
the availability of additional regions are different between 
editors. See specific documentation about each editor in the 
Editors chapter. 


Header 


A header is a small horizontal strip, which sits either at the 
top or bottom of an area. All editors have a header acting as 
a container for menus and commonly used tools. Menus and 
buttons will change with the editor type and the selected 
object and mode. 


Options » 
e-Ay @- 2 S890 - 


The Header of the 3D Viewport. 


Context Menu 


RMB On a header reveals a context menu with a couple 
options: 


Show Header 
Toggles the visibility of the header. If a header is hidden, 
it can be made visible again by clicking or dragging the 
Small arrow that appears at the top/bottom right of the 
editor. 


Show Tool Settings 
Toggles the visibility of the Tool Settings. 


Show Menus 
Toggles whether the Menus are collapsed or not. 


Flip to Bottom/Top 


Toggles whether the header or Tool Settings appear on 
the top or bottom of the editor. 


Vertical/Horizontal Split 
Shows an indicator line that lets you select the area and 
position where to split. Tab switches between 
vertical/horizontal. 


Maximize/Full Screen Area 
See Toggle Maximize Area. 


Duplicate Area into New Window 
See Duplicate Area into new Window. 


Close Area 
Closes the area and replaces it with the expansion of a 
neighboring area. 


Toolbar 


The Toolbar (on the left side of the editor area) contains a 
set of interactive tools. T toggles the visibility of the Toolbar. 


Tool Settings 


A horizontal strip at the top or bottom of the editor (similar 
to the header) containing settings for the currently selected 
tool. Just like the header, it can be hidden and moved 
through its context menu. 


Adjust Last Operation 


Adjust Last Operation is a region that allows tweaking an 
operator after running it. For example, if you just added a 
cube, you can use this region to tweak its size. 


Sidebar 


The Sidebar (on the right side of the editor area) contains 
Panels with settings of objects within the editor and the 
editor itself. N toggles the visibility of the Sidebar. 


Footer 


Some editors show a bar (on top/bottom of the editor area) 
that displays information about for example the active tool 
or operator. 


Arranging 


Scrolling 


A region can be scrolled vertically and/or horizontally by 
dragging it with the mms. If the region has no zoom level, it 
can also be scrolled by using the wheel while the mouse 
hovers over it. 


Some regions, in particular animation timelines, have 
scrollbars with added control points to adjust the vertical or 
horizontal range of the region. These special scrollbars will 
have added widgets at the ends, as shown in the following 
image: 


Scrollbars with zoom widgets. 


This can be used to stretch or compress the range to show 
more or less detail within the available screen space. Simply 
drag one of the dots to either increase or decrease the 
displayed range. You can also quickly adjust both the 
horizontal and vertical range by dragging in the editor with 
Ctrl-MMB. 


Changing the Size and Hiding 


Resizing regions works by dragging their border, the same 
way as Areas. 


To hide a region, resize it down to nothing. A hidden region 
leaves a little arrow sign. LMB On this icon to make the region 
reappear. 


Hiding and showing the Sidebar. 
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Scaling 


The scale of certain regions (such as the Toolbar) can be 
changed by dragging inside them with Ctrl-MMB, or using 
NumpadPlus and NumpadMinus while hovering the mouse cursor 
over them. Press Home to reset the scale to the default. 


Tabs & Panels 


Tabs 
Tabs are used to control 


overlapping sections in the = A cone 

user interface. The content , eee = 
of only one Tab is visible at 

a time. Tabs are listed ina 
Tab header, which can be * THOR 
horizontal or vertical. 


Resolution X 1920 px 
Y 1080 px 


Aspect X 1.000 
Y 1.000 


Render Region 


Top: Horizontal Tab header in 
the Topbar. Bottom: Vertical 
Tab header shows tab icons 

in the Properties. 


Switching/Cycling 


Vertical tabs can be switched with ctri-wheel from anywhere 
in the tab. You can also cycle through tabs with ctri-Tab and 
Shift-Ctrl-Tab, Or press down LMB and move the mouse over 
the tab header icons. (This does not apply to Workspace 
tabs; see Workspace controls.) 


Panels 


The smallest organizational unit in the 
user interface is a panel. The panel 
header shows the title of the panel. It 
is always visible. Some panels also 
include subpanels. 
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Panels in 
Properties. 


A panel is 
highlighted in 
yellow anda 
Subpanel in red. 


Collapsing and Expanding 


A panel can either be expanded to show its contents, or 
collapsed to hide its contents. An expanded panel is 
indicated by a down-arrow (¥) in the panel header, while a 
collapsed panel is shown with a right-arrow (>). 


e Clicking LmB on the panel header expands or collapses it. 

e Pressing A expands/collapses the panel under the mouse 
pointer. 

e Clicking ctri-LMB on the header of a collapsed panel will 
expand it and collapse all others. 


e Clicking ctri-LMB on the header of an expanded panel 
will expand/collapse all its subpanels. 

e Dragging with LmB over the headers will expand or 
collapse many at once. 


Position 


You can change the position of a panel within its region by 
clicking and dragging the grip widget (::::) on the right side 
of its header. 


Pinning 


Sometimes it is desirable to view panels from different tabs 
at the same time. Like, for instance, having access to a 
camera's properties, while other objects are selected. This 
has been solved by making panels pinnable. 


A pinned panel remains visible regardless of which tab has 
been selected. You can pin a panel by clicking on the pin 
icon in its header. Panels that do not have a pin icon can be 
pinned by RMB on the panel header and selecting Pin, or by 
pressing Shift-LMB. 


Note 


Pinning is not available for all panels. For example, it’s 
available in the Sidebar but not in the Properties editor. 


Presets 


Selector Presets Ai |= 


A list of available presets. A Example Presets menu. 
selection will override the 
included properties. 


Add + 
New presets can be added based on the currently applied 
set of properties, which will be saved for later reuse. A 
pop-up opens where you can set a name, after which you 
can select it from the list and in some cases additional 
settings. 


Remove - 
Deletes the selected preset. 


Common Shortcuts 


Conventions Used in This 
Manual 


Keyboards 


Hotkey letters are shown in this manual like they appear on 
a keyboard; for example: 


G 
refers to the lowercase g. 


Shift, Ctrl, Alt 
are specified as modifier keys. 


Ctrl-wW, Shift-Alt-A, ... 
indicates that these keys should be pressed 
simultaneously. 


Numpad0 to Numpad9, NumpadPlus 
refer to the keys on the separate numeric keypad. 


Other keys are referred to by their names, such as Esc, Tab, 
Fl to F12. Of Special note are the arrow keys, Left, Right and 
SO On. 


Mouse 


This manual refers to mouse buttons as: 


LMB 


Left Mouse Button 


RMB 
Right Mouse Button 


MMB 
Middle Mouse Button 


Wheel, WheelUp & WheelDown 
Scrolling the wheel. 


Note 


Blender has two main selection modes: left-click select and 
right-click select. See the Select with Mouse Button 
preference. 


While left-click select is the default as it’s the most 


common in other applications, right-click select does have 
its advantages. See: Learn the benefits of right-click select. 


Hovering 


While hovering (when the cursor is held over a button). 


Properties 
e Ctri-c - Copy the (single) value of the button. 
e Ctri-v - Paste the (single) value of the button. 
e Ctrl-Alt-c - Copy the entire vector or color of the field. 


e Ctrl-Alt-v - Paste the entire vector or color of the field. 


RMB - Open the context menu. 


Backspace - Clear the value (sets to zero or clears a text 
field). 


Minus - Negate number values (multiply by -1.0). 
Ctrl-Wheel - Change the value incremental steps. 

For pop-up option menus buttons, this cycles the value. 
Return - Activates menus or toggles the value. 


Alt - Hold while editing values to apply the change to all 
selected items (objects, bones, sequence-strips). 


This can be used for number fields and toggles. 


Animation 


I - Insert a keyframe. 

Alt-I - Clear the keyframe. 

Shift-Alt-I - Clear all keyframes (removing all F-Curves). 
Ctrl-D - Assign a driver. 

Ctrl-Alt-D - Clear the driver. 

K - Add a Keying Set. 

Alt-K - Clear the Keying Set. 


Python Scripting 


Ctrl-c over any Operator Buttons copies their Python 
command into the clipboard. 


This can be used in the Python Console or in the Text 
editor when writing scripts. 


e Shift-Ctrl-C over property buttons copies their data path 
for this property (also available from the context menu). 


Useful when writing drivers or scripts. 


e Shift-Ctrl-Alt-C over property buttons copies their full 
data path for the data-block and property. 


Note that in most cases it is best to access values based 
on the context, instead of by name. 


Dragging 


e Ctri - While dragging, snap to discrete steps. 

e Shift - Gives precision control over the value. 

e Shift-Ctrl - Precise snap will move the object with high 
precision along with the snapping constraint. 


Text Editing 


e Home - Go to the start of the line. 

e End - Go to the end of the line. 

e Left, Right - Move the cursor a single character. 

e Ctrl-Left, Ctrl-Right - Move the cursor an entire word. 

e Backspace, Delete - Delete characters. 

e Ctrl-Backspace, Ctrl-Delete - Delete words. 

e Shift - Select while holding the key and moving the 
cursor. 

e Ctrl-A - Select all text. 

e Ctri-c - Copy the selected text. 

e Ctrl-x - Cut the selected text. 

e Ctri-v - Paste text at the cursor position. 


Confirm & Cancel 


e Esc, RMB - Cancel. 
e Return, LMB - Confirm. 


Default Keymap 


While this isn’t a comprehensive list, this page shows 
common keys used in Blender’s default keymap. 


Global Keys 


Ctrl-0 Open file. 

Ctrl-S Save file. 

Ctrl-N New file. 

Ctrl-Z Undo. 

Shift-Ctrl-Z Redo. 

Ctrl-Q Quit. 

F1 Help (context sensitive). 
F2 Rename active item. 


F3 Menu Search. 


F4 


F5 - F8 


F9 


F10 


F12 


Ctrl-Spacebar 


Ctrl-Alt-Spacebar 


Ctrl-PageUp / Ctrl- 
PageDown 


Spacebar 


File context menu. 


Reserved for user actions. 


Adjust last operation. 


Reserved for user actions. 


Show render window. 


Render the current frame. 


Quick access (favorites). 


Toggle Maximize Area. 


Toggle Fullscreen Area. 


Next/previous Workspace. 


User configurable. 


Play: Toggle animation 
playback. 
Tools: Tool switching with 


hotkeys (Shift- 
Spacebar for play). 


Search: Search for actions 
(Shift-Spacebar for 
play). 


Shift-Ctrl-Spacebar Playback animation (reverse). 


Common Editing Keys 


Deletes the selected item, requires a confirmation 
dialog. 


Deletes the selected item, does not require a 


Delete . : ; 
confirmation dialog. 


Common Editor Keys 


These keys are shared across editors such as the 3D 
Viewport, UV and Graph editor. 


A Select all. 
Alt-A Select none. 
Ctrl-I Invert selection. 


H Hide selection. 


Alt-H Reveal hidden items. 


T Toggle Toolbar. 


N Toggle Sidebar. 


3D Viewport Keys 


Tab 


Ctrl-Tab 


AccentGrave 


Ctrl-AccentGrave 


Toggle Edit mode. 


Toggle Pose mode for armatures, or show 
a mode switching pie menu for others. 


In Edit Mode, switch between editing 
vertices (1), edges (2), or faces (3). 


Hold shift to toggle one of these without 
disabling the others. 


Hold ctrt to alter how the selection is 
transformed from the old mode to the 
new. 


See Mesh Selection Modes for details. 


Show 3D Viewport navigation pie menu. 


Toggle gizmos. 


Shift-AccentGrave Start Walk/Fly Navigation. 


Platform Specific Keys 


macOS 


The cmd key can be used instead of ctrl on macOS for all but 
a few exceptions which conflict with the operating system. 


List of additional macOS specific keys: 


Cmd-Comma Preferences. 


Keymap Preferences 


Select with Mouse Button 
Controls which mouse button, either left or right, is used 
to select items in Blender. If Left is selected, the RMB will 
be a context sensitive menu. If Right is selected, the LMB 
will place the 3D Cursor. 


Spacebar Action 
Controls the action of Spacebar. These and other shortcuts 
can be modified in the keymap preferences. 


Play: Starts playing through the Timeline. 
This option is good for animation or 
video editing work. 

Tools: 


Opens the Toolbar underneath the 
cursor to quickly change the active 
tool. This option is good if you are 
doing a lot of modeling or rigging work. 

Search: Opens up the Menu Search. This option 
is good for someone who is new to 
Blender and is unfamiliar with the 
menus and shortcuts. 


Activate Gizmo Event 
The activation event for gizmos that support drag 
motion. This option is only available when Left click 
Select with Mouse Button is chosen. 


Press: The gizmo’s operation gets initiated 
(and additional options become 
available in the Status Bar) the 
moment you press down the mouse 
button on the gizmo. 

Drag: The operation only gets initiated once 
you start dragging the gizmo. 


Right Mouse Select Action 
The default action for the right mouse button. This option 
is only available when Right click Select with Mouse 
Button is chosen. 


Select & Tweak: 
Right mouse always tweaks the 
selected item. 

Selection Tool: Right mouse uses the selection tool. 


Tool Keys 
The method of keys to activate tools such as move, 
rotate, and scale. 


Immediate: Activate actions immediately. 


Active Tool: Activate the tool for editors that 
support tools. 


Alt Click Tool Prompt 


Tapping Alt shows a prompt in the status bar prompting a 
second keystroke to activate the tool. Note that this 
option is not available when using Emulate 3 Button 
Mouse. 


Alt Tool Access 


Hold Alt to use the Active Tool when the gizmo would 
normally be required. (For example, with the Move tool 
selected, you can hold Alt and drag the mouse anywhere 
in the viewport to move the selected object, rather than 
having to drag its gizmo.) This option is only available 
when Select with Mouse Button is set to Left click and 
Emulate 3 Button Mouse is disabled. 


Alt Cursor Access 


Hold Alt-LmMB to place the Cursor (instead of LMB), allows 
tools to activate on press instead of drag. This option is 
only available when Right click Select with Mouse Button 
is chosen. Note this option is not available when using 
Emulate 3 Button Mouse. 


Select All Toggles 


Causes selection shortcut A to deselect all when any 
selection exists. 


3D Viewport 


Grave Accent / Tilde Action 


Navigate: Navigation pie menu, useful on 
systems without a numeric keypad. 
Gizmos: 


Transform gizmos pie menu, useful for 
quickly switching between transform 
gizmos. Note that this doesn’t apply to 
tools that force a certain gizmo (Move, 
Rotate, Scale and Transform); if you 
have such a tool selected, the gizmo 
will stay the same no matter what you 
choose in the pie menu. 


Middle Mouse Action 
The action when mms dragging in the viewport, this also 
applies to trackpads. 


Orbit: Rotates the view around a pivot point, 
Shift-MMB is used for panning the view. 
Pan: Shifts the view towards the mouse, 


Shift-MMB is used for orbiting the view. 


Alt Middle Mouse Drag Action 
Relative: Set the view axis where each mouse 
direction maps to an axis relative to the 
current orientation. 
Absolute: Set the view axis where each mouse 
direction always maps to the same 
axis. 


Tab for Pie Menu 
Causes Tab to open a pie menu (Swaps Tab and Ctrl-Tab). 


Pie Menu on Drag 
This allows keys to have a secondary drag action. 


Tab 
tap: Toggles Edit Mode. 
drag: Object Mode pie menu. 


tap: Toggles wireframe view. 


drag: Display mode pie menu. 
AccentGrave 

tap: First person Fly/walk Navigation. 

drag: View axis pie menu. 


Extra Shading Pie Menu Items 
Show additional items in the shading menu (Zz key). 


File Browser 


Open Folders on Single Click 


Navigate into folders by clicking on them once instead of 
twice. 


Industry Compatible 
Keymap 


While this is not a comprehensive list, this page shows 
common keys used in the industry compatible keymap. 


General 

1-9 Mode/Element switching 
RMB Context menu 

Tab Menu Search. 


Shift-Tab Quick access (favorites) 


Return Rename 


Ctrl-Return Render 


Ctrl-[ Toggle Toolbar 


Ctrl-] Toggle Sidebar 


Common Editing Keys 


Deletes the selected item, requires a 


Backspace : ‘ ‘ 
confirmation dialog. 


Deletes the selected item, does not require a 


Delete : ; ; 
confirmation dialog. 


Ctrl-D Duplicate 


P Set Parent 
B Proportional Editing / Soft Selection 
Viewport 


Alt-LMB Orbit View 


Alt-MMB Pan View 


Alt-RMB Zoom View 


Front/Side/Top/Camera 


Fl - F4 ; 
Viewpoints 


F Frame Selected 


A Frame All 
Selection 

LMB Select 
Ctrl-A Select All 


Shift-Ctrl-A Deselect All 


Ctrl-I Select Inverse 
Up Select More 
Down Select Less 


Double LMB Select Loop 


Double Alt- 


oie Select Ring 


] Select Linked 


Tools 


w, E, R Transform Tools 


Q Box Select 
D Annotate 
C Cursor Tool 


Edit Mode Tools 


Ctrl-E Extrude 
Ctri-B Bevel 
I Inset 
K Knife 


Alt-c Loop Cut 


Animation 


Spacebar Play/Pause 


Set Location + Rotation + Scale 
keyframe 


Shift-S Insert Keyframe menu 
Shift-W Set Location Key 
Shift-E Set Rotation Key 


Shift-R Set Scale Key 


Platform Specific Keys 


macOS 


The cmd key can be used instead of ctrl on macOS for all but 
a few exceptions which conflict with the operating system. 


Buttons 


Operator Buttons 


Operator buttons execute an Operator 
which in summary execute an action 

when clicked with LB. Operator buttons Operator button. 
may be an icon, text, or text with an 

icon. 


Checkboxes & Toggle Buttons 


These controls are used to activate or % Load UI a 
deactivate options. Use Lms to change their Trusted Source ‘ts 
state. A tick is shown on checkboxes when 

the option is activated. Active status on Checkboxes 
toggle buttons is indicated either by color and Toggle 
on the icon background, or a change in buttons. 


icon graphics. 
Dragging 


To change many values at once on or off, you can press 
down LMB and drag over multiple buttons. This works for 
checkboxes, toggles and to select a radio button value. 


Radio Buttons 


Radio buttons are used to choose one S@09 
option from a selection of options. The 


active button is indicated by a colored Radio buttons. 
background. 


Cycling 


Use Ctrl-Wheet while hovering the mouse over radio buttons 
to cycle between the options. 


Direction Buttons 


Clicking with Lvs in the sphere and 
dragging the mouse cursor lets the 
user change the direction by 


rotating the sphere. 


Direction buttons. 


Shortcuts 


e LMB (drag) rotates the direction. 
e Ctrl (while dragging) snaps to vertical & diagonal 
directions. 


Fields 
Text & Search Fields 


O 
» 


A text and a search field. 


Text fields show a rounded rectangular border, and 
optionally an icon and/or text inside the border. Text fields 
store text strings, and provide the means to edit text by 
standard text editing_shortcuts. 


For text fields with an icon and pop-ups, see Data ID. 


Number Fields 


Number fields store values and Resolution X 1920 px 


un its Y 1080 px 
% 25% 


The first type of number field Aspect X | 1.000 
shows triangles pointing left (<) : sana 

and right (>) on the sides of the 

field when mouse pointer is over Number fields. 
the field. Sliders, a second type of 

number field, have a colored bar in 

the background to display values over a range, e.g. 
percentage values. 


The value can be edited in several ways: 


Incremental Steps 
To change the value in unit steps, click LMB on the small 
triangles (only available on first field type). You can also 
use Ctrl-Wheelt while hovering over the field to edit the 
value. 


Dragging 
To change the value with the mouse, hold down LmMB and 
drag to left or right. 


Hold ctri to snap to the discrete steps while dragging or 
Shift for precision input. 


Keyboard Input 
Press LMB Or Return to enter value by typing it with 
keyboard. 


When entering values by keyboard, number fields work 
like text fields: 


e Press Return Or LMB Outside the field to apply the 

change. 

Press Esc Or RMB to cancel. 

Press Tab to jump to the next field or Shift-Tab to go 

to the previous field. 

e Press Minus while hovering over a number field to 
negate the value. 


Multi-Value Editing 


You can edit multiple number fields at Location: 
once by pressing down Ls on the first 
field, and then dragging vertically over 
the fields you want to edit. Finally you 
can either drag left or right to adjust 


Multi-value editing. 


value with the mouse, or release the 
LMB and type in a value. 


Value Limits 


Most numerical values are restricted by “soft limit” and 
“hard limit” value ranges. Changing values by dragging with 
the mouse is restricted to the “soft limit” value range. Input 
via keyboard will allow the use of wider value ranges, but 
never wider than the “hard limit”. 


Expressions 


You can enter mathematical expressions into any number 
field. For example, enter 3*2 or 10/5+4 instead of 6. Even 
constants like pi (3.142) or functions like sqrt(2) (Square 
root of 2) may be used. 


See also 


These expressions are evaluated by Python; for all 
available math expressions see: Math module reference. 


Expressions as Drivers 


You may want your expression to be re-evaluated after it is 
entered. Blender supports this using Drivers (a feature of 
the animation system). 


Expressions beginning with # have a special use. Instead of 
evaluating the value and discarding the expression, a driver 
is added to the property with the expression entered. 


The expression #frame iS a quick way to map a value to the 
current frame, but more complex expressions like 
#fmod(frame, 24) / 24 are alSo Supported. 


This is simply a convenient shortcut to add drivers which 
can also be added via the RMB menu. 


Units 


As well as expressions, you can specify numbers and units. 
If no unit is given, then a default unit is applied. The unit 
system can be changed in scene Settings. 


You can use either the unit abbreviation or the full name 
after the value. 


Examples of valid usage of length units include: 
e icm e 2ft 
e 1m 3mm e 3ft/0.5km 
e im, 3mm e 2.2mm+ 5' / 3" - 2yards 

Note 

Using Units 


e Decimal separator is optional. 

e You can mix units, e.g. metric and imperial even 
though you can only show one at a time. 

e Plurals of the names are recognized too, SO meter and 
meters Can both be used. 


Color Fields 


The color field stores a color value. Clicking on it with LmB 
opens the Color Picker. amennenl 
Color fields with an alpha channel are 


divided in half: on the left, the color is shown 


without an alpha channel, and on the right, alti 

it’s Shown with an alpha channel over a nies 

checker pattern. without 
alpha. 


Colors can be copied to other color fields by 
dragging and dropping. 


Menus 


Blender uses a variety of different menus for accessing 
options and Operators. Menus can be interacted with in the 
following ways: 


Mouse selection 
LMB on the desired item. 


Numerical selection 
You can use the number keys or numpad to input an item 
in the list to select. For example, Numpad1 will select the 
first item and so on. 


If a menu is too large to fit on the screen, a small scrolling 
triangle appears on the top or bottom. Scrolling is done by 
moving the mouse above or below this triangle. 


Shortcuts 


e Use wheel while hovering with the mouse. 

e Arrow keys can be used to navigate. 

e Each menu item has an underlined character which can 
be pressed to activate it. 

e Number keys or numpad can also be used to activate 

menu items. (1 for the first menu item, 2 for the second 

etc. For larger menus, Alt-1 activates the 11th and so 

on, up to Ait-0 for the 20th.) 

Press Return to activate the selected menu item. 

Press Esc to close the menu without activating any menu 

item. This can also be done by moving the mouse cursor 

far away from the menu, or by LmB clicking anywhere 

outside of it. 


Header Menus 


Most View Image 
headers New 
exhibit a fm Open 
set of 
menus, 
located at 
the start of 
the 

header. 
Header 
menus are used to configure the editor and access 
operators. All menu entries show the relevant shortcut keys, 
if any. 


Open Cached Render 


Image menu in the Header of the Image editor. 


Collapsing Menus 


Sometimes it’s helpful to gain some extra horizontal space 
in the header by collapsing menus. This can be accessed 
from the header context menu: click RMB on the header and 
select Collapse Menus. 


2%. «JL Object Mode = 


Header 
User Perspective 
Toggle Header (1) Cube 


Flip to Bottom 


(] Collapse Menus 


. . Access the menu 
Right-click on any of from the collapsed 
the header menus. icon. 


Select Menus 


A Select menu (or “selector” for short) lets 
you choose between a set of options. It 'm@, Object Mode v 
appears as an icon and/or text with a down M) Object Mode 
arrow on the right side. To use it, click the Ed Ett Mode 


g? Sculpt Mode 


button with LMB to show the available 
options, then click the desired option (once 
selected, it’ll appear inside the button). 
You can alSoO use Ctrl-Wheel to cycle 
through the options without opening the 
menu. The 3D 
Viewport Mode 
Select menu. 


°s2 Vertex Paint 
eight Paint 


= Texture Paint 


Popover Menus 


Popover menus Object (Global Y 4 
are similar to 
Select Menus, 


but can show ulate 
. «¢ Local 
more varied aE 
content such R@ Gimbal 
as a title, tL, View 


buttons, @ Cursor 
Sliders, etc. 


The Transform Orientations popover menu. 


Context Menu 


Context menus are pop-ups that can be opened with Rws. In 
most editors, it’s also possible to use the Menu key. The 
contents of the menu depend on the location of the mouse 
pointer. 


When invoked in an editor, the menu contains a list of 
operators sensitive to the editor’s mode. When invoked over 
buttons and properties, common options include: 


Single 
Apply the change to a single value of a set (e.g. only the 
X coordinate of an object’s Location). 


All 
Apply the change to all values in a set (e.g. all 
coordinates of an object’s Location). 


Reset to Default Value(s) Backspace 
Replaces the current value by the default. 


Copy Data Path Shift-Ctrl-c 


Copies the Python property data path, relative to the 
data-block. Useful for Python scripting. 


Copy Full Data Path Shift-ctr1l-Alt-Cc 


Copies the full Python property data path including any 
needed context information. 


Copy As New Driver 
Creates a new driver using this property as input, and 
copies it to the clipboard. Use Paste Driver to add the 
driver to a different property, or Paste Driver Variables to 
extend an existing driver with a new input variable. 


Copy To Selected 
Copies the property value to the selected object’s 
corresponding property. A use case is if the Properties 
context is pinned. 


Assign Shortcut 


Lets you define a keyboard or mouse shortcut for an 
operation. To define the shortcut you must first move the 
mouse cursor over the button that pops up. When “Press 
a key” appears you must press and/or click the desired 
Shortcut. Press Esc to cancel. 


See also 
Common Shortcuts. 


Change Shortcut 
Lets you redefine the shortcut. 


Remove Shortcut 
Unlinks the existing shortcut. 


Online Manual F1 


Opens an online page of the Blender Manual in a web 
browser. 


Online Python Reference 
Context-sensitive access to the Python API Reference. 


Edit Source 
For Ul development - Creates a text data-block with the 
source code associated with the control, in case the 
control is based on a Python script. In the Text Editor it 
points at the code line where the element is defined. 


Edit Translation 
For Ul development - Points at the translation code line. 


Specials Menu 


The Specials pop-up menu is similar to a context menu, but 
iS Opened using a button consisting of a down arrow ona 


dark background i» | 


Pie Menus 


A pie menu is a menu whose items are spread radially 
around the mouse. 


"ao Vertex Paint 


{=F Weight Paint 2 Texture Paint 


‘m@. Object Mode 4 * Edit Mode 


g Sculpt Mode 


The 3D Viewport Mode Pie menu. 
Tip 


The fastest way to operate a Pie menu is to press down the 
key(s) that invoke the menu, move the mouse slightly 
towards a selection, and release the key(s) to activate the 
selection. 


Releasing the key without moving the mouse will keep the 
menu open so you can click the desired item. If you do 
move the mouse before releasing, the item closest to the 
mouse will be activated instantly. 


An open disc widget at the center of the pie menu shows 
the current direction of the pie menu. The selected item is 
also highlighted. A pie menu will only have a valid direction 
for item selection if the mouse is touching or extending 
beyond the disc widget at the center of the menu. 


Pie menu items support key accelerators, which are the 
letters underlined on each menu item. Number keys can 
also be used. 


If there are sub-pies available, it is indicated by a plus icon. 


See also 


Pie menu settings. 


Eyedropper 


The eyedropper (pipette icon) allows you to sample from 
anywhere in the Blender window. The eyedropper can be 
used to select different kinds of data: 


Color 
This is the most common usage. The eyedropper is used 
to sample a pixel’s color from anywhere within Blender. 


Note 

The View Transform of the color management affects 
the color. In order to get consistent results, it should be 
set to Standard. If it’s set to any other option, the 
eyedropper may return an inaccurate color. 


Color Ramp 
Dragging the cursor over the window to sample a line 
which is converted into a color ramp. 


Objects/Object-Data 
This is used with object buttons (Such as parent, 
constraints or modifiers) to select an object from the 3D 
Viewport or Outliner, rather than having to select it from 
a dropdown. 


Camera Depth 
Number fields effecting distance can also use the 
eyedropper. 


This is used to set the camera’s depth of field so the 
depth chosen is in focus. 


e E will activate the eyedropper while hovering over a 
button. 

e LMB dragging will mix the colors you drag over, which 
can help when sampling noisy imagery. 

e Spacebar resets and starts mixing the colors again. 


Decorators 


Decorators are small buttons that appear to the right of 
other buttons and show the state of the property. 
Decorators may appear next to number fields, menus, and 
checkboxes to indicate the property can be animated. 


Decorators indicating different property states. 


Clicking on the decorator dot icon will add a Keyframe to 
that property. Clicking the rhombus icon again will remove 
the keyframe. A solid rhombus icon indicates there is a 
keyframe on the current frame, while a non-solid rhombus 
icon indicates that the property has a keyframe on another 
frame. Clicking the non-solid rhombus icon will create a 
keyframe on the current frame with the current property 
value. 


If a property is being driven by another, the decorator shows 
the driver icon. 


Decorators make it quick and easy to glance over properties 
and see their state. 


See also 


State Colors 


Data-Block Menu 


Lets you select a Data-Block (Such as a material) in order to 
link it to something else (Such as an object). 


Type Aly Untitled 
Shows an icon Fariiar Rascal 
indicating the ~ Untitled 
data-block type. 0 Viewer Node 
Clicking the 
image or the 
down arrow 
opens the popup 
menu. Dragging 
the image lets 
you apply the 
data-block to 
something else 
(for example, you can drag a material onto an object in 
the 3D Viewport, or onto a Data ID field). 


A data-block menu with a search field. 


List 
A list of data-blocks available in the current blend-file, 
or a link to select an item from. The menu may show a 
preview besides the items and a search field to search 
the items in the list by name. 


Name 
Displays, and allows editing of, the name of the selected 
data-block. If a name is already in use by a different 
data-block, Blender will append a number like “.001”. 


User Count 


Displays the number of users of the data (if there’s more 
than one user). Clicking it will create a single-user copy. 


As an example, if three separate objects referenced the 
Same material, the material’s user count would be 3. 
Changing the material would affect all three objects. If 
you now selected an object and clicked the user count, 
the object would receive its very own copy of the 
material, which can be modified independently of the 
Original that’s still used by the other two. 


Fake User (shield icon) 
If a data-block has no real users, it’ll normally be cleaned 
up (deleted) when saving the blend-file. To prevent this, 
you can give it a fake user; that way, it’s guaranteed to 
“survive.” Data-blocks with a fake user have an “F” prefix 
in the dropdown list. 


The Outliner can show an overview of all data-blocks 
without real users in the blend-file. Simply change its 
Display Mode to Orphan Data. 


New/Add (files icon) 
Creates a new data-block (or duplicates the current one) 
and selects it. 


Open File (folder icon) 
Opens the File Browser, for importing an image for 
example. 


Unpack File (bin icon) 
Unpack the file packed into the current blend-file to an 
external one. 


Unlink Data-block x 


Clears the link. Shift-LMB to set the users to zero allowing 
the data to be fully deleted from the blend-file. 


Sometimes there is a list of applied data-blocks (Such as a 
list of materials used on the object). 


See also 


Data-blocks are discussed further in the Data System 
chapter. 


Preview 


Some data-block menus 
have large preview 
images in their 
dropdown instead of just 
icons and names. 


Texture 0 Texture.001 


fe, 


A Data-Block menu with preview. 


Data ID 


A Data ID field is similar to a Data Block Menu, but is only 
for selecting (and not for other features like creating new 
data or managing users). 


It can show the following | Cube 
elements: 


Camera 


Cube 

Type Light 
The icon on the left 

specifies the accepted 


data-block type. 


Name 
The text field functions as 
a search field by matching A Data ID field. 
elements in the list. Press 
Tab to auto-complete 
names up to the level where a match is found. If more 
than one match exists, you have to continue typing. If 
you type an invalid name, the value will remain 
unchanged. 


List 
Lets you select the data-block directly. 


Eyedropper 
In some Data IDs there is an Eyedropper available 
through the pipette icon on the right side. 


Remove x 
Click the x button on the right to clear the reference. 


Sub IDs 


Related types of IDS may become available to select a 
property or child object, depending on the object type. 


Target Js Cube 


Vertex Group: 9&6 VGroup 


Target: J Armature 


Bone: ~. Bone 


Head/Tail: 


Sub ID Example. 


Vertex Group 
If the selected object in the Target field is a mesh ora 
lattice, an additional field is displayed where a vertex 
group can be selected. 


Bone 
If the selected object in the Target field is an armature, 
an additional field is displayed where a bone can be 
selected. 


Head/Tail 
Once a bone is selected, a numeric field becomes 
available for specifying a point on the bone. A value of 
O corresponds to the bone’s head, while a value of 1 
corresponds to its tail. Any values between these will 
result in linear interpolation (So a value of 0.5 matches 
the bone’s center). 


Use B-Bone Shape 
If the bone is a bendy bone, clicking on this button 
will make the point follow the curvature of the B- 
spline between head and tail, rather than simply 
going in a straight line. 


List View 


This control is useful for anen 
managing lists of items. In #83 Group.001 
addition to the main list, there 
is a Filtering panel on the 
bottom (hidden by default) and 
modification buttons on the 
right. 


List view with expanded 
Filtering Options panel. 


Select 
To select an item, click LMB 
on it. 


Rename 
By double-clicking on an item, you can edit its name via 
a text field. This can also be achieved by clicking it with 
Ctrl-LMB. 


Resize 
The list view can be resized to show more or fewer items. 
Hover the mouse over the handle (::::), then click and 
drag to expand or shrink the list. 


Filter 
Click the Show filtering options button (triangle on 
bottom left) to show or hide the filter option panel. 


Search Ctrl-F 
Filters the list to only show items containing a certain 
term. 


Invert <-> 


Toggle between including items that match the search 
term and those that do not contain the search term. 


Sort by Name 
This button switches between alphabetical and non- 
alphabetical ordering. 


Reverse 
Sort objects in ascending or descending order. This 
also applies to alphabetical sorting, if selected. 


On the right of the list view are list modification buttons: 


Add + 
Adds a new item. 


Remove - 
Removes the selected item. 


Specials v 
A Specials menu with operators to edit list entries. 


Move (up/down arrow icon) 
Moves the selected item up/down one position. 


Color Picker 


The color picker is a pop-up that 
lets you define a color value. 
Holding ctri while dragging snaps 
the hue to make it quick to select 
primary colors. 


Color Field 
Lets you pick the first and 
second color component. The 
Shape can be changed; see 
Types. 


Color Slider 
The slider with a gradient in the 
background lets you define the 
third color component. It can 
also be controlled with the Circle HSV. 
Wheel. 


Color Model 
Selects the Color Model for the number fields below. 


RGB, HSV/HSL, Hex 


Note 

In Blender, the RGB and HSV/HSL values are in Scene 
Linear color space, and are therefore not Gamma 
corrected. On the contrary, Hex are automatically 
Gamma corrected for the SRGB Color Space. For more 
information, see Color Management. 


Color Values 
Blender uses values from 0 to 1 to express colors for RGB 
and HSV colors. 


Hexadecimal (Hex) values are expressed as RRGGBB. 
Shorthand hex colors are also supported as RGB, e.g. dark 
yellow FFccee can be written as FCO. 


For operations that are capable of using the Alpha 
Channel, another slider “A” is added. 


Eyedropper (pipette icon) 
Samples a color from inside the Blender window using 
the Eyedropper. 


Shortcuts 


Ctrl-LMB (drag) snaps to hue. 
Shift-LMB (drag) precision motion. 
Wheel adjust the brightness. 
Backspace reset the value. 


Types 


The default color picker type can be selected in the 
Preferences, see: Interface. 


Color Picker types. 


Circle HSV. Circle HSL. 


Square Square Square 
(SV + H). (HS + V). (HV + S). 


Color Ramp Widget 


Color Ramps specify a color gradient based on color stops. 
Each stop has a position and a color. The gradient is then 
calculated as the interpolation between these stops using 
the chosen interpolation method. 


Color ramp. 


Controls 


Add + 
Adds a new stop between the selected stop and the one 
before it. 


Delete - 
Deletes the selected color stop. 


Specials v 
Contains more operators for the color ramp. 


Flip Color Ramp 
Flips the gradient, mirroring the positions of the stops. 


Distribute Stops from Left 


Distribute the stops so that every step has the same 
space to the right. This is mostly useful when used 
with Constant interpolation mode. 


Distribute Stops Evenly 
Distribute the stops so that all neighbors have the 
Same space between them. 


Eyedropper (pipette icon) 
An Eyedropper to sample a color or gradient from the 
interface to be used in the color ramp. 


Reset Color Ramp 
Resets the color ramp to its default state. 


Color Mode 
Selection of the Color Model used for interpolation. 
RGB: Blends color by mixing each color 
channel and combining. 
HSV/HSL: Blends colors by first converting to HSV 


or HSL, mixing, then combining again. 
This has the advantage of maintaining 
saturation between different hues, 
where RGB would de-saturate. This 
allows for a richer gradient. 


Color Interpolation 
The interpolation method to use across the ramp. 


RGB 
B-Spline: Uses a B-spline interpolation for the 
color stops. 
Cardinal: Uses a cardinal interpolation for the 
color stops. 


Linear: 


Uses a linear interpolation for the 


color stops. 

Ease: Uses an ease interpolation for the 
color stops. 

Constant: Uses a constant interpolation for the 
color stops. 

HSV/HSL 

Clockwise: Clockwise interpolation around the 

HSV/HSL wheel. 


Counter-Clockwise: 
Counterclockwise around the 


HSV/HSL wheel. 
Near: Nearest route around the wheel. 
Far: Furthest route around the wheel. 


v Counter... v 


HSV and HSL interpolation options. 


Active Color Stop 
Index of the active color stop (Shown as a dashed line). 
Offers an alternative way of selecting a stop in case it’s 
so close to others that it’s hard to select it directly. 


Position 
This slider controls the position of the selected color stop 
in the range. 


Color 
A color field where you can specify the color and alpha of 
the selected stop. 


Shortcuts 


e LMB (drag) moves color stops. 
e Ctrl-LMB (click) adds a new color stop. 


Color Palette 


Color Palettes are a way of storing a U%~ Palette 2 @ co x 
brush’s color so that it can be used at [Races 
a later time. This is useful when y | | | | 


working with several colors at once. 


Palette 
A Data-Block Menu to select a 
palette. 


New + 
Adds the current brush’s primary 
Color to the palette. 


Delete - 
Removes the currently selected Color Palette. 
color from the palette. 


Move (up/down arrow icon) 
Moves the selected color up/down one position. 


Sort 
Sort Colors by Hue, Saturation, Value, Luminance. 


Color List 
Each color that belongs to the palette is presented ina 
list. Clicking on a color will change the brush’s primary 
Color to that color. 


Shortcuts 


e Ctrl-LMB open the color picker to change color. See Color 
Picker. 
e Backspace reset the value. 


Curve Widget 


The Curve Widget allows 
to intuitively map a range 
of input values to a set of 
output values by 
adjusting a curve, where 
the X axis represents the 
input and the Y axis the 
output. 


xX 0.39117 ¥ 0.50000 


Curve widget. 


Control Points 


Like all curves in Blender, the curve of the Curve Widget is 
controlled using control points. 


By default, there are two control points: one at (0.0, 0.0) 
and one at (1.0, 1.0), meaning the input is mapped directly 
to the output (unchanged). 


Move 
Simply click and drag it around. 


Add 
Click anywhere on the curve where there is not already a 
control point. 


Remove 
Select it and click the x button at the top right. 


Controls 


Above the curve graph is a row of controls. These are: 


Zoom In (plus magnifying glass icon) 
Zoom into the center of the graph to show more details 
and provide more accurate control. To navigate around 
the curve while zoomed in, click and drag in an empty 
part of the graph. 


Zoom Out (minus magnifying glass icon) 
Zoom out of the graph to show fewer details and view 
the graph as a whole. You cannot zoom out further than 
the clipping region (see Clipping below). 


Specials v 
A Specials menu with operators to edit control points or 
to set properties. 


Reset View 
Resets the view of the curve. 


Handle Options 
Controls how the control points affect the curve 
Shape. It determines the interpolation of the curve 
segment at the selected control point. 


Vector Handle 
Vector handles create straight lines and sharp 
corners. 


Auto Handle 
Automatic handles that create smooth curves. 


Auto Clamped Handle 


Automatic handles that create smooth curves while 
also preventing overshoot. 


Free Handle 
The handles can be moved completely 
independently, and thus can result in a sharp 
change of direction. 


Aligned Free Handles 
The two handles of the curve point are locked 
together to always point in exactly opposite 
directions. This results in a curve that is always 
smooth at the control point. 


Vector Auto ores ‘ 
Handles. Handles. aMIDe 
Handles. 


Extend Options 


Controls how the curve is extended before the first 
control point and after the last control point. 


Extend Horizontal 
Causes the curve to stay horizontal before the first 
point and after the last point. 


Extend Extrapolated 
Causes the curve to extrapolate before the first 
point and after the last point, based on the shape 
of the curve. 


Extend Extend 
Horizontal. Extrapolated. 


Reset Curve 
Resets the curve to default (removes all points added 
to the curve). 


Clipping Options (dot icon) 
Use Clipping 
Forces curve points to stay between specified values. 


Min X/Y and Max X/Y 
Set the minimum and maximum bounds of the curve 
points. 


Delete x 
Remove the selected control point. The first and last 
points cannot be deleted. 


X, Y 
The coordinates of the selected control point. 


Copy/Paste Ctrl-C, Ctrl-Vv 
The whole curve can be copied from one Curve Widget to 
another by hovering over the curve graph and pressing 
Ctrl-C, Ctrl-V. 


Search 


Menu Search 


Reference 

Mode: All Modes 

Menu: Edit » Menu Search 
Shortcut: F3 


The Menu Search pop-up lets you search Blender’s interface 
for a certain operator and execute it. First narrow down the 
list by typing (part of) the operator’s name, then either click 
the operator with Ls, or navigate to it with Down and Up and 
activate it with Return. 


Apart from the operator names, the pop-up also shows the 
menus where they’re located. 


fe) 


Screen: Play Animation 

Wm Reload Start-Up File 
Anim Delete Keyframe 
Wm Import Alembic 
Transform To Sphere 

Wm Set Tool By Index 
Ui Edit Translation 
View3D Select Menu 
Sequencer Refresh Sequencer 


Wm Toggle System Console 
v 


The Menu Search pop-up. 


See also 


The Spacebar Action option in the Preferences. 


Operator Search 


Reference 
Mode: All Modes 
Menu: Edit » Operator Search 


When Developer Extras are activated, the Operator Search 
can be accessed from the Edit menu in the Topbar. This 
menu searches all Operators within Blender, even if they are 
not exposed in a menu. This is useful for Python developers 
for testing purposes. Blender might also include a few 
advanced operators that are not exposed in a menu and can 
only be accessed via this search menu. 


Nodes 


Introduction 

o Editor Interface 

o Navigating 

o Adding Nodes 
e Node Parts 

o Title 

o Sockets 

o Properties 
Selecting 
Arranging Nodes 

o Snapping 

o Auto-Offset 
e Editing 
Transform 
Connecting _Sockets 
Disconnecting Sockets 
Duplicate 
Duplicate Linked 
Copy/Paste 
Delete 
Mute 
Show/Hide 

o Layers 
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o View 
e Node Groups 
o Interface 
o Edit Group 
o Make Group 


o Ungroup 

o Group Insert 

o Reusing Node Groups 
e Frame Node 

o Properties 

o Editing 
e Reroute Node 

o Properties 


Introduction 


Blender contains different node-based editors with different 
purposes, so this section only explains how to work with 
nodes in general. The list below shows the different types of 
nodes and where they’re documented. 


Example of a node editor. 


Icon Name Documentation 


Documentation is in the Render 


Shader Nodes 
section. 


Icon Name Documentation 


Composite Documentation can be found in 
Nodes the Compositing section. 


Texture Nodes are covered in 


Texture Nodes in. uv editor docs. 


Editor Interface 


Header 


The Header contains various menus, buttons and options, 
partially based on the current node tree type. 


dv View Select Add Node Use Nodes Backdop RIMAIRGB 9M ote 


Common node editor header options. 


View 
This menu changes your view of the editor. 


Select 
This menu allows you to select a node or groups of 
nodes. 


Add 
This menu allows you to add nodes. 


Node 
This menu allows you to do things with selected nodes. 


Use Nodes 
Tells the render engine to use the node tree when 
computing the material color or rendering the final 
image, or not. If not, the tree is ignored. For materials, 
this is mostly a legacy option, because in the past 
materials could not be created with node trees. 


Use Pinned 
When enabled, the editor will retain the material or 
texture, even when the user selects a different object. A 
node tree can then be edited independent of the object 
selection in the 3D Viewport. 


Parent Node Tree 
Leaves the current node group and returns to the parent 
node group/tree. 


Snapping 
Change options for snapping node positions to achieve a 
cleaner node tree layout. 


Overlays 


Overlays are information that is displayed on top of the 
nodes and node trees. There is a toggle to show or hide all 
overlays for the node editor next to the overlay popover. 


Wire Colors 
Color node links based on their connected sockets. 


Context Path 
Display breadcrumbs in the upper left corner indicating 
the hierarchy location of the node tree/group that’s 
currently being displayed. 


Annotations 


Displays Annotations in the preview region. 
Toolbar 


The Toolbar contains a set of tools that can be used in the 
node editor. 


Sidebar 


The Sidebar region contains properties for the currently 
selected node as well as node editor-specific settings. 


Navigating 
Navigating the node editors is done with the use of both 


mouse movement and keyboard shortcuts. 


Pan MMB 
Move the view up, down, left and right. 


ZOOM Ctrl-MMB, Wheel 
Move the camera forwards and backwards. 


Frame Selected NumpadPeriod 
Adjusts the zooms to fit only the selected nodes in the 
view. 


Frame All Home 
Adjusts the zoom to fit all nodes in the view. 


Adding Nodes 


Reference 


Menu: Add 
Shortcut: Shift-A 


Nodes are added via the Add menu in the editor’s header or 
using a keyboard shortcut. 


Nodes can also be added by dragging a connection from an 
existing node’s input or output socket and dropping the 
connection above an empty space instead of connecting to 
another socket. This action will open a search menu with a 
list of compatible nodes and their sockets that can be added 
and connected to the existing node. Confirming the menu 
selection will add the node which can then be moved and 
placed. 


Node Parts 


All nodes in Blender are based on a similar construction. 
This applies to any type of node. These parts include the 
Title, Sockets, Preview and more. 
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Mix 
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Title 


The title shows the name/type of the node; it can be 
overridden by changing the node’s Label. On the left side of 
the title is the collapse toggle which can be used to collapse 
the node. This can also be done with H. 


How a node appears when collapsed. 


Sockets 


Sockets are input and output values 
for the node. They appear as little 
colored circles on either side of the 
node. Unused sockets can be hidden 
with Ctrl-H. 


Float 

Integer 

Boolean 
String 


Vector: 


Each socket is color-coded depending 
on what type of data it handles. 


Float (gray) 
Indicates that the socket 
accepts/produces floating-point 
numbers. It can either be a single 
value or a so-called “value map”. 
(You can think of a value map as a 
grayscale image where the 
brightness of a pixel represents its Image: 
value.) If a single value is used as 
an input for a “value map” socket, 
all points of the map are set to this same value. 


Color 
Shader 
Geometry 
Object: 


Collec... jo 
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Integer (lime green) 
Used to pass an integer value (a number without a 
fractional component). 


Boolean (pink) 
Used to pass a true or false value. 


String (light blue) 
Used to pass a text value. 


Vector (dark blue) 
Indicates vector, coordinate and normal information. 


Color (yellow) 
Indicates that the socket accepts/produces color 
information. The colors may or may not have an alpha 
component depending on the node tree type. 


Shader (bright green) 
Used for shaders in Cycles and Eevee. 


Geometry (turquoise) 
Used in Geometry Nodes. 


Object (orange) 
Used to pass an object data-block. 


Collection (white) 
Used to pass a collection data-block. 


Image (apricot) 
Used to pass an image data-block. 


Inputs 


The inputs are located on the bottom left side of the node, 
and provide the data the node needs to perform its function. 
Each input socket, except for the green shader input, when 
disconnected, has a default value which can be edited via a 
color, numeric, or vector interface input. In the screenshot 
of the node above, the second color option is set by a color 
interface input. 


Some nodes have special sockets that can accept multiple 
inputs. These sockets will have an ellipsis shape rather than 
a circle to indicate their special behavior. 


Outputs 


The outputs are located on the top right side of the node, 
and can be connected to the input of nodes further down 
the node tree. 


Conversion 


Some socket types can be converted to others either 
implicitly or explicitly. Implicit conversion happens 
automatically without the need of a conversion node. For 
example, Float sockets and Color sockets can be linked to 
each other. 


Once a socket conversion is made, data may be lost and 
cannot be retrieved later down the node tree. Implicit socket 
conversion can sometimes change the data units as well. 
When plugging a Va/ue input node into an angle socket, it’ll 
default to use radians regardless of the scene’s Units. This 
happens because the Value node has no unit while the angle 
input does. 


Valid conversions: 


e Between color and vector - mapping between color 
channels and vector components. 

e Between color and float - the color data is converted to 
its grayscale equivalent. 

e Color/float/vector to Shader - implicitly converts to color 
and gives the result of using an Emission node. 


Explicit conversion requires the use of a conversion node 
such as the Shader To RGB node or the RGB to BW Node 
node. The Math Node node also contains some functions to 
convert between degrees and radians. 


Properties 


Many nodes have settings which can affect the way they 
interact with inputs and outputs. Node settings are located 
below the outputs and above any inputs. 
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Key Color 


An example of the controls on the Chroma Key node. 


Preview 


Some nodes can show an image that previews their result. 
The preview can be toggled using the icon on the very top 
right-hand corner of the node, next to the title. 
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How a node appears without the preview. 


Selecting 


Box Select 
Drag with LmsB to box-select multiple nodes. Alternatively, 
B starts the bounding box selection process as well. 


Lasso Select 
Drag with ctrl-Alt-LMB to perform a lasso selection. Note 
that this is different from the ctri-RMB used in other 
editors. 


Select All A 
Select all nodes. 


Deselect All Alt-A 
Deselect all nodes. 


Invert Ctrl-I 
Invert the selection. 


Select Linked From L 
Expand the selection to nodes which are linked to the 
inputs of the currently selected nodes. 


Select Linked To Shift-L 
Expand the selection to nodes which are linked to the 
outputs of the currently selected nodes. 


Select Grouped Shift-G 
Selects nodes that have similar properties as the active 
node. 


Type 
The node type, e.g. all Math nodes. 


Color 


The node color. (Nodes can be given a custom color to 
visually organize them in the editor; this is not related 
to any color information they might consume or 

produce as part of their function. The color can be set 


in the Sidebar.) 
Prefix, Suffix 
Matches the name property from start/end of the text. 


Activate Same Type Previous/Next Shift-]/Shift-[ 
Finds the previous/next node of same type, activates it, 
and ensures it’s visible. 

Find Node Ctrl-F 
Shows a Search pop-up for finding a node by name. 


Select Multiple Shift-LMB 
Add/remove a node to/from the selection. 


Arranging Nodes 


Snapping 
The snapping options can be found on the rightmost side of 


the node editor’s header. 


Snap 
Toggle snapping on or off. 


Snap Node Element 
What to snap the selected nodes to: 


Grid: Snap to the grid in the background. 

Node X: Snap to the X coordinate of another 
node’s vertical border. 

Node Y: Snap to the Y coordinate of another 
node’s horizontal border. 

Node X/Y: Combination of the above. 


Snap Target 
Which part of the selected nodes to snap: 


Closest: Snap closest point onto target. 

Center: Snap center of selected nodes onto 
target. 

Median: Snap median of selected nodes onto 
target. 

Active: Snap active node onto target. 


Auto-Offset 


When you drop a node with at least one input and one 
output socket onto an existing connection between two 
nodes, Auto-offset will, depending on the direction setting, 
automatically move the left or right node away to make 
room for the new node. Auto-offset is a feature that helps 
organizing node layouts interactively without interrupting 
the user workflow. 
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Auto-offset is enabled by default, but it can be disabled from 
the editor’s View menu. 


You can toggle the offset direction while you are moving the 
node by pressing T. 


The offset margin can be changed using the Auto-offset 
Margin setting in the Editing section of the Preferences. 


See also 
Example Video: 


Auto-Offset. A workflow enhancement for Blender’s node 
editors. 


Editing 


Transform 

Reference 

Menu: Node > Move, Rotate, Resize 
Shortcut: G, R, S 


You can move the selected node(s) by simply clicking and 
dragging any empty part on them. Alternatively, you can 
press G, move the mouse, and click LMB to confirm. 


In general it is recommended to arrange your nodes within 
the view such that the data flows from left to right, top to 
bottom. 


The width of a node can be changed by dragging its left or 
right border. 


Rotating (R) and scaling (S) only apply when you have 
multiple nodes selected and only affect the nodes’ positions. 


Connecting Sockets 


Interactively 


LMB-click on a socket and drag. You will see a line coming out 
of it: this is called a /ink. Keep dragging and connect the link 
to an input socket of another node, then release the LB. 


While multiple links can route out of an output socket, only a 
single link can be attached to an input socket. 


To reposition the outgoing links of a node, rather than 
adding a new one, hold ctri while dragging from an output 
socket. This works for single as well as for multiple outgoing 
links. 


Nodes that have no connections can be inserted on a link. 
Just move the node over the link and release when the link 
is highlighted. 


Make Links F 
Select multiple nodes with open sockets, then use the 
Make Links to create links between them. Use Make Links 
again if there are other nodes which can be connected. 


Make and Replace Links Shift-F 


Make and Replace Links works similarly to Make Links, 
but it will replace existing links if any exist. 


Disconnecting Sockets 


Interactively 


Drag the link away from its input socket and let it go, 
keeping it unconnected. 


Mute Links 


Reference 


Menu: Node > Mute Links 
Shortcut: Ctrl-Alt-RMB 


Activate the menu item or hold the key combination, then 
draw a line across one or more links to mute/unmute them. 
A muted link acts as though it’s no longer there; this also 
means the input fields for specifying fixed values become 
visible again. 


When muting links on the input side of a reroute node, the 
links on its output side will be muted too. 


Cut Links 

Reference 

Menu: Node » Cut Links 
Shortcut: Ctrl-RMB 


Activate the menu item or hold the key combination, then 
draw a line across one or more links to delete them. 


Note 


The key combination is normally reserved for Lasso Select. 
In node editors, lasso selection is instead performed with 
Ctrl-Alt-LMB. 


Detach Links Alt-D, Alt-LMB drag 
Use Detach Links to cut all the links attached to the 
selected nodes and move the nodes to a new location. 


Duplicate 

Reference 

Menu: Node » Duplicate 
Shortcut: Shift-D 


Select one or more nodes, activate the menu item or press 
the key combination, then move the mouse to a new 
location and click LMB (or press Return) to place the 
duplicated node(s). 


Note 


When you duplicate a node, the new node will be 
positioned exactly on top of the node that was duplicated. 
If you leave it there (and it is quite easy to do so), you can 
not easily tell that there are two nodes there! When in 
doubt, select a node and move it slightly to see if 
something is hidden underneath. 


Duplicate Linked 


Reference 


Menu: Node » Duplicate Linked 
Shortcut: Alt-D 


Duplicate selected nodes, but not their node trees (in the 
case of group nodes), and move them. 


Copy/Paste 


Reference 
Menu: Node » Copy, Node » Paste 
Shortcut: Ctrl-C, Ctrl-V 


Not only the selected nodes but also the connections 
between them are copied to the clipboard. 


Note 


The pasted node will be placed in the same position as 
when it was copied. Use the same cautions as when 
duplicating. 


Delete 


Delete xX, Delete 
Deletes the selected node(s). 


Delete with Reconnect ctri-x 
Deletes the selected node(s), then creates new links 
connecting their former input nodes to their former 
output nodes. 


Mute 


Reference 


Menu: Node » Toggle Node Mute 
Shortcut: M 


Muting a node removes its contribution to the node tree, 
and makes all links pass through it without change. Links 


will appear red as an indicator of passing through the muted 
node. 


Tip 


Individual node links can be muted with Mute Links. 


Show/Hide 


Hide H 


Collapses the node so only the node header is visible. 


This can also be toggled by clicking the triangle on the 
left of the node header. 


Toggle Node Preview Shift-H 


Shows/Hides a preview region on the node that displays 
the frame after that node’s operation has been applied. 
This can also be toggled by clicking the material ball icon 
in the node header. 


Toggle Hidden Node Sockets Ctrl-H 


Collapses/Expands any input or output sockets that have 
no other nodes connected to them. 


Toggle Node Options 
Shows/Hides all node properties. 


Collapse and Hide Unused Sockets 
Applies both the Toggle Hidden Node Sockets and Hide 
operations. 


Layers 


Note 


These operators are only used in the Compositor., 


Read Render Layers Ctrl-R 
Reads all the current scene’s render layers from cache, 
as needed. This can be used to save RAM while rendering 
because the render layers do not have to be saved in 
RAM. And also for recovering some information from a 
failed render. For this to work, Cache Result must be 
enabled. 


Sidebar 
Node 


Reference 


Panel: Sidebar >» Node 


¥ Node 


Item 


Name: fs Render Layers 
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View Tool 
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Options 
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View Layer 


Node tab with a compositing Render Layers node 
selected. 


Node 


Name 
A unique node identifier inside this node tree. 


Label 
Nodes can be given a title by modifying the text field. 


Color 


By default, the node’s background color is defined by the 
user theme. This color can be overridden by selecting a 
custom color in this panel. Custom node colors can be used 
to provide a visual cue to help distinguish some nodes from 
others. The button to the right of the checkbox lets you save 
colors as presets for reusing later on (much like a palette). 


Color 
Color of the node background. 


Node Color Specials 
This menu contains Operators for working with nodes 
with custom colors. 


Copy Color 
Copies the color of the Active node and applies it to 
all selected nodes. 


Properties 


The properties that are shown depend on the type of node 
selected, e.g. a Mix node has different properties than a 
Mask node. 


Tool 


Reference 


Panel: Sidebar region » Tool 


Active Tool 


The info in this panel changes with the selected tool. 
View 


Reference 


Panel: Sidebar region > View 


Annotations 


You can select the Annotate tool in the Toolbar to make 
annotations in the node editor. See Annotate Too! for more 
info. 


Node Groups 


Grouping nodes can simplify a 
node tree by hiding away 
complexity and reusing 
repetitive parts. 


Conceptually, node groups 
allow you to treat a set of 
nodes as though it were just 
one node. They’re similar to 
functions in programming: 
they can be reused (even in 
different node trees) and can 
be customized by changing 
their “parameters.” 


As an example, say you 
created a “Wood” material 
that you would like to have in 
different colors. One way of 
doing this would be to 
duplicate the entire material 
for every color, but if you did 
that, you’d have to go over all 
those copies again if you later 
wanted to change the density 
of the grain lines. Instead, it 
would be better to move the 
nodes that define the wood 
look into a node group. Each 
material can then reuse this 
node group and just supply it 
with a color. If you then later 
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Example of a node group. 


want to change the grain line density, you only have to do it 
once inside the node group, rather than for every material. 


Node groups can be nested (that is, node groups can 
contain other node groups). 


Note 


Recursive node groups are prohibited for all the current 
node systems to prevent infinite recursion. A node group 
can never contain itself (or another group that contains it). 


Interface 


When a node group is created, new Group Input and Group 
Output nodes are generated to represent the data flow into 
and out of the group. Furthermore connections to input 
sockets coming from unselected nodes will become 
attached to new sockets on the Group Input node. Similarly, 
outgoing connections to input sockets of unselected nodes 
will become attached to the new Group Output node. 


If you want to pass an additional parameter into the group, 
a socket must be added to the Group Input node. To do this, 
drag a connection from the hollow socket on the right side 
of the Group Input node to the desired input socket on the 
node requiring an input. The process is similar for the Group 
Output regarding data you want to be made available 
outside the group. 


Sidebar 


Reference 


Panel: Sidebar > Group » Inputs, Sidebar > 
Group » Outputs 


The Sidebar lets 
you add, remove, 
reorder, and edit 
the sockets of the 
group’s input and 
output nodes. 


Name 
The name of the 
socket to display 
in the node’s 
interface. 


Tooltip 
The message 
displayed when 
hovering over 
socket 
properties. 
Currently only 
Supported for 
Geometry Node 
Editor. 


Default 
The value to use 
when nothing is 
connected to the 
socket. 


Min, Max 
The minimum 
and maximum 


Name Fac 


Default 0.500 


Min 0.000 
Max 0.000 


Hide Value 


¥ Outputs 


Shader 


Name Shader 


Hide Value 


The interface panel for editing groups. 


value for the UI 

button shown in the node interface. Note, this is not a 
minimum or maximum for the data that can pass through 
the node. If a socket passes a higher value than the 
maximum, it will still pass into the node unchanged. 


Hide Value 


Hide the socket value even when the socket is not 
connected. 


Edit Group 


Reference 

Menu: Node » Edit Group 
Header: Go to Parent Node Tree 
Shortcut: Tab, Ctrl-Tab 


With a node group selected, press Tab to move into it and 
see its content. Press Tab again (or Ctrl-Tab) to leave the 
group and go back to its parent, which could be the top- 
level node tree or another node group. You can refer to the 
breadcrumbs in the top left corner of the node editor to see 
where you are in the hierarchy. 
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Example of an expanded node group. 


Make Group 


Reference 
Menu: Node >» Make Group 
Shortcut: Ctrl-G 


To create a node group, select the nodes you want to 
include, then press ctri-G or click Group » Make Group. A 
node group will have a green title bar. All selected nodes will 
now be contained within the node group. Default naming for 
the node group is “NodeGroup”, “NodeGroup.001” etc. 
There is a name field in the node group you can click into to 
change the name of the group. Change the name of the 
node group to something meaningful. 


When appending node groups from one blend-file to 
another, Blender does not make a distinction between 
material node groups or composite node groups. So it is 


recommended to use some naming convention that will 
allow you to distinguish between the two types. 


Tip 


The “Add” menu of each node editor contains an “Output” 
category with node types such as “Material Output.” These 
node types should not be confused with the “Group 
Output” node found in node groups, and should not be 


used in node groups either (only in the top-level node 
tree). 


Ungroup 


Reference 
Menu: Node » Ungroup 
Shortcut: Ctrl-ALt-G 


Removes the group and places the individual nodes into 
your editor workspace. No internal connections are lost, and 


now you can link internal nodes to other nodes in your 
workspace. 


Separate P 
Separate selected nodes from the node group. 


Copy 
Copy to parent node tree, keep group intact. 


Move 
Move to parent node tree, remove from group. 


Group Insert 


Reference 


Menu: Node » Group Insert 


Selecting a set of nodes, ending with the destination group 
node, and pressing Node > Group Insert will move those 
nodes into that group. The moved nodes are collected into a 
group of their own to preserve their connection context, 
having their own group input and output nodes. The group’s 
existing input and output nodes are updated with new 
sockets, if any, from the new nodes. The node group must 
be edited to contain a single Group Input and a single Group 
Output node. 


Reusing Node Groups 


Reference 
Menu: Add >» Group 
Shortcut: Shift-A 


Existing node groups can be placed again after they’re 
initially defined, be it in the same node tree or a different 
one. It’s also possible to import node groups from a different 
blend-file using File > Link/Append. 


Frame Node 


The Frame node is useful for organizing nodes by collecting 
related nodes together in a common area. Frames are useful 
when a node setup becomes large and confusing yet the re- 
usability of a Node Group is not required. 
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Properties 


Label Size 
Font size of the label. For example, for subordinate 
frames to have smaller titles. 


Shrink 
Once a node is placed in the Frame, the Frame shrinks 
around it so as to remove wasted space. At this point it is 
no longer possible to select the edge of the Frame to 
resize it, instead resizing occurs automatically when 
nodes within the Frame are rearranged. This behavior 
can be changed by disabling this option. 


Text 


Y Node 
When you need to display 
more comprehensive text, Name: [[> Frame 
frame nodes can display the Label: [© 
contents of a text data-block. 


This is read-only, so you will 6S Dhesied 
need to use the Text Editor to Y Properties 
modify the contents. 


Label Size: 


Y Shrink 


Text: [J 


Editing 


Join in New Frame 


Reference 
Menu: Node >» Join in new Frame 
Shortcut: Ctrl-J 


Make a new frame including the selected nodes. 
Add to Frame 

Reference 

Shortcut: Ctrl-P 


Once a frame node is placed, nodes can be added by 
dropping them onto the frame or by selecting the node(s) 


then the frame and using Ctri-P. This can be thought of as 
Parenting the selection to the frame. 


Remove from Frame 


Reference 
Menu: Node >» Remove from Frame 
Shortcut: Alt-P 


To remove nodes from a frame, select and use Alt-P. This 
can be thought of as unparenting the selection from the 
frame. 


Reroute Node 


A node used primarily for organization. Reroute looks and 
behaves much like a socket on other nodes in that it 
Supports one input connection while allowing multiple 
output connections. 


To quickly add a Reroute node into an existing connection, 
hold Shift and RMB while sweeping across the link to add a 
Reroute node. 
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Properties 


Input 
Input value used for unconnected sockets. 


Tool System 


Tools are accessed from the Toolbar. 


This is a general introduction to tools. Individual tools have 
their own documentation. 


There can only be one active tool per Workspace and mode. 
This tool is remembered: if you’re in Edit Mode and have the 
Extrude tool selected, then switch to Object Mode (which 
has no Extrude tool) and back to Edit Mode, the Extrude tool 
will still be active. 


Most tools are controlled using just LB, though some also 
have modifier keys (Shown in the Status Bar while using the 
tool). This can all be customized in the Keymap Preferences. 


Some tools define gizmos (Shear and Spin for example) to 
help control them. 


Toolbar 

Reference 

Shortcut: T 

The Toolbar contains buttons for Do cap 
the various tools. Buttons with a me a) 50° 
small triangle in their bottom right Ww TEI scale cage 


corner are tool groups which can 
be opened by holding LMB on them 
for a moment (or dragging L™B to 
open them instantly). Expanded tool group. 


Hovering your cursor over a tool 
for a short time will show its 
name, while hovering longer will show the full tooltip. 


Resizing the Toolbar horizontally will display the icons with 
two columns. Expanding it further will display the icon and 
its text. 


Pop-Up Toolbar 


Reference 


Shortcut: Shift -Spacebar 


Pressing Shift-Spacebar will pop up a small toolbar right at 
your cursor for faster access. The shortcuts for selecting the 
tools are displayed on the right. 


Alternatively, you can map this action to Spacebar in the 
Keymap Preferences. Then you'll be able use Spacebar like a 
modifier key (similar to holding ctrt or Shift). For example, 
you Can press Spacebar T for Transform, Spacebar D for 
Annotate, Spacebar M for Measure and so on. See Spacebar 
Action. 


Quick Favorites 


Reference 


Shortcut: Q 


The Quick Favorites menu gathers your favorite tools. Any 
tool or menu item can be added to this pop-up menu via its 


context menu. 


Changing Tools 


If you have Alt Click Tool Prompt enabled in the Keymap 
Preferences, tapping Alt will display a tool prompt in the 
Status Bar. You can then press a key to select the 
corresponding tool, or tap Alt again to cancel the prompt. 


Fallback Tool 


The fallback tool is the one that’s selected by default (so the 
one at the top of the Toolbar). You can change it by either 
holding LMB on the toolbar button or pressing Alit-w to get a 
pie menu. 


Cycling Tools 


If you bind a key to a tool which is part of a group, you can 
enable the Cycle option in the keymap editor. Successive 
presses will then cycle through the tools in that group. 


This is enabled by default for the selection tools in the 3D 
Viewport, for example: pressing w will cycle between Select 
Box, Select Circle and so on. 


Properties 


Tools can have their own settings, which are available from 
multiple places: 


e The Tool > Active Too! panel in the Sidebar N. 
e The Active Too! tab in the Properties editor. 


e The Too! Settings region below the area header. 


Operators 


Operators execute an action the moment they’re activated, 
which makes them different from tools (which require some 
sort of input). Operators can be started from Operator 
Buttons, Header Menus, or Menu Search. Examples of 
operators include adding a new object, deleting it, or setting 
its shading to smooth. 


Operator Properties 


Most operators have properties that can be adjusted to 
refine their result. First run the operator (which will use its 
default settings), then adjust the properties in the Adjust 
Last Operation region. 


Modal Operators 


Modal operators exist as a concept in between Tools and 
regular operators. They require some sort of interactive 
input. 


The action of a modal operator can be confirmed using LMB 
Or Return. TO cancel a modal operator use RMB or Esc. 


Slider Operators 


Slider operators are used to interactively adjust a 
percentage value in the editor’s Header. 


You can adjust the percentage by dragging the slider left or 
right. This can be made coarser (Snapping in 10% 
increments) by holding ctrl and more precise by holding 
Shift. For some sliders, you can toggle “overshoot” with E, 
which lets you go beyond the 0-100% range. 


Undo & Redo 


The tools listed below will let you roll back an accidental 
action, redo your last action, or let you choose to recover to 


a specific point, by picking from a list of recent actions 
recorded by Blender. 


Undo 


Reference 

Mode: All Modes 
Menu: Edit » Undo 
Shortcut: Ctrl-Z 


If you want to undo your last action, just press Ctrl-Z. 


See also 


Memory & Limits Preferences to change undo settings. 


Redo 


Reference 

Mode: All Modes 
Menu: Edit » Redo 
Shortcut: Shift-Ctrl-Z 


To roll back the Undo action, press Shift-Ctrl-Z. 


Adjust Last Operation 


Reference 

Mode: All Modes 

Menu: Edit » Adjust Last Operation... 
Shortcut: FQ 


You can tweak the parameters of an operator after running 
it. In editors that support it, there is a “head-up display” 
panel in the bottom left based on the last performed 
operation. Alternatively, you can create a pop-up with F9 
which does the same thing. 


For example, if your last operation was a rotation in Object 
Mode, Blender will show you the last value changed for the 
where you can change your action back completely by 
typing Numpado. There are other useful options, based on the 
operator, and you cannot only Undo actions, but change 
them completely using the available options. 


If you are in Edit Mode, Blender will also change its contents 
based on your last action taken. In the second example (on 
the right), the last operation was a Move in Object Mode; 
but a Scale on a Face in Edit Mode, and, as you can see, the 
contents of Adjust Last Operation are different, because of 
the mode (Edit Mode) (See Fig. Scale (Edit Mode, Resize 
face). right). 


Adjust Last Operation. 


Rotation (Object 
Mode, 60 degrees). 


Scale (Edit Mode, 
Resize face). 


Tip 


Some operations produce particularly useful results by 
using Adjust Last Operation. For example, adding a Circle 
in the 3D Viewport; if you reduce the Vertices to three, you 
get a perfect equilateral triangle. 


Tip 


The Adjust Last Operation region can be hidden by View >» 
Adjust Last Operation. 


Undo History 


Reference 
Mode: All Modes 
Menu: Edit » Undo History 


There is also an Undo History of the last actions taken, 
recorded by Blender. 


The top of the list corresponds to the most recent actions. A 
small icon of a dot next to one of the entries indicates the 


current status. Rolling back 
actions using the Undo History 
feature will take you back to the 
action you choose. Much like how 
you can alternate between going 
backward in time with Undo and aan 
then forward with Redo, you can ae 
hop around on the Undo timeline Original 
as much as you want as long as 
you do not make a new change. 
Once you do make a new change, ‘The Undo History menu. 
the Undo History is truncated at 

that point. Selecting one of the 

entries in the list takes the current status to that position. 


@ Duplicate Objects 
Resize 
Add Monkey 


Delete 


Repeat Last 


Reference 

Mode: All Modes 

Panel: Edit » Repeat Last 
Shortcut: Shift-R 


The Repeat Last feature will repeat your last action when 
you press Shift-R. 


In the example images below, we duplicated a Monkey 
mesh and moved it a bit. Using repeat Shift-R, the Monkey 
was duplicated and moved a second time. 


Suzanne. After a After a 
Shift-D Shift-R. 
and move. 


Repeat History 


Reference 


Mode: All Modes 
Menu: Edit » Repeat History... 


The Repeat History feature will Repeat Hi 
present you a list of the last Renae 
repeated actions, and you can Resize 
choose the actions you want to Add Monkey 
repeat. It works in the same ae 

way as the Undo History, 


explained above, but the list The Repeat History menu 
contains only repeated actions. 


Important 


When you quit Blender, the complete list of user actions 
will be lost, even if you save your file before quitting. 


See also 


Troubleshooting section on Recovering your lost work. 


Annotations 


The annotation tool is available in multiple editors. It can be 
used to add notes to e.g. 3D objects or node setups. The 
arrow in the screenshot below is an annotation. 
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Annotations tool in a node editor. 


Annotation Tools 


The annotation tool can be activated in the Toolbar and has 
the following sub-tools: 


Annotate 
Draw free-hand strokes in the main area. 


Annotate Line 
Click and drag to create a line. Optionally, you can select 
the arrow style for the start and end of the line. 


Annotate Polygon 


Click multiple times to create multiple connected lines, 
then press RMB, Return Or Esc to confirm. 


Annotate Eraser 
Click and drag to remove lines. The eraser has a Radius 
setting found in Too! Settings. 


Tool Settings 


Common 


Color 
Adjust the color of existing and new strokes. 


Annotation Layer 
A pop-over menu, showing the name of the current layer, 
to access the Annotation Layers. 


Placement 
Determines where the annotations are drawn. 


3D Cursor: Only available in the 3D Viewport. The 
new annotations become part of the 3D 
scene; they’re drawn on an imaginary 
plane that goes through the 3D Cursor 
and is aligned to your view. 

Surface: Only available in the 3D Viewport. The 
new annotations become part of the 3D 
scene; they’re drawn onto the surface 
of the object under the mouse. If there 
is no surface, you get the same 
behavior as 3D Cursor. 

Image: 


Only available in 2D editors such as the 
Image Editor. The annotations become 
part of the 2D space, meaning their 
position and size change as you pan 
and zoom in the editor. 

View: The new annotations are 2D and get 
stuck to the screen. They keep the 
same position, rotation and size no 
matter how you pan, orbit or zoom in 
the editor. 


Stabilize Stroke 
Helps to reduce jitter of the strokes while drawing by 
delaying and correcting the location of points. 


Radius 
Minimum distance from the last point before the 
stroke continues. 


Factor 
A smooth factor, where higher values result in 
smoother strokes but the drawing sensation feels like 
as if you were pulling the stroke. 


Annotate Line 


Style Start, End 
The decoration to use at the beginning or end of the line 
segment. This can be used for example to create arrows 
to point out specific details in a scene. 


Annotation Layers 


When the annotation tool is enabled, the settings for 
managing multiple layers can be found in the Sidebar > 


View >» Annotations panel. 


Opacity 
Adjusts the opacity of existing and new strokes. 


Thickness 
Adjusts the thickness of existing and new strokes. 


Onion Skin 


Shows a ghosted image of strokes made in frames before 
and after the current frame. Onion skinning only works in 
the 3D Viewport and Sequencer. See the Grease Pencil 
documentation for an explanation of Onion Skinning. 


Before/After 
Color to use before and after the current frame on ghost 
frames. The number defines how many frames to show 
before and after the current frame. 


Selecting 


By default, Blender uses LB to select items. This can be 
changed to RMBs in the Preferences. 


Blender has several selection tools that can be used across 
the different editors. 


Note 


Some editors deviate from the keyboard shortcuts shown 
below. For example, most editors use Shift-LMB to adda 
single item to the selection, but the Outliner uses Ctrl-LMB. 
Similarly, most editors use Ctri-RMB for performing a Lasso 
Select, but node editors use Ctrl-Alt-LMB. 


Most selection tools come in two variants, where one variant 
is available in the Toolbar and the other in the Select menu. 
While the variants’ names are almost identical (such as 
Select Box in the Toolbar versus Box Select in the menu), 
the way they work is a bit different. New users coming from 
other applications will find the Toolbar variants to be the 
most familiar. 


Toolbar Selection Tools 


All the Toolbar selection tools behave the same when 
clicking an item: they select it (and deselect any previously 
selected items). If you hold shift while clicking, the item will 
be added to the selection (if it’s not selected) or removed 
from the selection (if it is selected). 


What makes the tools different is what happens when you 
drag. 


Tweak 
Reference 
Tool: Toolbar >» Tweak 
Shortcut: W 


Dragging an item will move it around. 


Select Box 


Reference 
Tool: Toolbar > Select Box 
Shortcut: W 


Dragging will create a rectangle, and select all the items 
that are partially or completely inside it once you release. 
(Any other items will be deselected.) 


Holding Shift while dragging will add the items to the 
selection. Holding ctr will remove them. 


While dragging, you can additionally hold Spacebar to move 
the rectangle around with the mouse. 


Select Box example (Edit Mode). 


Start. Selecting. Complete. 


Select Circle 


Reference 
Tool: Toolbar >» Select Circle 
Shortcut: W 


Dragging will select all the items which the circle passed 
over. Items which you didn’t pass over will be deselected. 


Holding Shift while dragging will add the items to the 
selection. Holding ctrit will remove them. 


You can change the radius of the circle in the tool settings 
(which can be found in the area header, the Tool tab of the 
Sidebar N, or the Active Tool tab of the Properties editor). 


Note 


In Object Mode: unlike Select Box, which selects objects as 
soon as the box covers any part of their geometry, Select 
Circle only selects objects if the circle passes over their 
Origin point. The origin is shown as an orange dot for 
selected objects but is invisible for unselected ones, unless 
“Origins (All)” is enabled in the Viewport Overlays. 


This difference in behavior does not apply to the other 
modes (like Edit Mode and Pose Mode). 


Select Circle example (Edit Mode). 


Start. Selecting. Complete. 


Select Lasso 


Reference 
Tool: Toolbar » Select Lasso 
Shortcut: W 


Dragging will create a freeform shape, and select all the 
items inside it once you release. (Any other items will be 


deselected.) 


Holding Shift while dragging will add the items to the 
selection. Holding ctrt will remove them. 


While dragging, you can additionally hold Spacebar to move 
the shape around with the mouse. 


Note 


Select Lasso behaves the same as Select Circle in that it 
only looks at origin points in Object Mode. 


Select Lasso example (Edit Mode). 


Start. Selecting. Complete. 


Selection Modes 


Reference 
Tool: Select Tools 
Panel: Tool Settings » Mode 


Each of the Toolbar selection tools has a mode to configure 
how it interacts with existing selections. Note that not every 


tool supports all of these modes. 

Set 
Sets a new Selection (the previous selection is 
discarded). This is the default. 


Extend 
Adds newly selected items to the existing selection. 


Subtract 


Removes newly selected items from the existing 
selection. 


Invert Ctrl-I 
Inverts the selection (unselected items become selected 
and vice versa). 


Intersect 
Selects items that intersect with the existing selection. 


Menu Selection Tools 


These tools are variants of the previously described ones. 
They’re available in the menu rather than the Toolbar and 
work slightly differently. 


Box Select 

Reference 

Menu: Select >» Box Select 
Shortcut: B 


To use this tool, you first activate the menu item or 
keyboard shortcut and then drag a box as usual. Unlike 
Select Box, the default behavior here is to add the items 
inside the box to the selection. (The ones outside the box 
are not deselected.) 


To remove the items inside the box from the selection, hold 
Shift, or drag with mMB instead. 


While dragging, you can additionally hold Spacebar to move 
the box around with the mouse. 


Circle Select 


Reference 
Menu: Select > Circle Select 
Shortcut: C 


To use this tool, you first activate the menu item or 
keyboard shortcut and then drag a circle around as usual. 
Unlike Select Circle, the default behavior here is to add the 
items inside the circle to the selection. (The ones outside 
the circle are not deselected.) 


To remove the items inside the circle from the selection, 
hold shift, or drag with mms instead. 


You can change the radius of the circle by scrolling with the 
Wheel or using the NumpadPlus and NumpadMinus keys. 


Once activated, Circle Select stays active: you can release 
the mouse button and start dragging somewhere else 
without having to press c again. At the same time, however, 
it blocks all other parts of Blender while it’s active. To 
deactivate the tool again, press RMB, Return, Or Esc. 


Lasso Select 


Reference 
Menu: Select >» Lasso Select 
Shortcut: Ctrl-RMB 


To use this tool, you first activate the menu item and drag a 
freeform shape around the item(s) you want to select with 


LMB. The menu lets you choose whether to set, extend or 
reduce the selection. 


Alternatively, you can immediately start dragging with ctrt- 
RMB. Unlike Select Lasso, the default behavior then is to add 
the items inside the lasso to the selection. (The ones outside 
the lasso are not deselected.) 


To remove the items inside the lasso from the selection, 
drag with Shift-Ctrl-RMB instead. 


While dragging, you can additionally hold Spacebar to move 
the lasso around with the mouse. 


Editors 


Blender provides a number of different editors for displaying 
and modifying different aspects of data. An Editor is 
contained inside an Area which determines its size and 
placement within the Blender window. Every area may 
contain any type of editor. 


The Editor Type selector, the first button at the left side of a 
header, allows you to change the Editor in that area. It is 
also possible to open the same Editor type in different areas 
at the same time. 


See User Interface for documentation on the general 
interface. 


The Editor Type selector. 


General 


e 3D Viewport 

e Image Editor 

e UV Editor 

e Compositor 

e Texture Nodes 

e Geometry Node Editor 


e Shader Editor 
e Video Sequencer 
e Movie Clip Editor 


Animation 


Dope Sheet 
Timeline 

Graph Editor 
Drivers Editor 
Nonlinear Animation 


Scripting 


e Text Editor 
e Python Console 
e Info Editor 


Data 


Outliner 
Properties 

File Browser 
Asset Browser 
Spreadsheet 
Preferences 


3D Viewport 
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Introduction 


The 3D Viewport is used to interact with the 3D scene for a 
variety of purposes, such as modeling, animating, texture 
painting, etc. 


Header Region 


Object Mode header. 


The header contains variouS menus and controls based on 
the current mode. Its items are split into three groups: 


Mode & Menus 


Mode Ctrt-Tab 
The 3D Viewport has several modes used for editing 
different kinds of data. For example, the default Object 
Mode would let you place a character in the scene, while 
Pose Mode would allow you to pose it. 


The shortcut Ctri-Tab brings up a pie menu for quick 
mode switching. If you have an Armature selected, it’ll 
instead switch between Object Mode and Pose Mode. 


Pressing Tab will switch between Object Mode and Edit 
Mode for objects that support it. 


View 
This menu offers tools for navigating in 3D space. 


The other menus depend on the current mode, Object Mode 
menus listed below: 


Select 
Contains tools for selecting objects. 


Add Shift-A 
Contains a list of different objects types that can be 
added to the scene. 


Object 
Contains tools for operating on objects, such as 
duplicating them. A subset of these tools can also be 
accessed by rightclicking in the 3D Viewport. 


Transform Controls 


Transform Orientation Comma 
Used to change the Transform Orientation, which affects 
the rotation of the transform gizmo. 


Pivot Point Period 
Used to change the Pivot Point, which affects the location 
of the transform gizmo. 


Snapping Shift-Tab 
Offers options for Snapping items to others that are 
nearby. You can hold ctrt to toggle snapping on/off 
temporarily (as long as the key is held). 


Proportional Editing o 
Used to smoothly transform unselected items that are 
near the selected ones. See Proportional Editing. 


Display & Shading 


Object Type Visibility 
Change which types of objects are visible/selectable in 
the 3D Viewport. See Object Type Visibility. 


Viewport Gizmos 
Change how gizmos are displayed in the 3D Viewport. 


Viewport Overlays 
Change how overlays are displayed in the 3D Viewport. 


X-Ray Alt-Z 
Make the whole scene transparent, allowing you to see 
and select items that would otherwise be occluded. This 
is a Shortcut to the X-Ray option inside the Viewport 
Shading popover. 


In Pose Mode, this same button controls a different 
setting with its own separate on/off state. Rather than 
making the scene transparent, it shows the armature in 
front of any geometry. 


Viewport Shading 
Change the shading of the 3D Viewport. 


Toolbar Region 


The Toolbar contains tools depending on the current mode 
(for example, modeling tools in Edit Mode, brush tools in 
Sculpt Mode...). 


See Tools for more information. 


Sidebar Region 


The Sidebar region contains properties of the active object 
and tool, as well as of the viewport itself. 


See Sidebar for more information. 


Startup Scene 


After closing the splash screen, the startup scene is 
displayed in the 3D Viewport (if no other blend-file was 
loaded). This startup scene can be customized. 


The startup scene. 


Elements 


Cube 
The gray cube in the center of the scene is a mesh 
object. Its orange outline indicates that it’s selected. The 
orange dot in the center is its Origin, which indicates its 
precise location. 


Light 


The set of concentric black circles is a light source 
illuminating the cube. 


Camera 
The pyramid with a big triangle above it is the camera, 
which is used as the point of view for rendering. 


3D Cursor 
The 3D cursor, a cross with a red-and-white circle, 
determines where newly added objects are placed and 
can also serve as a transformation pivot point. 


Grid Floor 
The gray lines forming a floor mark the zero height of the 
world. The red and green lines are the axes of the world 
coordinate system. They meet at the world origin, which 
is also where the origin of the Cube is located. The Grid 
Floor settings are in the Viewport Overlays popover. 


Text Info 


The top left corner of the viewport shows various bits of 
information - see Viewport Overlays for details. 


Object Modes 


Modes allow editing different 
aspects of objects. While Object 


v ‘BD Object Mode ~ View 


@. Object Mode 
Mode allows you to a haben 
position/rotate/scale them, Edit Perce 
Mode allows changing their MD as Vertex Paint 
geometry, Pose Mode allows t,t) Weight Paint 
posing them, and so on. [8 Texture Paint 


You can change the current mode 
using the Mode selector in the 3D 
Viewport header. Which modes are 
available depends on the object’s 
type. The complete list is shown 
below. 


The Mode select menu. 


Apart from using the selector, you can also press Ctrl-Tab to 
bring up a pie menu around the cursor for faster access. (If 
the selected object is an Armature, this shortcut will instead 
switch between Object Mode and Pose Mode.) 


Pressing Tab will toggle Edit Mode for objects that support it. 
Modes can affect many things in Blender: 


e Each mode changes the header and Toolbar to show its 
own unique set of menus and tools. This also means it 
affects the available keyboard shortcuts. 

e Modes can completely change the look of the viewport. 
For example, Weight Paint mode will shade the object to 
show its vertex weights, which are not normally visible. 

e Modes can affect other editors. For example, the UV 
Editor can only be used if the 3D Viewport is in Edit 


Mode. In the Properties editor, too, certain buttons and 
panels can only be used in certain modes. 


Object Mode List 


Blender’s Modes 


Icon 


Name 


Object Mode 


Edit Mode 


WN 


culpt Mode 


Vertex Paint 
Mode 


Weight Paint 
Mode 


Details 


The default mode, available for 
all object types. Allows editing 
position, rotation and scale, 
duplicating objects, and so on. 


A mode for editing an object’s 
shape (vertices/edges/faces for 
meshes, control points for 
curves/surfaces, points/strokes 
for Grease Pencil, etc.). 


Provides an alternative toolset 
for editing an object’s shape 
(only for meshes). 


A mesh-only mode that allows 
you to set your mesh’s vertex 
colors (i.e. to “paint” them). 


A mesh-only mode, dedicated to 
vertex group weighting. 


Icon Name 


Texture Paint 


Mode 


Particle Edit 
Mode 


Pose Mode 


Draw Mode 


Note 


Details 


A mesh-only mode that allows 
you to paint a texture directly on 
the model, in the 3D Viewport. 


A mesh-only mode dedicated to 
particle systems, useful for 
editable systems (hair). 


An armature-only mode, 
dedicated to posing. 


A Grease Pencil-only mode, 
dedicated to creating Grease 
Pencil strokes. 


The cursor becomes a brush in Paint and Sculpt Modes. 


We will not go into any more detail on mode usages here, 
because they are dealt with in their own sections. 


Hint 


If you are reading this manual and some button or menu 
option is referenced that does not appear on your screen, 
it may be that you are not in the proper mode for that 


option to be valid. 


Switching Objects 


Reference 
Mode: All Modes 
Shortcut: Alt-Q 


If you enter a mode such as Weight Paint for an object and 
then select another object, Blender will typically switch back 
to Object Mode. This means that, if you want to weight paint 
the other object too, you have to enter the mode a second 
time. 


There is a way of avoiding this, however. Once you enter a 
mode, the Outliner will show a dot next to other objects that 
also support it. By clicking such a dot, you can switch over 
to another object without leaving the mode. 


Alternatively, you can hover over the other object in the 3D 
Viewport and press Alt-Q. 


See also 


Lock Object Modes for preventing accidental mode 
changes. 


Multi-Object Editing 


Edit Mode and Pose Mode let you work with multiple objects 
even more easily than described above, as they can have 
multiple objects in the mode at the same time. 


There are two ways of accomplishing this: 


e If you’re not yet in the mode, you can simply select all 
the objects and enter it. 

e If you’re already in the mode, you can bring other 
objects into it by clicking ctri-LMB on the dot in the 
Outliner. Removing objects from the mode works in the 
same way. 


Some points of note: 


e The Properties editor will only ever show the details 
(shape keys, UV maps...) of the active object, not of all 
the selected ones. 

e Selecting any element from an object will make it the 
active one. 

e There are limits to the edits you can make. For example, 
you can’t create an edge that connects vertices from 
different objects. 


Navigating 


Introduction 

o Navigation Gizmo 
Navigation 

°o Orbit 
Roll 
Pan 
Zoom In/Out 
Zoom Region 

o Dolly View 

o Frame All 

o Frame Selected 
Fly/Walk Navigation 

o Walk Navigation 

o Fly Navigation 
Aligning 
Perspective/Orthographic 

o Options 
Local View 

o Toggle Local View 
Camera View 

o Viewing the Active Camera 

o Setting the Active Camera 
Frame Camera Bounds 

o Zoom Camera 1:1 

o Camera Positioning 
Viewpoint 
View Regions 

o Clipping Region 

o Render Region 
Contextual Views 

o Quad View 
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Introduction 


To be able to work in the three-dimensional space that 
Blender uses, you must be able to change your viewpoint as 
well as the viewing direction of the scene. While we will 
describe the 3D Viewport editor, most of the other editors 
have similar functions. For example, it is possible to pan and 
zoom in the Image editor. 


Tip 
Some navigation tools require a middle mouse button or 
numpad. If you don’t have one of these, see the Keyboard 


and Mouse page of the manual to learn how to work 
around this. 


Navigation Gizmo 


The navigation gizmo can be found in 
the top right of the editor. 


The Orbit gizmo at the top shows the 
current orientation of the view. 
Dragging it with LMB will orbit the view. 
Clicking any of the axis labels will align 
the view to that axis. Clicking the same 
axis again switches to the opposite side 
of that same axis. 


The four buttons below the orbit gizmo 
do the following: 


Zoom the 3D Viewport 
Pan the 3D Viewport 


Toggle the Camera View 


Toggle the Projection 


Navigation Gizmo. 


Navigation 
Orbit 


Reference 

Mode: All modes 

Menu: View > Navigation > Orbit 
Shortcut: MMB, Numpad2, Numpad4, Numpad6, Numpads. 


Rotate the view around the point of interest by clicking and 
dragging mMB on the viewport’s area. 


The Alt key has several effects on orbiting: 


e Clicking a point with Alt-mMMB will make it the point of 
interest: it becomes the central point which the view 
orbits around. 

e Holding Alt and then dragging with mms in a certain 
direction will align the view to an axis and make it 
orthographic. 

e Dragging with mB and then holding Att will perform an 
orbit while also snapping to the world axes, as well as 
the diagonals between them. 


To change the viewing angle in discrete steps, USe Numpad8 
and Numpad2 to go up and down, or Numpad4 and Numpadé for left 
and right. You can alSo press Numpad9 to switch to the 
opposite side of the view (rotates the camera 180° around 
the Z axis). 


See also 


e Orbit Style Preference 
e Auto-Perspective Preference 


Roll 


Reference 

Mode: All modes 

Menu: View > Navigation » Roll 
Shortcut: Shift-Numpad4, Shift -Numpad6 


Rotate the viewport camera around its viewing direction in 
15° discrete steps by default. See the rotation angle 
preference to configure. 


To reset the roll, you can first align the view to the global X 
axiS USINg Numpad3, then orbit to get back to the regular 
perspective view. 


Pan 

Reference 

Mode: All modes 

Menu: View > Navigation > Pan 

Shortcut: Shift-MMB, Ctrl-Numpad2, Ctrl-Numpad4, Ctrl- 


Numpad6, Ctrl-Numpad8 


Moves the view up, down, left and right. To pan the view, 
hold down Shift and drag mms in the 3D Viewport. For 
discrete steps, use the hotkeys Ctrl-Numpad8, Ctrl-Numpad2, 
Ctrl-Numpad4 and Ctrl-Numpad6é as with orbiting. 


Zoom In/Out 


Reference 

Mode: All modes 

Menu: View > Navigation » Zoom In/Out 
Shortcut: Ctrl-MMB, Wheel, NumpadPlus, NumpadMinus 


Moves the view closer to, or further away from, the point of 
interest. You can zoom in and out by rolling the wheel or 
dragging with Ctrl-MMB. To zoom with discrete steps, use the 
hotkeys NumpadPlus and NumpadMinus. 


Hint 
If you get lost in 3D space (which is not uncommon), 


Frame All and Frame Selected can be used to show the 
contents of your scene. 


Zoom Region 


Reference 

Mode: All modes 

Menu: View > Navigation >» Zoom Region... 
Shortcut: Shift-B 


The Zoom Region tool allows you to specify a rectangular 
region by dragging with Las. The view will then zoom in on 
this region. 


You can also drag with mms to zoom out instead. 


Dolly View 


Reference 

Mode: All modes 

Menu: View > Navigation >» Dolly View... 
Shortcut: Shift-Ctrl-MMB 


In most cases it’s sufficient to zoom the view to get a closer 
look at something. However, zooming only gets you up to 
the point of interest and no further. If you hit this point 
where zooming no longer works, you can instead Dolly by 
holding Shift-ctrl and dragging up or down with mss. This 
will move the point of interest (and the view along with it). 


Frame All 

Reference 

Mode: All modes 
Menu: View > Frame All 
Shortcut: Home 


Changes the view so that you can see all objects. 


Frame Selected 


Reference 
Mode: All modes 
Menu: View > Frame Selected 


Shortcut: NumpadPeriod 


Changes the view so that you can see the selected 
object(s). 


Fly/Walk Navigation 


The standard navigation controls are sometimes limiting, 
especially for large environments such as architectural 
models. In these cases, it may be preferable to use first 
person controls instead, where you can look around while 
“standing” in one place rather than orbiting around a 
central viewpoint. 


Blender offers two such alternative navigation methods: 
Flying and Walking. You can initiate either method from the 
View > Navigation menu. You can also initiate your preferred 
one (configured in the Preferences) by pressing Shift- 
AccentGrave. 


Y Fly & Walk 


View Navigation Walk Fly 


View Navigation. 
Common use cases for Fly/Walk include: 


Navigating 
This can be a quick way to navigate a large scene. 


Positioning a camera 
When activated from a camera view Numpado, the camera 
will move along with you. 


Recording camera movement 
You can record the path you take by entering a camera 
view, enabling Auto Keying in the Timeline, starting 
animation playback, and finally activating Fly/Walk 


navigation. The path will be recorded as camera 
keyframes which can then be used for rendering. 


Animation playback can’t be controlled while Fly/Walk 
navigation is active, so when you're done recording, you 
first need to exit the navigation with LMB before you can 
stop playback. 


Walk Navigation 


Reference 
Mode: All modes 
Menu: View > Navigation >» Walk Navigation 


This navigation method behaves like a typical first person 
game. It works with a combination of keyboard keys and 
mouse movement. 


Usage 


Move the mouse in the direction you want to look and use 
the keys listed below to walk around the scene. 


When you are happy with the new view, press LMB to 
confirm. In case you want to go back to where you started, 
press Esc Or RMB. 


All these keys are also listed in the Status Bar while 
navigating. Settings like mouse sensitivity and default speed 
can be adjusted in the Preferences. 


w/Up Move forward. 


S/Down 


A/Left 


D/Right 


Spacebar 


WheelUp/NumpadPlus 


WheelDown/NumpadMinus 


Shift 


Alt 


Move backward. 


Strafe left. 


Strafe right. 


Move up - only available if Gravity is 
off. 


Move down - only available if Gravity 
is Off. 


Teleport to the location at the 
crosshair (offset by the Camera 
Height value set in the Preferences). 


Increase the movement speed. 


Decrease the movement speed. 


Speed up the movement temporarily. 


Slow down the movement 
temporarily. 


Jump - only available if Gravity is on. 


Tab Toggle Gravity. 


Correct the Z axis of the view 
Z (smoothly roll it to ensure it’s upright, 
not tilted to a side). 


Fly Navigation 


Reference 
Mode: All modes 
Menu: View > Navigation > Fly Navigation 


On activation, the cursor is centered inside a rectangle that 
defines a safe zone. When the cursor is outside this zone, 
the view will rotate/pan. 


Usage 


Move the mouse outside the safe zone in the direction you 
want to look. 


Click LMB or press Spacebar to keep the current view and exit 
Fly navigation. In case you want to go back to where you 
started, press Esc Or RMB. 


w/Up Accelerate forward. 


S/Down Accelerate backward. 


A/Left Accelerate left. 


D/Right Accelerate right. 
E Accelerate upward. 
Q Accelerate downward. 


Drag to pan the view. Flying will 


ae pause while you’re doing this. 


Increase the acceleration in the 
WheelUp/NumpadP lus direction of motion. If there is no 
motion, start accelerating forward. 


Decrease the acceleration in the 
WheelDown/NumpadMinus direction of motion. If there is no 
motion, start accelerating backward. 


Slow down as long as the key is held, 
Alt until the view eventually comes to a 
standstill. 


Disable rotation - while held, the view 
rotation doesn’t influence the flight 
Ctrl direction. This allows you to fly past 
an object, keeping it centered in the 
view even as you fly away from it. 


Toggle X axis correction. If enabled, 
the view will smoothly pitch to look at 
the horizon when the cursor is in the 
safe zone. 


Toggle Z axis correction. If enabled, 
the view will smoothly roll to an 
upright orientation. 


Aligning 


Reference 


Menu: View > Align View 


These options allow you to align and orient the view. 


Align View to Active 
Aligns the view to a certain local axis of the active object, 
bone, or (in Edit Mode) the normal of the active face. The 
view also becomes orthographic. 


To return to the regular (untilted) perspective view, you 
can first press Numpad3 to align to the global X axis, then 
orbit with MMB. 


Align Active Camera to View Ctrl-Alt-Numpado 
Moves and rotates the active camera so it matches the 
Current viewpoint. 


Align Active Camera to Selected 
Moves the active camera (without changing its 
orientation) so that its view frames the selected objects. 


Center Cursor and Frame All Shift-c 
Moves the 3D Cursor back to the world origin and 
changes the view so that you can see everything in your 
scene. 


Center View to Cursor 
Centers the view on the 3D Cursor. 


View Lock to Active 


Centers the view on the active object and makes it the 
point of interest. The view will continue orbiting around it 
even if you pan to a different location. 


View Lock Clear 


Returns the view to how it was before using View Lock to 
Active. 


Perspective/Orthographic 


Reference 

Mode: All modes 

Menu: View » Perspective/Orthographic 
Shortcut: Numpad5 


This operator changes the projection of the viewport 
camera. Each 3D Viewport supports two different types of 
projection. These are demonstrated in the Fig. below. 


Orthographic Perspective 
projection. projection. 


Our eyes are used to perspective viewing where distant 
objects appear smaller. Orthographic projection often seems 
a bit odd at first, because objects stay the same size 
regardless of their distance. It is like viewing the scene from 
an infinitely distant point. Nevertheless, orthographic 
viewing can be very useful, because it provides a more 
“technical” insight into the scene, making it easier to model 
and judge proportions. 


Options 


To toggle between the two projections for the 3D Viewport, 
select View > Perspective/Orthographic or use the shortcut 
Numpad5. Changing the projection for a 3D Viewport does not 
affect the way the scene will be rendered. Rendering is in 
perspective by default. If you need to create an 
orthographic rendering, select the camera, go to the 
Camera tab in the Properties editor, and set the Type in the 
Lens panel to Orthographic. 


See also 


e Auto-Perspective Preference 


« Camera Lens Type 
« Camera Projections 


Local View 


Toggle Local View 


Reference 

Mode: All modes 

Menu: View > Local View > Toggle Local View 
Shortcut: NumpadSlash, Slash 


Global view shows all 3D objects in the scene. Local view 
isolates the selected object(s) so that they are the only ones 
visible in the viewport. This is useful for working on objects 
that are obscured by others, or to speed up the viewport 
performance in heavy scenes. Local view is contextual, 
meaning that it can be set per 3D Viewport. 


You can toggle between Global and Local View by selecting 
the option from the View menu or using the shortcut 
NumpadSLash. 


d 


Global View. Local View. 


Note 


In local view, the 3D cursor is not locked to the scene. 
Instead, each view has an independent cursor location. 


Tip 


Accidentally pressing NumpadSlash can happen rather often if 
you are new to Blender, so if a bunch of the objects in your 
scene seem to have mysteriously vanished, try pressing 
NumpadSlash again. 


Remove from Local View 


Reference 

Mode: All modes 

Menu: View > Local View >» Remove from Local 
View 

Shortcut: Alt-NumpadSlash, Alt-Slash 


Objects can be removed from Local View by selecting them 
and using the Remove from Local View operator. This will 
move them back to the global view. If the last remaining 
object is removed, the local view will be left empty and you 
will have to exit it to see any objects. 


Hint 


This is useful when working with objects in dense scenes 
where painstakingly selecting objects to include in the 
local view isn’t practical, especially when they intersect or 
are obscured by objects you don’t want to include. In this 


case it’s simpler to select many objects in a region and 
enter local view, then remove the ones you don’t need. 


Camera View 


Camera Perspective 


ne 
(1) Collection | Suzanne 


Demonstration of camera view. 


The Camera view shows the current scene from the active 
camera’s viewpoint. 


The Camera view can be used to virtually compose shots 
and preview how the scene will look when rendered. The 


rendered image will contain everything within the dashed 
frame. 


See also 

Camera Settings for details on how camera settings are 
used for display and rendering. 

Hint 


While in camera view, you can select the camera by 
clicking the dashed frame (assuming the camera object 


isn’t hidden). 


Viewing the Active Camera 


Reference 

Mode: All Modes 

Menu: View > Cameras > Active Camera, View >» 
Viewpoint » Camera 

Shortcut: Numpad@ 


This switches the view to the active camera. 


Setting the Active Camera 


Reference 
Mode: Object Mode 
Menu: View >» Cameras » Set Active Object as 


Camera 
Shortcut: Ctrl-Numpado 


Active camera (left) displayed with a solid triangle 
above it. 


This sets the current active object as the active camera and 
switches to the camera view. 


The active camera is the one that will be used for rendering, 
and which you'll look through when choosing camera view. 


Another way of setting the active camera is through the 
Scene tab of the Properties. 


Note 


The active camera is normally defined on the scene level, 
so that it’s the same across all 3D Viewports. However, it’s 
also possible to make a camera the active one within one 
Viewport only. See Local Camera. 


Animated Camera Switching 


While a scene contains only one camera by default, it’s 
possible to have multiple. You can then bind the cameras to 


specific time points in your animation to create jump cuts 
showing different viewpoints. See Animating Cameras. 


Frame Camera Bounds 


Reference 

Mode: All Modes 

Menu: View >» Cameras > Frame Camera Bounds 
Shortcut: Home 


Centers the camera view inside the 3D Viewport’s screen 
area and resizes the view to fit within the area’s bounds. 


Zoom Camera 1:1 


Reference 
Mode: All Modes 
Menu: View > Navigation » Zoom Camera 1:1 


Zooms the view so that the camera frame has the exact 
same size as the output resolution. This allows you to 
preview exactly how large objects will be in the rendered 
image/animation. 


Camera Positioning 


There are several different ways to position the camera in 
your scene. Some of them are explained below. 


Hint 


The active “camera” might be any kind of object, meaning 
these actions can also be used to position and aim a light 
for example. 


Align Active Camera to View 


Reference 

Mode: Object Mode 

Menu: View > Align View » Align Active Camera 
to View 

Shortcut: Ctrl-Alt-Numpado 


Moves and rotates the camera so it perfectly matches your 
current viewport view. 


Camera Navigation 


By enabling Lock Camera to View in Sidebar > View and 
switching to camera view, the camera will become “glued” 
to the view and follow it around as you navigate. 


See also 


Fly/Walk Navigation for first person navigation that moves 
the active camera too. 


Roll, Pan, Dolly, and Track 


To perform these camera moves, the camera must first be 
selected so transform operations apply to it. The following 
actions also assume that you are in camera view. Having 


done so, you can now manipulate the camera using the 
same tools that are used to transform any object: 


Roll 
Press R to enter object rotation mode. The default will be 
to rotate the camera along its local Z axis (the axis 
orthogonal to the camera view), which is the definition of 
a camera “roll”. 


Vertical Pan or Pitch 
This is just a rotation along the local X axis. Press R to 
enter object rotation mode, then x twice. (The first press 
selects the global axis, the second the /ocal axis. This 
works with any axis; see Axis Locking). 


Horizontal Pan or Yaw 
This corresponds to a rotation around the camera’s local 
Y axis. Press R, then Y twice. 


Dolly 
To dolly the camera, press G then mms (or z twice). 


Sideways Tracking 
Press G and move the mouse (you can use x or Y twice to 
get purely horizontal or vertical tracking). 


Viewpoint 


The menu View >» Viewpoint lets you align the viewing 
direction to a specific axis. This can also be done using the 
Navigation Gizmo or the following hotkeys: 


Top: Numpad7 
Front: Numpad1 
Right: Numpad3 
Bottom: Ctrl-Numpad7 
Back: Ctrl-Numpad1 
Left: Ctrl-Numpad3 


The above hotkeys align the view to a global (world) axis. 
You can also align to a local axis of the selected item by 
additionally holding shift. This way, you can for example 
view any mesh face head-on, no matter how it’s oriented. 
(To get out of this local viewpoint, simply align to a global 
axis again.) 


The view can also be aligned by holding Alt-mMmMB and 
dragging the mouse in a certain direction. 


View Regions 


Clipping Region 


Reference 

Mode: All modes 

Menu: View > View Regions » Clipping Region... 
Shortcut: Alt-B 


Allows you to define a clipping region to limit the 3D 
Viewport display to a portion of 3D space. It can assist in the 
process of working with complex models and scenes. 


Once activated, you have to draw a rectangle with the 
mouse. It becomes a clipping volume of four planes: 


e Aright-angled parallelepiped (of infinite length) if your 
view is orthographic. 

e A rectangular-based pyramid (of infinite height) if your 
view is in perspective. 


Once clipping is used, you will only see what’s inside the 
volume you defined. Tools such as paint, sculpt, selection, 
transform snapping, etc. will also ignore geometry outside 
the clipping bounds. 


To delete this clipping, press Alt-B again. 


Example 


Region/Volume clipping. 


en 


. View 
Selecting Region rotated. 
a region. selected. 


The Region/Volume clipping image shows an example of 
using the clipping tool with a cube. Start by activating the 
tool with alt-B. This will generate a dashed cross-hair cursor. 
Click with the LmB and drag out a rectangular region. Now 
clipping is applied against that region in 3D space. Use the 
MMB to rotate the view and you will see that only what is 
inside the clipping volume is visible. All the editing tools still 
function as normal, but only within the clipping volume. 


The dark gray area is the clipping volume itself. Once 


clipping is deactivated with another Alt-B, all of 3D space 
will become visible again. 


Render Region 


Reference 

Mode: All modes 

Menu: View > View Regions >» Render Region... 
View > View Regions > Clear Render 
Region 

Shortcut: Mark: ctri-B Clear: Ctrl-Alt-B 


When using the Rendered shading mode, it can be quite 
slow to render the entire 3D Viewport. To fix this, you can 
define a subregion to render just a portion. This can be very 


useful for reducing render times for quick previews on an 
area of interest. 


Apart from clearing the render region, you can also 
temporarily disable it in the Sidebar if you’re not in Camera 
View, or in the Output tab of the Properties editor if you are. 


Render region and associated render. 


Tip 


If you set a render region while in camera view and have it 
enabled in the Output properties, it will be applied to the 
final render. 


See also 


Zoom Region. 


Contextual Views 


By default, the 3D Viewport only shows the scene from one 
viewpoint. By using Quad Views, you can see it from 
multiple viewpoints at the same time, which gives more 
context about the changes you’re making. 


Quad View 


Reference 

Mode: All modes 

Menu: View > Area > Toggle Quad View 
Shortcut: Ctrl-Alt-Q 


Toggling Quad View will split the 3D Viewport into four 
views: three orthographic side views and one user 
perspective view. 


Note 


Quad View is different from splitting the area and aligning 
the views manually. In Quad View, the four views are still 

part of a single 3D Viewport, so that they share the same 
display options. 


Quad View. 


Options 

Reference 

Mode: All modes 

Menu: Sidebar > View > Quad View 


Lock Rotation 
When disabed, makes it possible to orbit in the 
orthographic views as well (turning them into perspective 
views instead). 


Sync Zoom/Pan 
Syncs the view position between side views. (Requires 
Lock Rotation to be enabled.) 


Clip Contents 
Clip objects based on what is visible in the other side 
views. 


3D Cursor 


The 3D Cursor is a point in space that has both a location 
and a rotation. It’s used for a number of purposes. For 
example, it defines where newly added objects are placed, 
and can also be used to manually position and orient the 
transform gizmo (see Pivot Point and Transform Orientation). 
Some tools, such as Bend, also use the Cursor. 


Placement 


There are a few methods to position the 3D Cursor. 


Direct Placement with the Mouse 


Reference 

Mode: Object, Edit, and Pose Mode 
Tool: Cursor 

Shortcut: Shift-RMB 


Positioning the 3D Cursor with two orthogonal views. 


The Cursor tool offers the most flexibility. Simply select it in 
the Toolbar and click a point in the scene with Ls to place 
the 3D Cursor there. In the tool settings, you can choose 
how it should be oriented: by default, it matches the view 
orientation, but you can also make it match the surface 
normal of a piece of geometry, or the transform orientation. 


Alternatively, you can press Shift-RMB with any tool selected. 
In this case, the 3D Cursor will always be aligned to the view 
orientation. 


For accuracy you should use two perpendicular orthogonal 
3D Viewports, i.e. any combination of top Numpad7, front 
Numpad1 and side Numpad3. That way you can control the 
positioning along two axes in one view and determine the 
depth in the other. 


By default, the depth of the geometry under the cursor is 


used. This can be disabled using the Cursor Surface Project 
toggle in the Preferences. 


Sidebar 


Reference 


Mode: All Modes 
Panel: Sidebar region > View » 3D Cursor 


¥ 3D Cursor 


Location 


XYZ Euler 


The 3D Cursor panel of the Sidebar region. 


The 3D Cursor can also be positioned and oriented by 
editing the respective values in the Sidebar. 


Snapping 

Reference 

Mode: Object, Edit, and Pose Mode 

Menu: Object/Mesh/... » Snap » Cursor to... 
Shortcut: Shift-S 


One more way of positioning the 3D Cursor is through the 
Snap menu, which allows you to move the Cursor to the 
origin of the selected object for example. 


Selecting 


This page discusses selection tools that are specific to the 
3D Viewport. The generic selection tools are described in 
the Interface section. 


The 3D Viewport has two keys that affect selection: 


Select by Origin ctrl 
Selects objects by their origin rather than their geometry. 


Selection Menu Alt 
Shows a menu in case there are multiple objects under 
the mouse cursor, making it easier to select the one you 
want. 


These keys can be combined to get a selection menu based 
on object origins. 


The mode-specific selection pages are listed below. 


Object Mode 


e Object Mode 


Edit Mode 


Mesh Edit Mode 
Curve Edit Mode 
Surface Edit Mode 
Metaball Edit Mode 
Text Edit Mode 


e Grease Pencil Edit Mode 
e Bone Edit Mode 
e Lattice Edit Mode 


Pose Mode 


e Pose Mode 


Particle Edit Mode 


e Particle Edit Mode 


Controls 


Transform Orientation 
o Orientations 
Pivot Point 
o Pivot Types 
¢ Snapping 
o Snap To 
Snap With 
o Target Selection 
o Affect 
e« Proportional Editing 
Controls 
Object Mode 
Edit Mode 
Example 


ie) 


o Oo 0 °O 


Transform Orientation 


Reference 

Mode: Object and Edit Modes 

Panel: Header » Transform Orientation 
Shortcut: Comma 


The Transform Orientation determines the orientation of the 
Object Gizmo. Changing this orientation can make it easier to 
perform transformations in the direction you want. 


With the default Global transform orientation (left) 
it’s tricky to move the plane in the direction it’s 
facing, but with Local (right) it’s easy. 


The Transform Orientation can be changed using a selector in 
the 3D Viewport’s header: 


Transform Orientation selector. 


The orientation can also be changed temporarily while 
performing a hotkey-based transformation with axis locking. 
For example, if you first press G to start moving an object, 
then x to lock to the orientation’s X axis, and finally x a 
second time, you'll get a lock to an alternative orientation: 
the Local orientation if it was Global previously, and the 
Global orientation otherwise. 


In addition to the builtin orientations, you can also define 
your own (see Custom Orientations below). 


Orientations 


Global 


Align the transformation axes to world space. The world 
axes are shown by the Navigation Gizmo in the top right 
corner of the viewport, as well as the Grid Floor. 


Local 


Align the transformation axes to the active object’s 
orientation. 


Normal 
In Edit Mode, orient the transformation axes so that the Z 


axis of the gizmo matches the average Normal of the 
selected elements. 


In Object Mode, this is equivalent to Local orientation. 


Gimbal 


Orient the transformation axes to visualize the workings of 
the object’s Rotation Mode. This is specifically useful for 
the Euler modes, where the object is rotated one axis ata 
time: the rotation axes don’t stay perpendicular to each 


other and might even overlap, a phenomenon known as 
gimbal lock that complicates animation. 


View 
Align the transformation axes to the view (meaning they 
change as you orbit around): 


e X: Left/Right 
e Y: Up/Down 
e Z: Towards/Away from the screen 


Cursor 
Align the transformation axes to the 3D Cursor. 


Examples 


Cube with the rotation gizmo active in multiple transform 
orientations. 


Default Rotated Local — 
cube with cube with orientation, 
Global Global — gizmo 
transform orientation, matches 
orientation gizmo has the 
selected. not object’s 


changed. rotation. 


Normal Gimbal View 


orientation, transform transform 
in Edit orientation. orientation. 
Mode. 


Custom Orientations 


Reference 
Mode: Object and Edit Modes 
Panel: Header > Transform Orientation 


You can define custom transform orientations using objects 
or mesh elements. Custom orientations defined from an 
object use the Local orientation of that object, whereas those 
defined from mesh elements (vertices, edges, faces) use the 
average Normal! orientation of those elements. 


L4, Global 
<q Local 


e> Normal 


& Gimbal 


LL. View 


a) Cursor 


Cube 


Transform Orientation panel. 


The Transform Orientation panel, found in the header of the 
3D Viewport, can be used to select, add, remove, and 
rename transform orientations. 


The default name for these orientations is derived from the 
selection. If it’s an object it will take that object’s name, if it’s 
an edge it will be titled “Edge”, and so on. 


Create Orientation 


To create a custom orientation, select an object or mesh 
element(s) and click the “+” button in the Transform 
Orientation panel. 


Custom 
Use Viev 


Use after creation 


Overwrite previou 


Create Orientation Adjust Last Operation panel. 


Right after creating the orientation, the Create Orientation 
Adjust Last Operation panel gives a few options: 


Name 
Text field for naming the new orientation. 


Use View 
The new orientation will be aligned to the view space. 


Use After Creation 
The new orientation stays selected. 


Overwrite Previous 
If the new orientation is given an existing name, a suffix 
will be added to it’s name to avoid overwriting the 
existing orientation, unless Overwrite Previous is checked, 
in which case it will be overwritten. 


Delete Orientation 


To delete a custom orientation, simply select it and click the 
x button. 


Pivot Point 


Reference 

Mode: Object Mode and Edit Mode 
Header: Pivot Point 

Shortcut: Period 


The Pivot Point determines the location of the Object Gizmo. 
Changing this location can make it easier to perform 
transformations around the point you want. 


With the default “Median Point” pivot point (left) it’s 
tricky to bring the second wheel spoke into place, 
but with “3D Cursor” (right) it’s easy. 


The Pivot Point can be changed using a selector in the 3D 
Viewport’s header: 


Ov 


« Bounding Box Center 
f)} 3D Cursor 

On Individual Origins 
cP Median Point 


@’ Active Element 


Pivot Types 


¢« Bounding Box Center 
o In Object Mode 
o In Edit Mode 

e 3D Cursor 
o Example 

e Individual Origins 
o In Object Mode 
o In Edit Mode 

e Median Point 
o In Object Mode 
o In Edit Mode 

e Active Element 
o In Object Mode 
o In Edit Mode 


Bounding Box Center 


Reference 

Mode: Object Mode and Edit Mode 

Header: 28 Pivot Point » Bounding Box Center 
Shortcut: Period 


In this mode, the pivot point lies at the center of the 
bounding box, which is a box that’s wrapped as tightly as 
possible around the selection while still being aligned to the 
world axes. 


In Object Mode 


The pivot point becomes the center of the bounding box 
around the selected objects’ origin points, not their 
geometry. 


This means that, if you have a single object selected, the 
pivot point is the same as the object’s origin point - which 
can be customized and doesn’t have to be in the center. In 
the example below, the orange rectangle has it in a corner 
instead. 


Single object rotation. 


If you have multiple objects selected, the pivot point 
becomes the center of an imaginary box around their 
Origins. 


The image below shows the difference between Bounding 
Box Center and Median Point. The latter calculates the 
average position of the origins, meaning that the pivot point 
shifts towards the area with the most objects. 


Difference between “Bounding Box Center” (left) 
and “Median Point” (right). 


In Edit Mode 


The pivot point becomes the center of the bounding box 
around the selected mesh elements. 


aie [ | 
The effects of rotation in different mesh selection 


modes. The pivot point is shown by a yellow circle. 


Median Point may again give a different result. 


Difference between “Bounding Box Center” (left) 
and “Median Point” (right). 


3D Cursor 


Reference 

Mode: Object Mode and Edit Mode 
Header: Pivot Point » 3D Cursor 
Shortcut: Period 


Places the pivot point at the location of the 3D Cursor. 


Example 


The image below shows the difference between rotating an 
object around the 3D Cursor (left) and rotating it around the 
Median Point (right). 


Rotation around the 3D Cursor compared to the 
Median Point. 


Individual Origins 


Reference 

Mode: Object Mode and Edit Mode 
Header: Pivot Point > Individual Origins 
Shortcut: Period 


While the other pivot point modes transform the whole 
selection around one point, Individual Origins transforms 
each item around itself. 


In Object Mode 


Each object gets transformed around its origin, which is a 
point that can be chosen freely and doesn’t have to be in 


the center. In the example below, the orange rectangle has 
it in a corner instead. 


Rotation around individual origins. 


The images below compare Individual Origins to Median 
Point. 


o 9 
o 9 


Starting situation, rotation around Individual Origins, 
rotation around Median Point. 


> 
o 9 
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Starting situation, scaling using Individual Origins, 
scaling using Median Point. 


In Edit Mode 


Each selected element is transformed around its own 
centerpoint. 


LILI) 


Starting situation, rotation around Individual Origins, 
rotation around Median Point. 


Starting situation, scaling using Individual Origins, 
scaling using Median Point. 


When you transform adjacent faces or edges, they are 
treated as a single element (meaning they don’t become 
disconnected). 


Median Point 


Reference 

Mode: Object Mode and Edit Mode 
Header: Pivot Point » Median Point 
Shortcut: Period 


Places the pivot point at the averaged-out position of the 
selected items. 


In Object Mode 


In Object Mode, the Median Point is the averaged-out 
position of the origins of the selected objects. The shape 
and size of the objects is not taken into account. 


Origins can be chosen freely and can even lie outside their 
object’s geometry, so that the Median Point is not always 
what you might expect. 


Median points in Object Mode. 


In Edit Mode 


In Edit Mode, the Median Point is the averaged-out position 
of the selected vertices. This means that the pivot point will 
shift towards the area with the densest geometry. 


In the example below, the pivot point lies perfectly in the 
middle if both cubes have the same number of vertices, but 
heavily leans towards the side if one cube is subdivided - 
even though both cubes still have the same size. 


Median points in Edit Mode. 


Active Element 


Reference 

Mode: Object Mode and Edit Mode 
Header: Pivot Point » Active Element 
Shortcut: Period 


Places the pivot point at the active element, which is the 
element that was selected most recently. 


In Object Mode 


When in Object Mode, rotation and scaling happen around 
the origin of the active object, which is the element with a 
lighter outline than the others. 


The effect of the pivot point is shown in the image below, 
where the active object (the cube) remains in the same 
location while the others move. 


Starting point, rotation, and scaling. 


In Edit Mode 


When in Edit Mode, rotation and scaling happen around the 
centerpoint of the active element, which is the element with 
a white outline. That centerpoint remains in the same 
location while everything else is transformed around it. 


The image below illustrates rotation around the active 
vertex, edge, and face. Each time, the active element 
rotates in place, while the others “orbit” around it. In the 
case of vertices, the active vertex is not changed at all, asa 
vertex on its own is just a point that has no concept of 
rotation. 


/ 
ae 
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Left column: starting situation, right column: after 
rotation. 


Snapping 


Reference 

Mode: Object, Edit, and Pose Mode 
Header: Snap 

Shortcut: Shift-Tab 


Snapping lets you easily align objects and mesh elements to 
others. It can be toggled by clicking the magnet icon in the 
3D Viewport’s header, or more temporarily by holding ctr. 


Magnet icon in the 3D Viewport header (blue when 
enabled). 


pt 
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Mi Face 

fg? Volume 

=» Edge Center 


= Edge Perpendicular 


Rotate Scale 


Snap menu. 


Snap To 


Reference 


Mode: Object, Edit, and Pose Mode 
Header: Snapping > Snap To 
Shortcut: Shift-Ctrl-Tab 


Determines the target which the selection will be snapped 
to. 


Increment 
Snaps to grid points. When in Orthographic view, the 
Snapping increment changes depending on the zoom 
level. 


Note 

By default, this option won’t snap to the grid that’s 
displayed in the viewport, but an imaginary grid with 
the same resolution that starts at the selection’s 
original location. In other words, it lets you move the 
selection in “increments” of the grid cell size. 


If you want to snap to the viewport grid instead, you 
can enable Absolute Grid Snap (see below). 


Vertex 
Snaps to the nearest vertex of a mesh object. 


Edge 
Snaps to the nearest point on the nearest edge. 


Face Project 
Snaps to the face by projecting the current point on the 
nearest face. This snap mode will snap geometry to both 
visible and occluded. This snap mode is useful for 
retopologizing. 


Face Nearest 


Snaps to the nearest surface in world space. This snap 
mode will only snap geometry to visible (non occluded) 
geometry. 


Volume 


Snaps to regions within the volume of the first object 
found below the mouse cursor. Unlike the other options, 
this option controls the depth (i.e. Z coordinates in 
current view space) of the transformed element. By 
toggling Snap Peel Object (see below), target objects will 
be considered as a whole when determining the volume 
center. 


Edge Center 
Snaps to the centerpoint of the nearest edge. 


Edge Perpendicular 


Snaps to a specific point on the nearest edge so that the 
line from the selection’s original location (indicated by a 
white cross) to its new location is perpendicular to that 
edge. 


Tip 


Multiple snapping modes can be enabled at once using 
Shift-LMB. 


Snap With 


Reference 


Mode: Object, Edit, and Pose Mode 


Header: Snapping > Snap with 
Shortcut: Shift-Ctrl-Tab 


Determines what part of the selection will coincide with the 
target. (The rest of the selection will follow along.) 


Active 
Snaps using the origin (in Object Mode) or center (in Edit 
Mode) of the active element. 


Median 
Snaps using the median of the selection. 


Center 
Snaps using the current transformation center (another 
word for the pivot point). This option is especially useful 
in combination with the 3D Cursor for choosing the 
Snapping point completely manually. 


Closest 
Snaps using the vertex that’s closest to the target. 


Closest. Active. Median. 


Target Selection 
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¥ Project onto Self 


Rotate Scale 


As seen in the yellow highlighted area in the image above, 
besides the snap target, additional controls are available to 
alter snap behavior. These options vary between mode 
(Object and Edit) as well as snap target. The available 
options are: 


Include Active 


Only available in Edit Mode. Allows snapping mesh 
elements to other elements of the same mesh. 


This checkbox is ignored if Proportional Editing is 
enabled. 


Include Edited Edit Mode 
Snap onto non-active objects in Edit Mode. 


Include Non-Edited Edit Mode 
Snap onto objects not in Edit Mode. 


Exclude Non-Selectable 
Snap only onto objects that are selectable. 


Absolute Grid Snap 
Only available if Snap To Increment is enabled. Snaps to 
the grid, instead of snapping in increments relative to the 
current location. 


Backface Culling 
Exclude back-facing geometry from snapping. 


Align Rotation to Target 
Rotates the selection so that its Z axis gets aligned to the 
normal of the target. 


Project Individual Elements 
Only available if Snap To Face is enabled. Rather than the 
default behavior where only the “Snap With” point gets 
Snapped to the target and the rest of the selection 
follows along (maintaining the original shape), this option 
makes each object (in Object Mode) or vertex (in Edit 
Mode) snap to a target independently of the others, 
which may cause the selection’s shape to change. 


This can be used for bending a flat sheet so it snugly fits 
against a curved surface, for example. 


See also 
Shrinkwrap Modifier 


Snap to Same Target Face Nearest 
Snap only to target that source was initially near. 


Face Nearest Steps Face Nearest 


Number of steps to break transformation into for face 
nearest snapping. This option is only available in Edit 
mode. 


Snap Peel Object 
Only available if Snap To Volume is enabled. Consider 
objects as a whole when finding volume center. 


Affect 


Specifies which transformations are affected by snapping. 
By default, snapping only happens while moving something, 
but you can also enable it for rotating and scaling. 


Multiple Snap Targets 


While you’re transforming a selection with snapping 
enabled, you can press A whenever there’s a highlighted 
Snap target to mark it. With multiple such targets marked, 
the selection will then be snapped to their average location. 


Marking a target more than once will give it more weight. 


Multiple snapping targets. 


Proportional Editing 


Reference 

Mode: Object and Edit Mode 
meacer: Proportional Editing 
Shortcut: 0 


Proportional Editing is a way 
of transforming selected 
elements while also affecting 
the nearby unselected 


J\. Smooth 

elements. The farther away REET 
an unselected element is, /\ Root 
the less it will be affected (\ Inverse Square 
(hence the “proportional”). gnltacsls 
This feature is very useful for Orion 

: r Constant 
smoothly deforming dense rae 
meshes. 
Note 


Proportional Editing popover. 


Blender also has a Sculpting 

workflow that contains 

brushes and tools for proportionally editing a mesh without 
seeing the individual vertices. 


Controls 


Disable o 


Proportional Editing is off, only selected vertices will be 
affected. 


Enable o 
Vertices other than the selected vertex are affected, 
within a defined radius. 


Influence 


You can increase or decrease the radius of the tool’s 
influence during a transform operation with wheelUp, WheelDown 
Or PageUp, PageDown respectively. AS you change the radius, 
the points surrounding your selection will adjust their 
positions accordingly. 


Influence circle. 


Falloff 


While editing, you can change the curve profile by either 
clicking the Falloff icon in the header or pressing Shift-0 to 
get a pie menu. 


Constant, Random Linear 
No Falloff. Falloff. Falloff. 


Root Sphere 
Falloff. Falloff. Falloff. 


Smooth ae 
Falloff. Falloff. 


Object Mode 


Proportional Editing is typically used in Edit Mode, but it can 
also be used in Object Mode. The tool then works on entire 
objects rather than individual mesh components. 


In the image below, the leftmost cylinder is being scaled up 
vertically, which also affects the cylinders near it. 


Proportional Editing in Object Mode. 


Edit Mode 


When working with dense geometry, it can become difficult 
to make subtle adjustments without causing visible lumps 
and creases in the model’s surface. When you face 
situations like this, Proportional Editing can help. 


Proportional Editing in Edit Mode. 


Options 


Connected Only Ait-o 
Rather than using a radius only, the proportional falloff 
spreads via connected geometry. This means that you 
can proportionally edit the vertices in a finger of a hand 
without affecting the other fingers. While the other 
vertices are physically close (in 3D space), they are far 
away following the topological edge connections of the 
mesh. The icon will have a blue center when Connected 
is active. This mode is only available in Edit Mode. 


Projected from View 


Depth along the view is ignored when applying the 
radius. 


The difference between having “Projected from 
View” disabled (left) and enabled (right). 


Example 


The image below shows the final render of a low-poly 
landscape obtained by moving up the vertices of a 
triangulated grid with Proportional Editing enabled. 


A landscape obtained via Proportional Editing. 
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Object Type Visibility 
Viewport Gizmos 
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Mesh Edit Mode 
Sculpt Mode 
Vertex Paint 
Weight Paint 
Texture Paint 
Bones 

Grease Pencil 
wport Shading 
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o Wireframe 

°o Solid 

o Material Preview 
o Rendered 


Object Type Visibility 


Reference 
Mode: All Modes 
Header: View Object Types 


This popover lets you control the visibility and selectability 
of the various object types. For example, you can hide all 
the Lights in the scene with one click. 


The settings only apply to the current 3D Viewport. Object 
types marked as unselectable can still be selected in other 
viewports and in the Outliner, for example. 


See also 


Outliner Restriction Columns for making individual objects 
invisible or unselectable across all viewports. 


Viewport Gizmos 


Reference 


Mode: All Modes 


Header: Gizmos 


Clicking the icon toggles all gizmos in the 3D Viewport. The 


dropdown button displays a popover with more detailed settings, 
which are described below. 


Viewport Gizmos 


Navigate 
Enable/disable the navigation gizmo. 


Active Tool 
Enable/disable the gizmo of the active tool. 


Active Object 
Enable/disable the Object Gizmos for the active element (see 
below). 


Object Gizmos 


Object Gizmos allow mouse-controlled translation, rotation and 
scaling in the 3D Viewport. While they’re called “object” gizmos in 
the popover, they also apply to other transformable elements such 
as mesh vertices. 


There is a separate gizmo for each operation. Each gizmo can be 
used separately or in combination with the others. 


A gizmo always has three color-coded axes: X (red), Y (green), and Z 
(blue). You can drag an axis with Ls to transform along it. The Move 


and Scale gizmos additionally have small colored squares for 
transforming along two axes in one go. 


Various modifier keys can be used: 


e Holding ctri at any time will toggle snapping and also make 
rotation and scaling work in coarse increments. 

¢ Holding Shift after pressing LmB will do the opposite of the above, 
“slowing down” the transformation relative to mouse movement 
to allow finer adjustments. 

e Holding Shift before pressing LB will perform the transformation 
in the plane that’s perpendicular to the clicked axis. See Plane 
Locking. 


The Gizmos popover has the following settings for object gizmos: 


Orientation 
The orientation to use for the gizmo. Defau/t means to use the 
viewport’s Transform Orientation. The other options override it. 


Move 
Show the gizmo to control the location. Dragging the small white 
circle allows free movement in the viewing plane. 


Rotate 
Show the gizmo to control the rotation. Dragging the large white 
circle allows rotation around the viewing direction. Dragging the 
translucent white disc within that circle (only visible when 
hovering over the gizmo) allows trackball rotation. 


Scale 
Show the gizmo to control the scale. Dragging the area between 
the small and large white circles scales along all three axes. 


The latter three options are also available in a pie menu if you have 
the Grave Accent / Tilde Action in the Keymap Preferences set to 
Gizmos. 


Note 


If you’re using a tool that’s tied to a particular gizmo setup (the 
Move, Rotate, Scale and Transform tools), the Move/Rotate/Scale 


checkboxes won’t have any effect. 


Combination. 


See also 


The Gizmo Preferences. 


Empty 
Gizmo settings for empties. 


Image 
Show the gizmo to adjust the image size and position. 


Force Field 
Show the gizmo to adjust the force field. 


Light 
Gizmo settings for lights. 


Size 
Show the gizmo to adjust the Spot Size of spotlights. 


Look At 
Show the gizmo to adjust the direction of lights. 


Camera 


Gizmo settings for cameras. 


Lens 
Show the gizmo to adjust the focal length (for Perspective 
cameras) or orthographic scale (for Orthograpic cameras). 


Focus Distance 
Enable the gizmo for adjusting the focus distance. To see this 
gizmo, you need to enable the Viewport Display » Limits 
checkbox in the camera’s properties (green camera icon). 


Viewport Overlays 


Reference 
Mode: All Modes 
Header: Overlays 


Clicking the icon toggles all overlays in the 3D Viewport. The 
dropdown button displays a popover with more detailed 
settings, which are described below. 


The available options depend on the mode that the 3D 
Viewport is in. 


Object Mode 


The following options are always present, independent of 
the current mode. Some of the overlays can be customized 
in the Viewport Preferences. 


Guides 


Grid 
Show grid in orthographic side view. 


Floor 
Show the ground plane in perspective view. 


Axis 
Show the X, Y and/or Z axis lines. 


Scale 


The distance between lines in the grid/floor. 


Subdivision 
The number of subdivisions between grid lines. 


Text Info 
Show various bits of information in the top left corner of 
the viewport. 


View Perspective 
Name of the View Perspective, such as “Top 
Orthographic” or “User Perspective.” 


Playback Frame Rate (FPS) 
Displays the Frames Per Second at which the 
animation is playing. By default, Blender goes through 
every single frame, which may result in an FPS that’s 
lower than intended (and the animation playing slower 
than realtime); the FPS turns red in this case. You can 
change this behavior in the Playback popover of the 
Timeline. 


Object Info 
Shows the current frame in parentheses, followed by 
the names of the selected Collection and the active 
object. When applicable, also shows the selected 
Shape Key and (in angle brackets) the Marker on the 
current frame. If the object has a keyframe on the 
current frame, the Object Info is displayed in yellow. 


Grid Resolution 
When the view is aligned to a world axis (See 
Viewpoint), the Text Info additionally shows the 
smallest distance between two parallel grid lines. 


Statistics 


Show information about the amount of objects and 
geometry. Note that the counters depend on the current 
selection. For example, selecting a mesh gives info on 
the number of vertices, edges, and faces, while selecting 
a light shows the number of lights in the scene. 


e Objects - Number of the selected objects and the 
total count. 

e Geometry - Displays information about the current 
scene depending on the mode and object type. This 
can be the number of vertices, faces, triangles, or 
bones. 


HDRI Preview 
Show two spheres, one glossy and one diffuse, to 
preview the HDRI that’s being used for world lighting. 
While HDRIs can be used in both the Material Preview 
and Rendered shading modes, the HDRI Preview overlay 
is only available in the former. 


3D Cursor 
Show the 3D Cursor. 


Annotations 
Show annotations. 


Objects 


Extra 
Show objects that don’t have geometry (such as empties, 
cameras and lights). 


Relationship Lines 
Show dashed lines indicating parent or constraint 
relationships. 


Outline Selected 
Show an outline around selected objects. 


Bones 
Show Bones. 


Motion Paths 
Show the motion path overlay. 


Origin 
Show the origins of the selected objects. 


Origin (All) 
Show the origins of all objects. 


Geometry 


Wireframe 
Display mesh edges. Similar to Wireframe Shading, but 
displays edges on top of existing shading. The value 
Slider adjusts which edges to display: lower values hide 
edges on surfaces that are almost flat, while a value of 1 
shows all edges. 


Opacity 
The opacity of the displayed edges, from 0 (invisible) 
to 1 (fully opaque). 


Fade Inactive Geometry 
In modes other than Object Mode, fade out objects that 
you're not working on. The slider controls how much 
they’re faded out. 


Face Orientation 
Show faces whose normal is pointing towards the camera 
in blue, and faces whose normal is pointing away from 


the camera in red. This lets you quickly check for faces 
that are oriented incorrectly: the outside surface of an 
object should typically be all blue. 


Motion Tracking 


Show the motion tracking overlay. 


Camera Path 
Show the reconstructed camera path. 


Marker Names 
Show the names for reconstructed track objects. 


Tracks 
Change the display of the reconstructed tracks: plain 
axes, arrows and So on. 


Size 
Change the display size of the reconstructed tracks. 


Mesh Edit Mode 


The following options are available when in Mesh Edit Mode. 


Edges 
Highlight selected and partially selected edges. Only 
affects vertex and face selection modes, as edges are 
always highlighted in edge selection mode. 


Faces 
Highlight selected faces. Affects all selection modes. 


Center 


Show face center points in solid shading modes. (They’re 
always shown in wireframe shading mode.) 


Only affects face selection mode. 


Creases 


Display edges marked with a crease for the Subdivision 
Surface Modifier. 


Sharp 
Display sharp edges, used with the Edge Split modifier. 


Bevel 
Display weights created for the Bevel Modifier. 


Seams 
Display the UV unwrapping seams. 


Shading 


Hidden Wire 


Show only front-facing wireframes. This is useful for a 
retopology workflow. 


Tip 
Optimally this could be combined with the X-Ray display 
setting. 


Vertex Groups Weights 
Display weights in Edit Mode. 


Zero Weights 


Display unreferenced and zero-weighted areas in 
black. This helps to identify areas with very low 


weights that have been painted onto. 


None 
Vertices are displayed in the usual way. 


Active 
Vertices are shown in black if they have no weight 
in the active vertex group. 


All 
Vertices are shown in black if they have no weight 
in any vertex group. 


Mesh Analysis 
Show the Mesh Analysis overlay. 
Measurement 


Show numerical measures of the selected elements. The 
Units can be set in the Scene properties. 


Edge Length 
Show the length of selected edges. 


Edge Angle 
Show the angle of selected edges between two faces. 


Face Area 
Show the area of selected faces. 


Face Angle 
Show the angle of selected face corners. 


Tip 


Geometry connected to the selection is shown while 
transforming, allowing you to move a vertex and see the 
connected edge lengths for example. 


Note 


These values respect the Transform Space in the Sidebar. 
Use Global if you want the object’s scale to be applied to 
the measurements. 


See also 


The Measure tool for measuring arbitrary distances and 
angles. 


Normals 


e Display vertex normals 
e Display face normals at vertices (split normals) 
e Display face normals 


Size 
The size to show the selected normals. 
Constant Screen Size Normals 


Keep the size of normals constant in relation to the 
zoom level. 


Developer 


These overlays are only available if Developer Extras is 
enabled in the Interface Preferences. 


Indices 
Display the indices of selected vertices, edges, and 
faces. 


Freestyle 


These settings apply to the Freestyle line art renderer. 


Edge Marks 
Display Freestyle edge marks. 


Face Marks 
Display Freestyle face marks. 


Sculpt Mode 


Mask 
Show Masks as overlays on an object. The opacity of the 
overlay can be adjusted. 


Face Sets 
Show Face Sets as overlays on an object. The opacity of 
the overlay can be adjusted. 


Vertex Paint 


Stencil Mask Opacity 
Does nothing. (Stencil masks are only available for 
texture painting.) 


Show Wire 
Display mesh edges in white (unlike the Wireframe 
overlay which shows them in black). 


Weight Paint 


Opacity 
The opacity of the overlay. 


Zero Weights 
Display unreferenced and zero-weighted areas in black. 
This helps to identify areas with very low weights that 
have been painted onto. 


None 
Vertices are displayed in the usual way. 


Active 
Vertices are shown in black if they have no weight in 
the active vertex group. 


All 
Vertices are shown in black if they have no weight in 
any vertex group. 


Show Weight Contours 


Show contour lines formed by points with the same 
interpolated weight. 


This visualizes weight variations too small to be seen 
from colors and can be useful for judging the smoothness 
and consistency of gradients, e.g. when using smoothing 
tools and brushes. 


Show Wire 
Display mesh edges in white (unlike the Wireframe 
overlay which shows them in black). 


Texture Paint 


Stencil Mask Opacity 
Opacity of the stencil mask overlay. 


Bones 


Fade Geometry 
Show the bones on top and face other geometry to the 
back. The opacity can be controlled with the slider. Only 
available in Pose Mode. 


Bone Wireframe Opacity 
The maximum opacity used for bones drawn in the 
Wireframe shading mode (or in Solid shading mode with 
X-Ray active). This is helpful when it is necessary to 
reduce clutter and focus on the mesh rather than bones. 


Grease Pencil 


Onion Skin 
Show ghosts of the keyframes before and after the 
current frame. If Multiframe is enabled, ghosts of the 
selected keyframes are shown instead. See Onion 
Skinning. 


Canvas 
Display a grid over the Grease Pencil drawing plane. The 
opacity of the grid can be controlled with the slider. 
When using the Canvas X-Ray option, objects are drawn 
behind the canvas grid. 


Fade Inactive Layers 
Decrease the opacity of all the layers in the object other 
than the active one. The opacity factor can be controlled 
with the slider. 


Fade Inactive Objects 


Cover all of the viewport except the active Grease Pencil 
object with a full color layer to improve visibility while 
drawing over complex scenes. 


Fade Grease Pencil Objects 
Include or exclude Grease Pencil objects. 


Edit Lines 
Show edit lines in Edit Mode. 


Only in Multiframe 
When Multiframe is enabled and keyframes other than 
the current frame are selected, strokes on those 
keyframes are displayed as just their edit lines - the 
strokes themselves are hidden. Note that this does not 
affect Onion Skinning. 


Stroke Direction 


Toggle the display of the selected strokes’ start points 
(green) and end points (red) to visualize their direction. 


Material Name 
Show material name next to the selected strokes. 


Vertex Opacity 
Opacity for vertices (points) and edit lines in Edit Mode. 


Vertex Paint Opacity 
The opacity of the vertex color overlay in Vertex Paint 
Mode and Draw Mode. Note that in Draw Mode, vertex 
paint is only visible in the Material Preview and Rendered 
Shading modes by default. To see it in Solid mode, you 
either need to use Vertex Paint Mode, or set the Color 
shading setting to Attribute. 


Handles 
When Curve Editing is active, this option controls how 
curves are displayed in the 3D Viewport. 


None: No handles are displayed, only the 
control points. 
Selected: Only handles for selected control points 


are displayed. 
All: All the handles are displayed. 


Viewport Shading 


Reference 

Mode: All Modes 

Header: SLES Viewport Shading 
Shortcut: Z Shift-Z 


Blender offers different shading modes for helping with 
different tasks. For example, Solid shading is well-suited for 
modeling, while Rendered is useful for setting up lighting. 


The radio buttons let you change the shading mode, while 
the dropdown button opens a popover with additional 
options described below. 


Pressing Z opens a pie menu for changing the shading 
mode. Pressing Shift-Z switches between the current 
shading mode and Wireframe. 


Wireframe 


Only displays the edges (wireframes) of the objects in the 
scene. 


Color 
Single 
All objects get shaded using the same single color. 


Object 
Use the color from the object’s Viewport Display 
settings. 


Random 
Each object gets displayed in a random color. 


Background 
How the background is displayed in the 3D Viewport. 


Theme 
Use the background of the theme. This can be 


configured in the Themes Preferences under 3D 
Viewport >» Theme Space » Gradient Colors. 


World 
Use the color from the World’s Viewport Display 


options. 


Viewport 
Select a custom color for the background of the 3D 


Viewport. 


Options 
X-Ray Alt-Z 
Make objects transparent, allowing you to see and 
select items that would otherwise be occluded. The 
slider controls object opacity. 


Outline 
Draw an outline around objects. The color of the 


outline can be adjusted. 


Solid 


This mode utilizes the Workbench Render Engine to render 
the 3D Viewport. It shows solid geometry but uses simplified 
Shading and lighting without the use of shader nodes. Solid 
mode is good for modeling and sculpting, and is really 


useful with the multitude of options to emphasize certain 


geometric features. 


Lighting 


How lights are computed. 


Flat: 


Studio: 


MatCap: 


Color 


Do not calculate any lighting. The base 
color of the scene will be rendered. 


Use studio lights to light the objects. 
The studio lights can be configured in 
the preferences. Studio lights can 
follow the camera or be fixed. When 
fixed the angle of the lights can be 
adjusted. 
World Space Lighting 
Uses world space lighting so lights 
do not follow the view camera. 
Rotation 
The rotation of the studio lights on 
the Z axis. 


Use a material capture to light the 
objects in the scene. MatCaps can be 
flipped horizontally by clicking the Flip 
MatCap button. 

Custom MatCaps can be Joaded in the 
preferences. 


The source to compute the color for objects in the 


viewport. 


Material: 


Object: 


Use the color that can be set per 
material in the Viewport Display 
Material panel. 


Use the color that can be set per object 
in the Viewport Display Object panel. 
Attribute: Display the active Color Attribute of an 
object. When an object has no active 
Color Attribute it will be rendered in the 
color set in the Viewport Display Object 


panel. 

Single: Render the whole scene using a single 
color. The color can be chosen. 

Random: A random color will be selected for 
every object in the scene. 

Texture: Show the texture from the active image 


texture node using the active UV map 
coordinates When an object has no 
active texture the object will be 
rendered with the settings in the 
Viewport Display Material panel. 


Background 
How the background is displayed in the 3D Viewport. 


Theme: Use the background of the theme. This 
can be configured in the Themes 
Preferences under 3D Viewport > 
Theme Space > Gradient Colors. 


World: Use the color from the World’s Viewport 
Display options. 
Viewport: Select a custom color for the 


background of the 3D Viewport. 
Options 


Backface Culling 
Use backface culling to hide backsides of faces. 


X-Ray 


Render the scene transparent. With the slider you can 
control how transparent the scene should appear. 


Shadow 
Renders a sharp shadow in the scene. 


Darkness 
Defines how dark the shadow should be rendered. 
This slider can be adjusted between 0 (shadow not 
visible) and 1 (shadow is black). 


Light Direction 
Controls the direction of the light source that casts the 


shadows. 


Shadow Shift 
Controls the Shadow termination angle. It can be used 
to limit self shadowing artifacts. 


Shadow Focus 
Controls the falloff near the edge of the shadow. 


Cavity 
Highlight ridges and valleys in the scene geometry. 
Type 
Method how to calculate the cavity. 
World: More precise but is slower to 
calculate. 
Screen: Fast but does not take the size of 
the ridges and valleys into account. 
Both: Both will use both methods. 
Ridge 


Control the visibility of ridges. 


Valley 
Control the visibility of valleys. 


Depth of Field 
Use the Depth of Field settings of the active camera in 
the viewport. Only visible when looking through the 
camera. 


The settings are located on Properties » Camera >» Depth 
of Field panel. 


Outline 
Render the outline of objects in the viewport. The color of 
the outline can be adjusted. 


Specular Highlighting 
Render specular highlights. 


Note 

Only available when Lighting is set to Studio lighting or 
when a MatCap has been selected that contains a 
specular pass. 


Material Preview 


Render the 3D Viewport with Eevee and an HDRI 
environment. This mode is particularly suited for previewing 
materials and painting textures. You can select different 
lighting conditions to test your materials. 


Note 


The Material Preview shading mode is not available when 
the scene’s render engine is set to Workbench. 


Lighting 
Scene Lights 
Use the lights in the scene. When disabled (or when 
the scene contains no lights), a virtual light is used 
instead. 


Scene World 
Use the World of the scene. When disabled, a world 
will be constructed with the following options: 


HDRI Environment 
The environment map used to light the scene. 


Rotation 
The rotation of the environment on the Z axis. 


World Space Lighting 
Makes the lighting rotation fixed and not follow 
the camera. 


Strength 
Light intensity of the environment. 


World Opacity 
Opacity of the HDRI as a background image in the 
viewport. 


Blur 
Factor to unfocus the HDRI. Note that this does not 
change the diffusion of the lighting, only the 
appearance of the background. 


Render Pass 
Instead of the combined render, show a specific render 
pass. Useful to analyze and debug geometry, materials 
and lighting. 


Rendered 


Render the 3D Viewport using the scene’s Render Engine, 
for interactive rendering. This gives you a preview of the 
final result, including scene lighting effects. 


The options are the same as for Material Preview, except 
that the Render Pass selector will offer different passes if 
the scene uses the Cycles render engine. 


Toolbar 


The Toolbar contains a list of tools. Links to each mode’s 
Toolbar are listed below. 


Object Mode 


e Object Mode 


Edit Mode 


e Mesh Edit Mode 

e Curve Edit Mode 

e Surface Edit Mode 
e Metaball Edit Mode 


Paint Modes 


Sculpt Mode 

Texture Paint Mode 
Vertex Paint Mode 
Weight Paint Mode 


Grease Pencil 


Grease Pencil Edit 

Grease Pencil Draw 
Grease Pencil Sculpting 
Grease Pencil Weight Paint 


Measure 


Reference 
Mode: All Modes 
Tool: Toolbar » Measure 


The Measure tool is an interactive tool where you can drag 
lines in the scene to measure distances or angles. Snapping 
to geometry could be activated for better accuracy or to 


measure wall thickness. The Measure tool can be accessed 
from the Toolbar. 


>» 3D Cursor 
> Collections 


Y Annotations 


§S~¥ Annotations 


RulerData3D 


> 
Thickness 


>» Geoscene 


Examples of the Measure tool. 
Usage 


Here are some common steps for using the Measure tool: 


1. Activate the Measure tool from the Toolbar. 


2. Click and drag in the viewport to define the initial start 
and end point for the ruler. You can add multiple rulers 
in the viewport. 


3. Drag either end of the ruler to move it. 


o Holding ctrt while moving enables snapping to 
edges and vertices. 

o Holding Shift while moving lets you measure the 
distance between faces. This only works well with 
parallel faces, e.g. walls. 


You can always navigate (pan, zoom, ...) or change the 
view (orthogonal, perspective) in the viewport to have 
better access to the ruler. 


4. Click on the midpoint of a created ruler to convert it toa 
protractor. The midpoint can then be dragged just like 
the endpoints. 


5. A selected ruler can be deleted with Delete or x. To 
delete all measurements, delete the “RulerData3D” 
layer in the Sidebar > View >» Annotations panel (see 
image above). 


All measurements are hidden when another tool is selected. 
They are shown when the Measure tool is selected again. 
However, you can do editing operations while the ruler is 
active. For example, you can edit the rotation or scale of the 
selected object in the Sidebar. 


Measurements do not appear in the Render output. 


Unit settings and scale from the scene are used for 
displaying dimensions. Changing the unit system (metric, 
imperial), or the units of length (cm, m, ...) or angle 
(degrees, radians) will update the measurements. 


Tip 


In Edit Mode only, there is also a Measurement group in 
the Viewport Overlays popover. Using the settings in this 
group, you can have the viewport automatically display 
measurements for selected edges and faces, without the 
need to manually create a ruler. 


Add Cube 


Reference 
Mode: Object Mode and Edit Mode 
Tool: Toolbar >» Add Cube 


Interactively add a cube mesh object. 


Usage 


First define the base of the object by dragging with LB. 
Next, release LMB and move the mouse to define the height 
of the object. Finally, click LMB to confirm the shape of the 


object. 

You can use the following hotkeys to temporarily change a 
setting (for as long as the key is held): 

Ctrl Toggles snapping. 


Alt Toggles the Origin setting. 


Shift Toggles the Aspect setting. 


Tool Settings 


Depth 


The initial depth (from the screen into the scene) used 
when placing the object. 


Surface: Start placing on the surface under the 
mouse cursor. If there is no surface, 
this does the same as Cursor Plane. 

Cursor Plane: Start placing on a plane that goes 
through the 3D Cursor and is aligned 
according to the Orientation and Plane 
Axis. 

Cursor View: Start placing on a plane that goes 
through the 3D Cursor and is aligned to 
the view. 


Orientation 
The new object’s orientation - a set of three axes, out of 
which Plane Axis chooses one. 


Surface: The object uses the normal orientation 
of the surface under the mouse cursor. 
If there is no surface, this does the 
same as Default. 


Default: The object uses the default Transform 
Orientation. 
Snap To 
The target to use while Snapping. 
Geometry: Snap to all types of geometry (vertices, 
edges, and faces). 
Default: Snap to the target defined in the global 


Snapping options. 


Plane Axis 
Which of the three Orientation axes (X, Y or Z) is “up” for 
the object. The object’s base will be perpendicular to this 
axis. 


Auto Axis 
Rather than using the Orientation axis indicated by Plane 
Axis, use the one that’s closest to the viewport’s viewing 
direction (when not hovering over a surface). 


Base 
Origin 
How the base is defined. 
Edge: The base is defined from one corner to 
the opposing corner. 
Center: The base is defined from the 
centerpoint to a corner. 
Aspect 
Whether the base has a free or fixed aspect ratio. 
Free: The width and depth of the base can be 
chosen independently. 
Fixed: The width and depth of the base are 
forced to be equal. 
Height 
Origin 
How the height is defined. 
Edge: The base becomes the bottom, after 
which you define the top. 
Center: The base becomes the center, after 


which you define the top. 


Aspect 
Whether the object’s side has a free or fixed aspect ratio. 


Free: The height can be chosen 
independently of the base. 

Fixed: The height is forced to be equal to the 
largest side of the base. 


Add Cone 


Reference 
Mode: Object Mode and Edit Mode 
Tool: Toolbar » Add Cone 


Interactively add a cone mesh object. 


Usage 


First define the base of the object by dragging with LB. 
Next, release LMB and move the mouse to define the height 
of the object. Finally, click LMB to confirm the shape of the 


object. 

You can use the following hotkeys to temporarily change a 
setting (for as long as the key is held): 

Ctrl Toggles snapping. 


Alt Toggles the Origin setting. 


Shift Toggles the Aspect setting. 


Tool Settings 


Depth 


The initial depth (from the screen into the scene) used 
when placing the object. 


Surface: Start placing on the surface under the 
mouse cursor. If there is no surface, 
this does the same as Cursor Plane. 

Cursor Plane: Start placing on a plane that goes 
through the 3D Cursor and is aligned 
according to the Orientation and Plane 
Axis. 

Cursor View: Start placing on a plane that goes 
through the 3D Cursor and is aligned to 
the view. 


Orientation 
The new object’s orientation - a set of three axes, out of 
which Plane Axis chooses one. 


Surface: The object uses the normal orientation 
of the surface under the mouse cursor. 
If there is no surface, this does the 
same as Default. 


Default: The object uses the default Transform 
Orientation. 
Snap To 
The target to use while Snapping. 
Geometry: Snap to all types of geometry (vertices, 
edges, and faces). 
Default: Snap to the target defined in the global 


Snapping options. 


Plane Axis 
Which of the three Orientation axes (X, Y or Z) is “up” for 
the object. The object’s base will be perpendicular to this 
axis. 


Auto Axis 
Rather than using the Orientation axis indicated by Plane 
Axis, use the one that’s closest to the viewport’s viewing 
direction (when not hovering over a surface). 


Base 
Origin 
How the base is defined. 
Edge: The base is defined from one corner to 
the opposing corner. 
Center: The base is defined from the 
centerpoint to a corner. 
Aspect 
Whether the base has a free or fixed aspect ratio. 
Free: The width and depth of the base can be 
chosen independently. 
Fixed: The width and depth of the base are 
forced to be equal. 
Height 
Origin 
How the height is defined. 
Edge: The base becomes the bottom, after 
which you define the top. 
Center: The base becomes the center, after 


which you define the top. 


Aspect 
Whether the side of the bounding box has a free or fixed 
aspect ratio. 


Free: The height can be chosen 
independently of the base. 

Fixed: The height is forced to be equal to the 
largest side of the base. 


Vertices 
The number of vertices in the base. 


Base Fill Type 
Set how the circle at the base will be filled. 


Triangle Fan: — Fill with triangular faces which share a 
vertex in the middle. 

N-gon: Fill with a single N-gon. 

Nothing: Do not fill. Creates only the outer ring 
of vertices. 


Add Cylinder 


Reference 
Mode: Object Mode and Edit Mode 
Tool: Toolbar » Add Cylinder 


Interactively add a cylinder mesh object. 


Usage 


First define the base of the object by dragging with LB. 
Next, release LMB and move the mouse to define the height 
of the object. Finally, click LMB to confirm the shape of the 


object. 

You can use the following hotkeys to temporarily change a 
setting (for as long as the key is held): 

Ctrl Toggles snapping. 


Alt Toggles the Origin setting. 


Shift Toggles the Aspect setting. 


Tool Settings 


Depth 


The initial depth (from the screen into the scene) used 
when placing the object. 


Surface: Start placing on the surface under the 
mouse cursor. If there is no surface, 
this does the same as Cursor Plane. 

Cursor Plane: Start placing on a plane that goes 
through the 3D Cursor and is aligned 
according to the Orientation and Plane 
Axis. 

Cursor View: Start placing on a plane that goes 
through the 3D Cursor and is aligned to 
the view. 


Orientation 
The new object’s orientation - a set of three axes, out of 
which Plane Axis chooses one. 


Surface: The object uses the normal orientation 
of the surface under the mouse cursor. 
If there is no surface, this does the 
same as Default. 


Default: The object uses the default Transform 
Orientation. 
Snap To 
The target to use while Snapping. 
Geometry: Snap to all types of geometry (vertices, 
edges, and faces). 
Default: Snap to the target defined in the global 


Snapping options. 


Plane Axis 
Which of the three Orientation axes (X, Y or Z) is “up” for 
the object. The object’s base will be perpendicular to this 
axis. 


Auto Axis 
Rather than using the Orientation axis indicated by Plane 
Axis, use the one that’s closest to the viewport’s viewing 
direction (when not hovering over a surface). 


Base 
Origin 
How the base is defined. 
Edge: The base is defined from one corner to 
the opposing corner. 
Center: The base is defined from the 
centerpoint to a corner. 
Aspect 
Whether the base has a free or fixed aspect ratio. 
Free: The width and depth of the base can be 
chosen independently. 
Fixed: The width and depth of the base are 
forced to be equal. 
Height 
Origin 
How the height is defined. 
Edge: The base becomes the bottom, after 
which you define the top. 
Center: The base becomes the center, after 


which you define the top. 


Aspect 
Whether the side of the bounding box has a free or fixed 
aspect ratio. 


Free: The height can be chosen 
independently of the base. 

Fixed: The height is forced to be equal to the 
largest side of the base. 


Vertices 
The number of vertices in the caps. 


Cap Fill Type 
Set how the caps will be filled. 


Triangle Fan: _ Fill with triangular faces which share a 
vertex in the middle. 

N-gon: Fill each ring with an N-gon. 

Nothing: Do not fill. Creates only the outer rings 
of vertices. 


Add UV Sphere 


Reference 
Mode: Object Mode and Edit Mode 
Tool: Toolbar » Add UV Sphere 


Interactively add a UV sphere mesh object. 


Usage 


First define the base of the object by dragging with LB. 
Next, release LMB and move the mouse to define the height 
of the object. Finally, click LMB to confirm the shape of the 


object. 

You can use the following hotkeys to temporarily change a 
setting (for as long as the key is held): 

Ctrl Toggles snapping. 


Alt Toggles the Origin setting. 


Shift Toggles the Aspect setting. 


Tool Settings 


Depth 


The initial depth (from the screen into the scene) used 
when placing the object. 


Surface: Start placing on the surface under the 
mouse cursor. If there is no surface, 
this does the same as Cursor Plane. 

Cursor Plane: Start placing on a plane that goes 
through the 3D Cursor and is aligned 
according to the Orientation and Plane 
Axis. 

Cursor View: Start placing on a plane that goes 
through the 3D Cursor and is aligned to 
the view. 


Orientation 
The new object’s orientation - a set of three axes, out of 
which Plane Axis chooses one. 


Surface: The object uses the normal orientation 
of the surface under the mouse cursor. 
If there is no surface, this does the 
same as Default. 


Default: The object uses the default Transform 
Orientation. 
Snap To 
The target to use while Snapping. 
Geometry: Snap to all types of geometry (vertices, 
edges, and faces). 
Default: Snap to the target defined in the global 


Snapping options. 


Plane Axis 
Which of the three Orientation axes (X, Y or Z) is “up” for 
the object. The object’s base will be perpendicular to this 
axis. 


Auto Axis 
Rather than using the Orientation axis indicated by Plane 
Axis, use the one that’s closest to the viewport’s viewing 
direction (when not hovering over a surface). 


Base 
Origin 
How the base is defined. 
Edge: The base is defined from one corner to 
the opposing corner. 
Center: The base is defined from the 
centerpoint to a corner. 
Aspect 
Whether the base has a free or fixed aspect ratio. 
Free: The width and depth of the base can be 
chosen independently. 
Fixed: The width and depth of the base are 
forced to be equal. 
Height 
Origin 
How the height is defined. 
Edge: The base becomes the bottom, after 
which you define the top. 
Center: The base becomes the center, after 


which you define the top. 


Aspect 


Whether the side of the bounding box has a free or fixed 
aspect ratio. 


Free: The height can be chosen 
independently of the base. 

Fixed: The height is forced to be equal to the 
largest side of the base. 


Segments 


Number of vertical segments. Like the Earth’s meridians, 
going pole to pole. 


Rings 
Number of horizontal segments. These are like the 
Earth’s parallels. 
Note 


Rings are face loops and not edge loops, which would 
be one less. 


Add Icosphere 


Reference 
Mode: Object Mode and Edit Mode 
Tool: Toolbar » Add Icosphere 


Interactively add an Icosphere mesh object. 


Usage 


First define the base of the object by dragging with LB. 
Next, release LMB and move the mouse to define the height 
of the object. Finally, click LMB to confirm the shape of the 


object. 

You can use the following hotkeys to temporarily change a 
setting (for as long as the key is held): 

Ctrl Toggles snapping. 


Alt Toggles the Origin setting. 


Shift Toggles the Aspect setting. 


Tool Settings 


Depth 


The initial depth (from the screen into the scene) used 
when placing the object. 


Surface: Start placing on the surface under the 
mouse cursor. If there is no surface, 
this does the same as Cursor Plane. 

Cursor Plane: Start placing on a plane that goes 
through the 3D Cursor and is aligned 
according to the Orientation and Plane 
Axis. 

Cursor View: Start placing on a plane that goes 
through the 3D Cursor and is aligned to 
the view. 


Orientation 
The new object’s orientation - a set of three axes, out of 
which Plane Axis chooses one. 


Surface: The object uses the normal orientation 
of the surface under the mouse cursor. 
If there is no surface, this does the 
same as Default. 


Default: The object uses the default Transform 
Orientation. 
Snap To 
The target to use while Snapping. 
Geometry: Snap to all types of geometry (vertices, 
edges, and faces). 
Default: Snap to the target defined in the global 


Snapping options. 


Plane Axis 
Which of the three Orientation axes (X, Y or Z) is “up” for 
the object. The object’s base will be perpendicular to this 
axis. 


Auto Axis 
Rather than using the Orientation axis indicated by Plane 
Axis, use the one that’s closest to the viewport’s viewing 
direction (when not hovering over a surface). 


Base 
Origin 
How the base is defined. 
Edge: The base is defined from one corner to 
the opposing corner. 
Center: The base is defined from the 
centerpoint to a corner. 
Aspect 
Whether the base has a free or fixed aspect ratio. 
Free: The width and depth of the base can be 
chosen independently. 
Fixed: The width and depth of the base are 
forced to be equal. 
Height 
Origin 
How the height is defined. 
Edge: The base becomes the bottom, after 
which you define the top. 
Center: The base becomes the center, after 


which you define the top. 


Aspect 


Whether the side of the bounding box has a free or fixed 
aspect ratio. 


Free: The height can be chosen 
independently of the base. 

Fixed: The height is forced to be equal to the 
largest side of the base. 


Subdivisions 
Influences how many vertices are used to define the 
sphere. At level 1 the icosphere is an icosahedron, a solid 
with 20 equilateral triangular faces. Each increase in the 
number of subdivisions splits each triangular face into 
four. 


Note 

Subdividing an icosphere raises the vertex count very 
quickly even with few iterations (10 times creates 
5,242,880 triangles). Adding such a dense mesh is a 
sure way to cause the program to crash. 


Sidebar 


litem 


Shows Iransform settings of the active object. 


Tool 


Shows settings of the active tool and Workspace. 
View 
View Panel 


The View panel lets you change other settings regarding the 
3D Viewport. 


Focal Length 
Control the focal length of the 3D Viewport camera. 


Clip Start/End 
Adjust the minimum and maximum distances for 
geometry to be visible. Geometry closer than Start or 
further away than End will not be shown. 


Note 


In Orthographic view, the viewport uses negative End 
instead of Start. 


Warning 


A large clipping range will allow you to see both near 
and far objects, but reduces the depth precision 
resulting in artifacts. 


In some cases, a very large range may cause 
operations that depend on the depth buffer to become 
unreliable, although this depends on the graphics card 
and drivers. 


See Troubleshooting Depth Buffer Glitches for more 
information. 


Local Camera 
Allow this 3D Viewport to have its own active camera, 
separate from the global active camera that’s defined in 
the scene. The selector next to the checkbox lets you 
choose this camera. 


Render Region 
Use the Render Region. Defining the region with ctri-B 
will automatically enable this option. 


Note that if you’re viewing the scene through the active 
camera, this option has no effect - in this case, you 
instead need to use the checkbox Output Properties » 
Format >» Render Region in the Properties editor. This will 
affect not just the viewport, but also the final render. 


View Lock 
Lock to Object 


Lets you select an object to become the point of interest 
of the viewpoint. The view will then orbit around, and 


zoom towards, that object. This option is not available 
when viewing the scene through the active camera. 


Lock: To 3D Cursor 
Makes the 3D Cursor the point of interest of the 
viewpoint. This option is only available when Lock to 


Object is not active. 


Lock: Camera to View 
When looking through a camera, the camera becomes 
“glued” to the view and will follow it around as you 
navigate. The camera frame will be outlined with a red 


dashed line. 


Hint 


If the camera is parented to an object, you can choose to 
enable Camera Parent Lock in the camera’s properties. 
This will cause viewport navigation to transform the 
Camera's root parent rather than the camera itself. 


3D Cursor 


Location 
The location of the 3D Cursor. 


Rotation 
The rotation of the 3D Cursor. 


Rotation Mode 
The rotation mode of the 3D Cursor. 


Collections 


The Collections panel shows a list of collections and can be 
used to control their visibility. If a collection contains 
objects, there is a circle to the left of its name. 


Local Collections 
Allows setting collection visibility per viewport rather 
than globally. 


Hide in Viewport (eye icon) 
Shows or hides the collection. 


You can also “isolate” a collection by clicking its name. This 
will show the collection as well as its ancestors and 
descendants, and hide all other collections. 


Annotations 


See Annotations for more information. 


# 


Viewport Render 


Viewport rendering lets you create quick preview renders 
from the current viewpoint (rather than from the active 
camera, as would be the case with a regular render). 


You can use Viewport Render to render both images and 
animations. 


Below is a comparison between the Viewport render and a 
final render using the Cycles Renderer. 


Model by © 2016 pokedstudio.com 


Viewport 
Viewport render 
render using Full 
using Solid Material render. 
Mode. Preview 

Mode. 


Note 


Viewport rendering only works for the Workbench and 
Eevee render engines. It’s not supported for Cycles. 


Tip 


Disable overlays to get a render without “clutter” like rigs, 
empties and so on. 


Settings 


For the most part, Viewport Render uses the current 
viewport settings. Some settings are located in the 
properties of the render engine that is used to render the 
view. 


Solid mode uses the render settings of Workbench; Material 
Preview mode uses the render settings of Eevee. 


Additionally, some output settings are used too: 


e Resolution 
e Aspect 

e Output path 
e File format 


Rendering 


Activating Viewport Render will render from the current 
active view. This means that if you are not in an active 
camera view, a virtual camera is used to match the current 
perspective. To get an image from the camera point of view, 
enter the active camera view with Numpado. 


As with a normal render, you can abort it with Esc. 


Render a Still Image 


To render a still image, use 3D Viewport > View > 
Viewport Render Image. 


Render an Animation 


To render an animation, use 3D Viewport > View » 
Viewport Render Animation. 


Render Keyframes 


To render an animation, but only those frames that have 
a keyframe, use 3D Viewport > View > Viewport Render 
Keyframes. This only renders those frames for which the 
selected objects have an animation key. The other frames 
are still written to the output, but will simply repeat the 
last-rendered frame. 


For example, when a six-frame animation is rendered, 
and the selected objects have a key on frames 3 and 5, 
the following frames will be output: 


1. 
2. 


a. 
. The 3rd frame is repeated because there is no key on 


Tip 


The 1st frame is always rendered. 

The 1st frame is repeated because there is no key on 
this frame. 

The 3rd frame is rendered. 


this frame. 


. The 5th frame is rendered. 
. The 5th frame is repeated because there is no key on 


this frame. 


You can limit the viewport render to a particular region 
with Render Regions. 


Image Editor 
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Reload 

Edit Externally 
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Pack 

Unpack 

Extract Palette 
Generate Grease Pencil 


Introduction 


The Image Editor is where you can view/edit 2D assets like 
images or textures. 


(C tm x 
Vv 2 


¥ Image 
Source Generated 


512 
¥ 512 
Float Buffer 
Type Blank 
UV Grid 
Color Grid 


» Metadata 


Image Editor with a test grid texture. 


Toolbar 


Sample Tool 
Used to sample a pixel’s color from anywhere within 
Blender. 


Sample Size 
The dimensions of the square used to sample 
underlying pixels. If larger than 1 the resulting sample 
Is an average of all underlying pixels. 


Annotate 
See Annotations for more information. 


Header 


Mode 
View: Displays Images. 
Paint: Texture Paint. 
Mask: Masking. 

View 


Tools for controlling how the content is displayed in the 
editor. See Navigating. 


Image 
Tools for opening and manipulating images. See Editing. 


Image 
A data-block menu used for selecting images. When an 
image has been loaded or created in the Image editor, 
the Image panel appears in the Sidebar region. See 
Image Settings. 


e Render Result 
e Viewer Node 
Image Pin 
Todo. 


Slot 
You can save successive renders into the render buffer by 
selecting a new slot before rendering. If an image has 
been rendered to a slot, it can be viewed by selecting 
that slot. Empty slots appear as blank grids in the Image 
editor. Use the J and Alt-J to cycle forwards and 
backwards through saved renders. Alternatively you can 
use the number keys 1, 2, 3, etc, to select the slot with 
the corresponding number. A slot can be renamed by 
double clicking its name in the Image panel in the 
Sidebar. 


View Layer 
If you are using View Layers, use this menu to select 
which layer is displayed. 


Render Pass 
If you are using Render Passes, use this menu to select 
which pass is displayed. 


Viewport Gizmos 
Selectively show or hide specific gizmo controls that are 
displayed in the 2D viewport. 
All gizmos can be hidden or shown at once with the 
toggle next to the pop-over arrow. 


Navigate 
Enable/disable the gizmos used to pan or zoom the 2D 
viewport, see Navigation Gizmos for more information. 


Display Channels 
Select what color channels are displayed. 


Color and Alpha: 
Replaces transparent pixels with 
background checkerboard, denoting 
the alpha channel. 


Color: Display the colored image, without 
alpha channel. 
Alpha: Displays the Alpha channel a grayscale 


image. White areas are opaque, black 
areas have an alpha of 0. 

Z-Buffer: Display the depth from the camera, 
from Clip Start to Clip End, as specified 
in the Camera settings. 

Red, Green, Blue: 

Single Color Channel visualized as a 
grayscale image. 


Main View 


When LB / RMB dragging mouse the color under the cursor is 
shown in the footer as well the cursor position and the color 
values in the RGBA, HSV and Luminance Color Model. 


Navigating 


Panning can be done by clicking the mB and dragging. 


Zooming can be done by scrolling wheel up or down. Also, as 
in the 3D Viewport, you Can USe NumpadPlus Or NumpadMinus to 
ZOOM. 


Gizmos 


Next to the Sidebar region at the top, there are gizmos that 
allow panning and zooming more comfortably when e.g. no 
mouse wheel is available. 


View Menu 


Region Controls 
Adjust which regions are visible in the Image editor. 


Update Automatically 
Update the view in multiple areas. 


Show Metadata 
Displays the metadata if they were set in the render tab’s 
Metadata panel. 


Display Texture Paint UVs 
Toggles UVs in Paint Mode. 


Zoom In/Out wheel 
Adjusts the zoom level. 


Fractional Zoom 
e Zoom 1:8 Numpads8 
¢ Zoom 1:4 Numpad4 
e ZOOM 1:2 Numpad2 
¢ Zoom 1:1 Numpad1 
e ZOOM 2:1 Shift-Numpad2 
¢ Zoom 4:1 Shift-Numpad4 
e Zoom 8:1 Shift-Numpad8 
Frame All Home 
Center the view to the entire image. 


Frame All Fit Shift-Home 
Fit the view to the image dimensions. 


Center View to Cursor 
When the 2D cursor is visible, move the view so that it is 
at the center of the editor. 


Render Region Ctrl-B 
See Render Region. 


Clear Render Region Ctrt-Alt-B 
See Render Region. 


Area 
Adjust the area the Image editor is in. 


Sidebar 


Tool 


Displays the settings of the active tool. 
Image 

Image 

Tools for working with images, see Image Settings. 


Metadata 


Lists image metadata. 


View Tab 


Display 
You can set the editors display options in this panel. 
Aspect Ratio Y Display 


Display Aspect for this image. Aspect Ratio X 1.00 
Does not affect rendering. Y 1.00 


Repeat Image 


Repeat Image 
Duplicate the image until it is 


repeated to fill the main view. Display panel. 


Annotations 


Options for the annotation tool. See Annotations. 


Scopes 


Y Histogram 


Lum RGB 


¥ Waveform 


Waveform Opaci: 0.300 


¥ Vectorscope 
Vectorscope Opacity 0.300 


¥ Sample Line 


Sample Line 


ull, 


Lum RGB R G B A 


Scopes in the Image editor. 


Histogram 


This mode displays a graph showing the distribution of color 
information in the pixels of the currently displayed image. 
The X axis represents values of pixel, from 0 to 1 (or 0 to 
255), while the Y axis represents the number of pixels in 
that tonal range. A predominantly dark image would have 
most of its information toward the left side of the graph. 


Use this mode to balance out the tonal range in an image. A 
well-balanced image should have a nice smooth distribution 
of color values. 


Luma 
Shows the luminosity of an image. 


RGB 


R/G/B/A 
Depending on the channel you choose the scope will 
show the appropriate channel. 


Show Line 
Displays lines rather than filled shapes. 


Waveform 


Waveform Opacity 
Opacity of the points. 


Waveform Mode 
Luma 
ToDo. 


YCbCr 
ToDo. 


Parade 
The RGB channels are shown side-by-side. 


Red Green Blue 
Shows the RGB channels overlaid as a “Full color” 
waveform. It is useful for color grading. 


Vectorscope 


Vectorscope Opacity 
Opacity of the points. 


Sample Line 


The Sample Line scope is the same as the Histogram but 
allows you to get the sample data from a line. 


Sample Line 
Used to draw a line to use to read the sample data from. 


Scope Samples 


Full Sample 
Sample every pixel. 


Accuracy 
Proportion of original image source pixel lines to sample. 


Overlays 


The Overlays pop-over configures the overlays that are 
displayed on top of images. In the header, there is a button 
to turn off all overlays for the Image Editor. This option also 
toggles the visibility of UDIMs tile information. The options 
that are visible in the pop-over depend on the Image Editor 
mode. 


Geometry 


Display Texture Paint UVs 
Display overlay of texture paint UV layer. 


Image 


Show Metadata 
Displays the metadata if they were set in the render tab’s 
Metadata panel. 


Image Settings 


Image Panel 


Image 
Data-block menu. 


New + 
The New Image button opens a pop-up to configure a 
Generated image. 


Source 

See about Supported Graphics Formats. 
Single Image 

Still image or a single frame. 

Image Sequence 


Each frame is stored in a separate file. How to Opening an 
Image Sequence. For options see Movie below. 


Movie 


Frames packed into a container. 


Frames 
Sets the range of frames to use. 


Match Movie Length 


This button sets the movies frames to the length of 
the selected movie. 


Start 


Global starting frame of the sequence, when the 
playback should start. This is a global setting which 
means it affects all clip users such as the Movie Clip 
editor itself, motion tracking constraints and Compositor 
nodes. 


Offset 


Offsets the first frame of the clip. It adds an extra offset 
to the frame number when converting a scene frame to 
the frame number in the file name. This option does not 
affect tracking data or any other associated data. 


Cyclic 
Start over and repeats after the last frame to create a 
continuous loop. 


Auto Refresh 
Automatically refresh images on frame changes. 


Deinterlace 
Removes fields in a video file. For example, if it is an 
analog video and it has even or odd interlacing fields. 
Generated 


Image generated in Blender. 


¥ Image 


Source 


Y 


Generated 
1024 px 
1024 px 


Float Buffer 


Blank 
UV Grid 
Color Grid 


The New Image pop- 
up menu. 


Image panel for 
Generated source. 


Width, Height 


The size of image in pixels. 


Color 


Sets the fill color if creating a blank image. 


Type 
Blank: 


UV Grid: 


Color Grid: 


32-bit Float 


Creates a Blank image of a single 
specified color. 

Creates a checkerboard pattern with a 
colored cross (+) in each square. 
Creates a more complex colored grid 
with letters and numbers denoting 
locations in the grid. It could be used 
for testing how the UVs have been 
mapped and to reduce stretching or 
distortion. 


Creates a 32-bit image. This is a larger file size, but holds 
much more color information than the standard 8-bit 
image. For close-ups and large gradients, it may be 
better to use a 32-bit image. 


Tiled 


Creates an image with support for UDIMs. This option 
creates the first 1001 tile; more tiles can be added later in 
the UDIM Tiles panel. 


Common Options 


File 
Use for replacing or packing files. 


Pack 
Embed the resource into the current blend-file. 


Path 
Path to the linked file. 


Open 
Opens the File Browser to select a file from a drive. 


Reload 


Reloads the file. Useful when a file has been reworked 
in an external application. 


Use Multi-View 
See Multi-View. 


Color Space 


The Color Space the image file was saved in. Once 
loaded into Blender, the color will be treated as linear 
color. This option ensure the correct conversion to linear 
color is used. 


Texture’s color, and final renders are often stored in 
SRGB, while OpenEXR images are stored in a linear color 
Space. Some images such as normal, bump or stencil 
maps do not strictly contain ‘colors’, and on such values, 
no color space conversion should ever be applied. For 
such images, the color space should be set to Non-Color. 


The list of color spaces depends on the active OCIO 
contig. The default supported color spaces are described 
in detail here: Default OpenColorlO Configuration 


Alpha 
Representation of the image’s Aloha Channel, to convert 
to and from when saving and loading the image. This 
option is only available if the input format support’s 
encoding transparency. 


Straight: Store RGB and alpha channels 
separately with alpha acting as a mask, 
also known as unassociated alpha. 
Commonly used by image editing 
applications and file formats like PNG. 
This preserves colors in parts of the 
image with zero alpha. 

Premultiplied: Store RGB channels with alpha 
multiplied in, also Known as associated 
alpha. The natural format for renders 
and used by file formats like OpenEXR. 
This can represent purely emissive 
effects like fire correctly, unlike straight 
alpha. 

Channel Packed: 


Different images are packed in the RGB 
and alpha channels, and they should 
not affect each other. Channel packing 
is commonly used by game engines to 
save memory. 

None: Ignore alpha channel from the file and 
make image fully opaque. 


Half Float Precision 
Load the image as having only a Bit Depth of 16 bits per 
channel instead of 32 bits which saves memory. 


View as Render 
Applies color transform when displaying this image on 
the screen. 


Editing 


New 

Reference 

Mode: All Modes 
Menu: Image >» New 
Shortcut: ALt-N 


Creates a new Generated Image. 


Open 


Reference 

Mode: All Modes 
Menu: Image >» Open 
Shortcut: Alt-0 


Load image from a file. 


Open Cache Render 


Reference 
Mode: All Modes 
Menu: Image >» Open Cache Render 


Shortcut: Ctrl-R 


Load the current scene’s render layers from disk cache, if 
available. This can be used to save RAM while rendering 
because the render layers do not have to be saved in RAM. 
And also for recovering some information from a fail render. 
For this to work, Cache Result must be enabled. 


Replace 

Reference 

Mode: All Modes 
Menu: Image > Replace 


Replaces the current image throughout the blend-file with 
another image. 


Reload 


Reference 

Mode: All Modes 
Menu: Image » Reload 
Shortcut: ALt-R 


Reload the image from the file on drive. 
Edit Externally 


Reference 


Mode: All Modes 
Menu: Image » Edit Externally 


Using the Edit Externally tool Blender will open an external 
image editor, as specified in the Preferences and load in the 
image to be edited. 


Save 

Reference 

Mode: All Modes 
Menu: Image > Save 
Shortcut: Alt-S 


Save the image, if the image is already a file. 


Important 


Rendered images are not automatically saved, they have 
to be saved to drive manually. 


Save As 

Reference 

Mode: All Modes 
Menu: Image > Save As 
Shortcut: Shift-Alt-S 


Save the (rendered) image in a separate file of any type. 
The image output settings can be configured and are the 
same as the Render Output Properties. 


Save a Copy 


Reference 


Mode: All Modes 
Menu: Image > Save a Copy 


Using Save as Copy will save the file to a specified name, 
but will keep the old one open in the Image editor. 


Save All Images 


Reference 


Mode: All Modes 
Menu: Image » Save All Images 


Save all modified images. Packed images will be repacked. 


Invert 


Reference 


Mode: All Modes 
Menu: Image > Invert 


Invert Image Colors 
Invert the colors of an image. 


Invert Channel 
Red, Green, Blue, Alpha 


Resize 


Reference 
Mode: All Modes 
Menu: Image > Resize 


Adjust the image size in pixels. 


Flip 


Reference 
Mode: All Modes 
Menu: Image > Flip 


This operator mirrors the image across a specified axis. Use 
this to alter the perspective of an image giving an 
alternative viewpoint; this can make an image more visually 
appealing or highlight some visual flaw. 


Horizontally 
Mirrors the image so the left side becomes the right side. 


Vertically 
Mirrors the image so the top becomes the bottom. 


Pack 


Reference 


Mode: All Modes 
Menu: Image » Pack 


Packs the image into the blend-file. See Packed Data. 


Unpack 


Reference 
Mode: All Modes 
Menu: Image » Unpack 


Unpack the image to a drive. 


Extract Palette 


Reference 


Mode: All Modes 
Menu: Image » Extract Palette 


Extracts a Color Palette from the image for use by other 
tools. 


Generate Grease Pencil 


Reference 


Mode: All Modes 
Menu: Image » Generate Grease Pencil 


Creates a Grease Pencil object using the currently selected 
image as a source. 


UV Editor 
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Introduction 


The UV Editor is used to map 2D assets like images/textures 
onto 3D objects and edit what are called UVs. 


UV Editor with a UV map and a test grid texture. 


The most flexible way of mapping a 2D texture over a 3D 
object is a process called “UV mapping”. In this process, you 
take your three-dimensional (X, Y & Z) mesh and unwrap it 
to a flat two-dimensional (X & Y ... or rather, as we shall 
soon see, “U & V”) image. Colors in the image are thus 
mapped to your mesh, and show up as the color of the faces 
of the mesh. Use UV texturing to provide realism to your 
objects that procedural materials and textures cannot do, 
and better details than Vertex Painting can provide. 


UVs Explained 


The best analogy to understanding UV mapping is cutting up 
a cardboard box. The box is a three-dimensional (3D) object, 
just like the mesh cube you add to your scene. 


If you were to take a pair of scissors and cut a seam or fold 
of the box, you would be able to lay it flat on a tabletop. As 
you are looking down at the box on the table, we could say 
that U is the left-right direction, and V is the up-down 
direction. This image is thus in two dimensions (2D). We use 
U and V to refer to these “texture-space coordinates” 
instead of the normal X and Y, which are always used (along 
with Z) to refer to the three-dimensional space (3D). 


When the box is reassembled, a certain UV location on the 
paper is transferred to an (X, Y, Z) location on the box. This 
is what the computer does with a 2D image in wrapping it 
around a 3D object. 


During the UV unwrapping process, you tell Blender exactly 
how to map the faces of your object (in this case, a box) toa 
flat image in the UV Editor. You have complete freedom in 
how to do this. (Continuing our previous example, imagine 
that, having initially laid the box flat on the tabletop, you 
now cut it into smaller pieces, somehow stretch and/or 
shrink those pieces, and then arrange them in some way 
upon a photograph that is also lying on that tabletop.) 


Example 


3D space (XYZ) versus UV space. 


In this image you can easily see that the shape and size of 
the marked face in 3D space is different in UV space. This 

difference is caused by the “stretching” (technically called 
mapping) of the 3D part (XYZ) onto a 2D plane (i.e. the UV 
map). 


If a 3D object has a UV map, then, in addition to the 3D 
coordinates X, Y, and Z, each point on the object will have 
corresponding U and V coordinates. 


Note 


On more complex models (like seen in the sphere above) 
there pops up an issue where the faces cannot be cut, but 
instead they are stretched in order to make them flat. This 
helps making easier UV maps, but sometimes adds 
distortion to the final mapped texture. 


Advantages of UVs 


While procedural textures are useful - they never repeat 
themselves and always “fit” 3D objects - they are not 
sufficient for more complex or natural objects. For instance, 
the skin on a human head will never look quite right when 
procedurally generated. Wrinkles on a human head, or 
scratches on a car do not occur in random places, but 
depend on the shape of the model and its usage. Manually- 
painted images, or images captured from the real world 
gives more control and realism. For details such as book 
covers, tapestry, rugs, stains, and detailed props, artists are 
able to control every pixel on the surface using a UV 
texture. 


A UV map describes what part of the texture should be 
attached to each polygon in the model. Each polygon’s 
vertex gets assigned to 2D coordinates that define which 
part of the image gets mapped. These 2D coordinates are 
called UVs (compare this to the XYZ coordinates in 3D). The 
operation of generating these UV maps is also called 
“unwrap”, since it is as if the mesh were unfolded onto a 2D 
plane. 


For most simple 3D models, Blender has an automatic set of 
unwrapping algorithms that you can easily apply. For more 
complex 3D models, regular Cubic, Cylindrical or Spherical 
mapping, is usually not sufficient. For even and accurate 
projection, use seams to guide the UV mapping. This can be 
used to apply textures to arbitrary and complex shapes, like 
human heads or animals. Often these textures are painted 
images, created in applications like the Gimp, Krita, or your 
favorite painting application. 


Interface 


Header 


fy 7% FRPP ay view Select Image uv 


UV Editor header. 


The header contains several menus and options for working 
with UVs. 


Sync Selection 
Syncs selection between the UV Editor and the 3D 
Viewport. See Sync Selection for more details. 


Selection Mode 
The UV element type to select. See Selection Mode for 
more details. 


Sticky Selection Mode 
Option to automatically expand selection. See Sticky 
Selection Mode for more details. 


View 
Tools for controlling how the content is displayed in the 
editor. See Navigating. 


Select 
Tools for Selecting_UVs. 


Image 
Tools for opening and manipulating images. See Editing. 


UV 
Contains tools for Unwrapping Meshes and Editing UVs. 


Image 
A data-block menu used for selecting images. When an 
image has been loaded or created in the Image editor, 
the Image panel appears in the Sidebar region. See 
Image Settings. 


Image Pin 
Todo. 


Active UV Loop Layer 
Select which UV map to use. 


Viewport Gizmos 
Selectively show or hide specific gizmo controls that are 
displayed in the 2D viewport. 
All gizmos can be hidden or shown at once with the 
toggle next to the pop-over arrow. 


Navigate 
Enable/disable the gizmos used to pan or zoom the 2D 
viewport, see Navigation Gizmos for more information. 


Display Channels 
Select what color channels are displayed. 


Color and Alpha: 
Replaces transparent pixels with 
background checkerboard, denoting 
the alpha channel. 


Color: Display the colored image, without 
alpha channel. 
Alpha: Displays the Alpha channel a grayscale 


image. White areas are opaque, black 
areas have an alpha of 0. 

Z-Buffer: Display the depth from the camera, 
from Clip Start to Clip End, as specified 
in the Camera settings. 

Red, Green, Blue: 

Single Color Channel visualized as a 
grayscale image. 


Tool Settings 


Pivot 
Similar to working with pivot points in the 3D Viewport. 


UV Snapping 
Controls to snap UV points, similar to snapping in the 3D 
Viewport. 


Proportional Editing 
See Proportional Editing. 


Navigating 


The UV Editor has a 2D cursor. Its position can be changed 
by LMB clicking in the UV editor while the cursor tool is 
active. You can also manually adjust its position in the 
Sidebar region. The range by default is from 0.0 to 1.0 
starting from the lower left corner. By enabling Pixel 
Coordinates, the coordinates match the pixels in your image 
with XY(0, 0) located in the lower left corner. 


2D Viewport 


Panning can be done by clicking the mB and dragging. 


Zooming can be done by scrolling wheel up or down. Also, as 
in the 3D Viewport, you Can uSe NumpadPlus Or NumpadMinus to 
ZOOM. 


Gizmos 


Next to the Sidebar region at the top, there are gizmos that 
allow panning and zooming more comfortably when e.g. no 
mouse wheel is available. 


View Menu 


Also see Navigating in the Image editor. 


Frame Selected NumpadPeriod 
Change view so that all selected UV vertices are visible. 


Overlays 


The Overlays popover configures the overlays that are 
displayed on top of images. In the header, there is a button 
to turn off all overlays for the UV Editor. This option also 
toggles the visibility of UDIMs tile information. The options 
that are visible in the pop-over depend on the UV Editor 
mode. 


See also 


Additional View Properties can be configured in the 
Sidebar. 


Guides 


Grid 
Show the grid background and borders. 


Over Image 
Allows the grid overlay to be shown on top of the image 
rather than behind it. 


Grid Shape Source 
How the size/subdivisions of grid cells are determined. 


Dynamic: The grid subdivisions changes based on 
the zoom level. 

Fixed: The grid subdivisions stays consistent 
based off the Fixed Subdivisions 
property. 


Pixel: 


The grid aligns with pixels from image 
so each grid cell represents one pixel. 


Fixed Subdivisions X, Y 
Number of grid units in UV space that make one UV Unit. 


Tiles X, Y 
The number of UDIM tile grids to display in each cardinal 
direction. 


UV Editing 


Display Stretch 
Shows how much of a difference there is between UV 
coordinates and 3D coordinates. Blue means low 
distortion, while Red means high distortion. Choose to 
display the distortion of Angles or the Area. 


Geometry 

UV Opacity 
Opacity of the above UV overlays. 

Display As 
Controls how edges are shown. 
Outline: Display white edges with black outline. 
Dash: Display dashed black-white edges. 
Black: Display black edges. 
White: Display white edges. 


Modified Edges 
Show results of modifiers in the UV display. 


Faces 


Display faces over the image. 


Image 


Show Metadata 
Displays the metadata if they were set in the render tab’s 
Metadata panel. 


Sidebar 


Image Tab 

UV Vertex 

Transform Properties Selecting UVs. 
Image 

See Image Settings. 

UDIM Tiles 


Allows you to manage UDIM Tiles. 


Tool Tab 


Shows the settings for the active tool. 


View Tab 


Display 
You can set the editors display options in this panel. 


Aspect Ratio 
Display Aspect for this image. Does not affect rendering. 
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il it is repeated to fill the main view. 


Pixel Coordinates 
Display UV coordinates in pixels rather than from 0.0 to 
1.0 


2D Cursor 


Location X, Y 
Control 2D cursor location. 


Annotations 


Options for the annotation tool. 


Scopes 


See Scopes in the Image Editor. 


Selecting 


Selection tools are available in the Select Menu in the 
header, and the shortcuts listed below. 


Sync Selection 


Turning on the Sync Selection button causes selection of 
components in the 3D Viewport to sync with their 
corresponding elements in the UV editor. If off only the 
selected faces are displayed in the UV editor. These two 
modes have very different results when transforming 
components in the UV editor. 


See also 


Selecting in the 3D Viewport. 


Selection Modes 
Select Modes dependent on the Sync Selection. 


Sync Selection Off 


Vertex 
Select individual vertices. 


Edge 
Select edges. 


Face 
Select faces. 


Island 
Select contiguous groups of faces. 


Sync Selection On 


When selecting UVs or Edges, it behaves like the Shared 
Vertex option of the Sticky Selection Mode. When selecting 
Faces, it behaves like the Disabled option of the Sticky 
Selection Mode. 


Vertex 
Select individual vertices. 


Edge 
Select edges. 


Face 
Select faces. 


Sticky Selection Mode 


This selector lets you enable automatic additional selection. 


Shared Vertex 
Selects UVs that share a mesh vertex, even if they are in 
different UV locations. 


Shared Location 
Selects UVs that are in the same UV location and share a 
mesh vertex. 


Disabled 


Disables Sticky Selection. When you move a UV in this 
mode, each face owns its own UVs, allowing them to be 
separated. 


Menu 


Box Select B 
Click and drag to box select UV coordinates. 
Alternatively, use B to start box selection. 


Box Select Pinned ctri-B 
Use the box lasso to select only pinned UV coordinates. 


Circle Select 
See Select Circle. 


Select All A 
Selects all UV coordinates. 


Select None Alt-A 
Deselects all UV coordinate. 


Inverse Ctrl-I 
Inverts the current selection. 


More/Less Ctrl-NumpadPlus, Ctrl-NumpadMinus 
Expands/Contracts the selection to/from the adjacent 
elements of the selection type. 


Select Pinned Shift-P 
Selects all pinned UVs. 


Select Linked 
Linked cCtri-L 
This operator selects all UVs that are connected to 
currently selected UVs. This works similarly to the 


tools in 3D Viewport. 


Shortest Path 
Path between two selected elements. 


Select Similar Shift-G 


Selects UV vertices that have certain similar properties to 
the Active vertex. The Adjust Last Operation panel 
provides several selection options: 


Type 
The property to compare against the active vertex. 
The properties that are shown depend on the 
Selection Mode. 


Vertex Selection Mode: 


Pinned: Selects vertices with the same 
pinned state as the active vertex. 


Edge Selection Mode: 


Length: Selects edges with a similar length. 

Length 3D: Selects edges with a similar length 
in world space coordinates. 

Pinned: Selects edges whose both vertices 


have the same pinned state as the 
active vertex. 


Face Selection Mode: 


Area: Selects faces with a similar area. 

Area 3D: Selects faces with a similar area in 
world space coordinates. 

Polygon Sides: Selects faces with the same number 
of edges per face. 

Material: 


Selects faces that have the same 
Material. 


Island Selection Mode: 


Area: Selects islands with a similar area. 

Area 3D: Selects islands with a similar area in 
world space coordinates. 

Amount of Face in Island: 
Selects islands with a similar 
number of faces per each island. 


Compare 
For quantitative properties, this property selects the 
type of comparison to between the two numerical 


values. 

Equal: Select items with the same value as 
the active item’s chosen property. 

Greater: Select items with a larger value as 
the active item’s chosen property. 

Less: Select items with a smaller value as 
the active item’s chosen property. 

Threshold 


For quantitative properties, this property controls how 
close the property’s values have to be in the 
comparison. 


Select Split y 
Cuts apart the selected UVs from the map. Only those 
UVs which belong to fully selected faces remain selected. 
As the name implies, this is particularly useful to unlink 
faces and move them elsewhere. The hotkey is 
analogous to the mesh Split tool. 


Select Overlap 


Selects any UVs that are extended over other UVs while 
also selecting any underlying UVs. 


Shortest Path 


Reference 

Mode: Edit Mode 

Menu: Select >» Select Linked >» Shortest Path 
Shortcut: Ctrl-LMB 


Selects all UV components along the shortest path from the 
active component to the one which was selected. 


Face Stepping 
Supports diagonal paths for vertices and faces, and 
selects edge rings with edges. 


Topological Distance 
Only takes into account the number of edges of the path 
and not the length of the edges to calculate the 
distances. 


Fill Region Shift-Ctrl-LMB 
Selects all elements in the shortest paths from the active 
selection to the clicked area. 


Checker Deselect Options 
Allows to quickly select alternate elements in a path. 


Deselected 
The number of deselected elements in the repetitive 
sequence. 


Selected 


The number of selected elements in the repetitive 
sequence. 


Offset 
Offset from the starting point. 


See also 


Mesh edit Select Shortest Path. 


Select Edge Loops 


Reference 
Mode: Edit Mode 
Shortcut: Ctrl-Alt-LMB, OF Shift-Ctrl-Alt-LMB for 


modifying existing selection. 


Holding ctri-Alt while selecting a UV component selects a 
loop of edges that are connected in a line end-to-end, 
passing through the edge under the mouse pointer. Holding 
Shift-Ctrt-Alt while clicking adds to the current selection. 


See also 


Mesh edit Select Edge Loops. 


Snapping 
Snap To 


Reference 

Header: Snapping » Snap To 
Shortcut: Shift-Ctrl-Tab 
Increment 


Snap elements along points on a fixed scale. These 
points are defined by the intersection points of the grid 
and the scale of the increments depending on zoom 
level, unless using Fixed Subdivisions. 


The Custom Grid can also be used to define a set 
distance of the scale. 


Note 


In this context the grid does not mean the visual grid 
cue displayed. Snapping will use the resolution of the 
displayed grid, but all transformations are relative to 
the initial position (before the snap operation). 


Note, the behavior can be disabled by using Absolute 
Grid Snap. 


Vertex 
Snap to UV vertices. 


Additional Options 


Absolute Grid Snap 
Available only for the Increment option. Snap to the 
visual grid, instead of snapping in increments relative to 
the current location. 


Target 
See 3D Viewport Snapping for more information. 


Affect 


Limits the effect of the snap to the transformation type. 


Compositor 


The Compositor lets you manage nodes for compositing. 


Nodes in the Compositor. 


The use of the Compositor is explained in Compositing. 


Texture Nodes 


Introduction 
o Using Texture Nodes 
o Using Multiple Outputs 
o Header 


Node Types 


Color Nodes 
Converter Nodes 
Distort Nodes 
Input Nodes 
Output Nodes 
Pattern Nodes 
Texture Nodes 
Group 


Introduction 


Note 


The texture node system is legacy and will be replaced 
soon by a new system. Due to this, the manual is not up to 
date with the latest version of Blender. 


Blender includes a node-based texture generation system, 
which enables textures creation by combining colors, 
patterns and other textures in the same way as shader 
writing with material nodes. 


y Checker © 
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y Output 
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Color 
Multiply v Ww) 
Said Default 


@ Factor 1.000 i 
@ Color 
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Noise Depth 2 


@ Color 1 


e Turbulence 5.000 


Combined textures based on nodes. 


These textures can be used for brushes, compositing and 
inside particle systems. 


Using Texture Nodes 


To use texture nodes with the current texture, open the 
Texture Node editor. 


A new texture can be created by either clicking the New 
button in the Texture Node editor, or the New button in the 
Texture panel. Once a texture is selected, it can be toggled 
to a function as a regular texture or a node texture by 
clicking the Use Nodes option in the Texture Node editor. 


The default node setup will appear: a red-and-white 
checkerboard node connected to an Output named 
“Default”. For texture nodes, multiple Outputs can exist in 
the node setup. Compare to other types of node contexts, 
which are limited to one active Output node. See the next 
section for details. 


For instructions on how to add, remove and manipulate the 
nodes in the tree, see the nodes reference. 


Using Multiple Outputs 


Each texture defined with texture nodes can have several 
outputs, which can then be used for different things. For 
example, a texture that defines both a diffuse (color) map 
and a normal map. This can be done by: 


1. Create two texture slots in the texture list, and set them 
to the same texture data-block. 

2. Add two Output nodes to the node tree, and type new 
names into their Name text fields: e.g. “Diffuse” for one 
and “Normal” for the other. 

3. Underneath the texture list view in the Texture panel, a 
selector with the names of the outputs is shown. For 
each entry in the Texture list, select the desired output 
by changing the menu entry (e.g. set one to Diffuse and 
the other to Normal). 


These named outputs could be used, when the material is 
defined with material nodes. In this case, Texture Channels 
are probably not used. Instead, insert the texture nodes into 
the material node tree by using Add > Input > Texture. Inside 
the just added texture node the output to use can then be 
selected (e.g. Diffuse or Normal). 


Header 


Pin (pin icon) 
The pin button will keep the current texture selection 
fixed. When a texture is pinned, it will remain visible in 
the Texture Editor even when another object or 
simulation is selected elsewhere. 


Color Nodes 


Combine Color Node 
Invert Node 

Mix Node 

RGB Curves Node 

Hue Saturation Value Node 
Separate Color Node 


Combine Color Node 


The Combine Color Node combines an v Combine Color 
image from its composite color 

channels. The node can combine 
multiple Color Models depending on v 
the Mode property. 


Color 


Inputs 


The outputs of this node depends on the Mode property (see 
below). 


Alpha 
The color channel that that is responsible for the image’s 
transparency. 


Properties 
Mode 
The color model to output. 
RGB: Combine the three inputs: Red, Green, 
and Blue color channels into a single 
color. 


HSV: 


Combine the three inputs: Hue, 
Saturation, and Value color channels 
into a single color. 

HSL: Combine the three inputs: Hue, 
Saturation, and Lightness color 
channels into a single color. 


Output 


Color 
Standard color output. 


Invert Node 


The Invert Node inverts the colors in 
the input image, producing a 
negative. 


Y Invert 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 
output image. 


Color 
Standard color input. 


Properties 


In the compositing context this node has the following 
properties. 


RGB 
De/activation of the color channel inversion. 


Alpha 
De/activation of the alpha channel inversion. 


Outputs 


Color 
Standard color output. 


Example 


@ | Hue 0.500 
@ | Saturation 0.100 
@ [Value 0.300 
@ Fac 


© 


_ 


@ Use Alpha 
Image 

e Alpha 1.000 

ez 1.000 


@% Use Alpha 
Image 

© Alpha 1.000 

1.000 


The Invert node is used to invert the mask. 


Mix Node 


The Mix Node mixes images by © 
working on the individual and 
corresponding pixels of the two input 


Image 


images. Called “Mix Color” in the Mix aX 
shader, geometry, and texture cane 
context. 
@ 
Important whip 


Image 


As of Blender 3.4 this node has 
been updated in Shader and 
Geometry node editors. Files saved 
with the new node are not forward compatible. 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output image. 

Image 
The background image. The image size and resolution 
sets the dimensions of the output image. 


Image 
The foreground image. 


Properties 


Mix 
The Blend modes can be selected in the select menu. 
See Color Blend Modes for details on each blending 
mode. 


Add, Subtract, Multiply, Screen, Divide, Difference, 
Darken, Lighten, Overlay, Color Dodge, Color Burn, Hue, 
Saturation, Value, Color, Soft Light, Linear Light 


Use Alpha 
If activated, by clicking on the Color and Alpha icon, the 
Alpha channel of the second image is used for mixing. 
When deactivated, the default, the icon background is a 
light gray. The alpha channel of the base image is always 
used. 


Clamp 
Limit the output value between 0.0 and 1.0. 


Outputs 


Image 
Standard color output. 


Examples 


Below are samples of common mix modes and uses, mixing 
a color or checker with a mask. 


Some explanation of the mixing methods above might help 
you use the Mix node effectively: 


Add 
Adding blue to blue keeps it blue, but adding blue to red 
makes purple. White already has a full amount of blue, so 
it stays white. Use this to shift a color of an image. 
Adding a blue tinge makes the image feel colder. 


Subtract 
Taking Blue away from white leaves Red and Green, 
which combined make Yellow. Taking Blue away from 
Purple leaves Red. Use this to desaturate an image. 
Taking away yellow makes an image bluer and more 
depressing. 


Multiply 


Black (0.0) times anything leaves black. Anything times 
White (1.0) is itself. Use this to mask out garbage, or to 
colorize a black-and-white image. 


Hue 
Shows you how much of a color is in an image, ignoring 
all colors except what is selected: makes a monochrome 
picture (style ‘Black & Hue’). 


Mix 
Combines the two images, averaging the two. 


Lighten 
Like bleach makes your whites whiter. Used with a mask 
to lighten up a little. 


Difference 
It takes out a color. The color needed to turn Yellow into 
White is Blue. Use this to compare two very similar 
images to see what had been done to one to make it the 
other; sort of like a change log for images. You can use 
this to see a watermark (See Watermark images) you 
have placed in an image for theft detection. 


Darken 
With the colors set here, it’s like looking at the world 
through rose-colored glasses. 


Note 


Only add, subtract, multiply and divide are suitable for 
Scene Referenced images. 


Contrast Enhancement 


Here is a small node tree showing the effects of two other 
common uses for the RGB Curve: Darken and Contrast 
Enhancement. You can see the effect each curve has 
independently, and the combined effect when they are 
mixed equally. 


Example node setup showing “Darken”, “Enhance 
Contrast” and “Mix” nodes for composition. 


As you can hopefully see, our original magic monkey was 
overexposed by too much light. To cure an overexposure, 
you must both darken the image and enhance the contrast. 


In the top RGB curve, Darken, only the right side of the 
curve was lowered; thus, any X input along the bottom 
results in a geometrically less Y output. The Enhance 
Contrast RGB (S-shaped) curve scales the output such that 
middle values of X change dramatically; namely, the middle 
brightness scale is expanded, and thus, whiter whites and 


blacker blacks are output. To make this curve, simply click 
on the curve and a new control point is added. Drag the 
point around to bend the curve as you wish. The Mix node 
combines these two effects equally, and Suzanne feels 
much better. 


Watermark Images 


In the old days, a pattern was pressed into the paper mush 
as it dried, creating a mark that identified who made the 
paper and where it came from. The mark was barely 
perceptible except in just the right light. Probably the first 
form of subliminal advertising. Nowadays, people watermark 
their images to identify them as personal intellectual 
property, for subliminal advertising of the author or hosting 
service, or simply to track their image’s proliferation 
throughout the web. Blender provides a complete set of 
tools for you to both encode your watermark and to tell if an 
image has your watermark. 


Encoding your Watermark in an Image 


First, construct your own personal watermark. You can use 
your name, a word, or a shape or image not easily 
replicated. While neutral gray works best using the encoding 
method suggested, you are free to use other colors or 
patterns. It can be a single pixel or a whole gradient; it is up 
to you. In the example below, we are encoding the 
watermark in a specific location in the image using the 
Translate node; this helps later because we only have to 
look at a specific location for the mark. We then use the 
RGB to BW node to convert the image to numbers that the 
Map Value node can use to make the image subliminal. In 
this case, it reduces the mark to one-tenth of its original 
intensity. The Add node adds the corresponding pixels, 


making the ones containing the mark ever-so-slightly 
brighter. 


Embedding your mark in an image using a mark and 
specific position. 


Of course, if you want people to notice your mark, do not 
scale it So much, or make it a contrasting color. There are 
also many other ways, using other mix settings and fancier 


rigs. Feel free to experiment! 
Hint 
Additional uses 


You can also use this technique, using settings that result 
in visible effects, in title sequences to make the words 
appear to be cast on the water’s surface, or as a special 
effect to make words appear on the possessed girl’s 


forearm. 


Decoding an Image for your Watermark 


When you see an image that you think might be yours, use 
the node tree below to compare it to your stock image (pre- 


watermarked original). In this tree, the Mix node is set to 
Difference, and the Map Value node amplifies any 
difference. The result is routed to a viewer, and you can see 
how the original mark clearly stands out. 


Checking an image for your watermark. 


Various image compression algorithms lose some of the 
Original; the difference shows as noise. Experiment with 
different compression settings and marks to see which 
works best for you by having the encoding node group in 
one scene, and the decoding group in another. Use them 
while changing Blender’s image format settings, reloading 
the watermarked image after saving, to get an acceptable 
result. In the example above, the mark was clearly visible all 
the way up to JPEG compression of 50%. 


RGB Curves Node 


The RGB Curves Node allows 
color corrections for each color 
channel and levels 
adjustments in the Standard Filmlike 
compositing context. 
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Image 
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Image 


White Level 


Black Level 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output image. 


Image 
Standard color input. 


Black Level Compositor Only 


Defines the input color that is (linear) mapped to black. 


White Level Compositor Only 
Defines the input color that is (linear) mapped to white. 


Tip 


To define the levels, use the eyedropper to select a color 
sample of a displayed image. 


Properties 


Tone Compositor Only 
Standard: TODO 2.8 
Film Like: TODO 2.8 


Channel 
Clicking on one of the channels displays the curve for 
each. 


C (Combined RGB), R (Red), G (Green), B (Blue) 


Curve 
A Bézier curve that varies the input levels (X axis) to 
produce an output level (Y axis). For the curve controls 
see: Curve widget. 


Outputs 


Image 
Standard color output. 


Examples 


Below are some common curves you can use to achieve 
desired effects. 


From left to right: 1. Lighten shadows 2. Negative 3. 
Decrease contrast 4. Posterize. 


Color Correction using Curves 


Image 
Standard Film like 
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Image 
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Color correction with curves. 


In this example, the image has too much red in it, so we run 
it through an RGB Curves node and reduce the Red channel. 


Also, read on for examples of the Darken and Contrast 
Enhancement curves, here. 


Color Correction using Black/White Levels 


y RGB Curves 
Image 


Standard Film like 


Gros OOS 


Color correction with Black/White Levels. 


Manually adjusting the RGB curves for color correction can 
be difficult. Another option for color correction is to use the 
Black and White Levels instead, which really might be their 
main purpose. 


In this example, the White Level is set to the color of a 
bright spot of the sand in the background, and the Black 
Level to the color in the center of the fish’s eye. To do this 
efficiently it is best to bring up the Image Editor showing the 
Original input image. You can then use the levels’ color 
picker to easily choose the appropriate colors from the input 
image, zooming into pixel level if necessary. The result can 
be fine-tuned with the R, G, and B curves like in the previous 
example. 


The curve for C is used to compensate for the increased 
contrast that is a side effect of setting Black and White 
Levels. 


Effects 


Image 
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Standard Film like 


Image 
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O9Nv ex 


X 1.00000 Y 0.00000 


@ | Fac 1.000 


Image 


Changing colors by inverting the 
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red channel. 


Hue Saturation Value 
Node 


The Hue Saturation Value Node 

applies a color transformation in the 

HSV Color Model. Image 
Image al 


Hue 0.500 


Y Hue Saturation Value 


Saturatio 1.000 
Value 1.000 
Fac 1.000 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 
output image. 


Image 
Standard color input. 


Properties 


The transformations are relative shifts. In the shader and 
texture context the following properties are available as 
input sockets. 


Hue 


Specifies the hue rotation of the image. 360° are mapped 
to (0 to 1). The hue shifts of 0 (-180°) and 1 (+180°) 
have the same result. 


Saturation 
A saturation of 0 removes hues from the image, resulting 
in a grayscale image. A shift greater than 1.0 increases 
saturation. 


Value 
Value is the overall brightness of the image. 
De/Increasing values shift an image darker/lighter. 


Outputs 


Image 
Standard color output. 


Hue/Saturation Tips 


Some things to keep in mind that might help you use this 
node better: 


Hues are vice versa 
A blue image, with a Hue setting at either end of the 
spectrum (0 or 1), is output as yellow (recall that white, 
minus blue, equals yellow). A yellow image, with a Hue 
setting at 0 or 1, is blue. 


Hue and Saturation work together. 
So, a Hue of 0.5 keeps the blues the same shade of blue, 
but Saturation can deepen or lighten the intensity of that 
color. 


Gray & White are neutral hues 
A gray image, where the RGB values are equal, has no 
hue. Therefore, this node can only affect it with Value. 


This applies to all shades of gray, from black to white; 
wherever the values are equal. 


Changing the effect over time 
The Hue and Saturation values can be animated with a 
Time Node or by animating the property. 


Note 

Tinge 

This HSV node simply shifts hues that are already there. To 
colorize a gray image, or to add a tint to an image, use a 


Mix node to add in a static color from an RGB input node 
with your image. 


HSV Example 


A basic example. 
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An example of using the Factor input for masking. 


Separate Color Node 


The Separate Color Node splits an \ Separate Color 
image into its composite color 
channels. The node can output 
multiple Color Models depending on 
the Mode property. ates 


Red © 
Green © 


Alpha © 


vw 


Inputs 


Color 
Standard color input. 


Properties 
Mode 

The color model to output. 

RGB: Split the input colors into it’s three 
outputs: Red, Green, and Blue color 
channels. 

HSV: Split the input colors into it’s three 


outputs: Hue, Saturation, and Value 
color channels. 

HSL: Split the input colors into it’s three 
outputs: Hue, Saturation, and Lightness 
color channels. 


Outputs 


The outputs of this node depends on the Mode property (see 
above). 


Alpha 
The color channel that that is responsible for the image’s 


transparency. 


Converter Nodes 


e Color Ramp Node 

e Distance Node 

e Math Node 

e RGB to BW Node 

e Value to Normal Node 


Color Ramp Node 


The Color Ramp Node is 
used for mapping values 
to colors with the use of a image 

gradient. Alpha @ 


Y ColorRamp 


Inputs 


Factor 
The Factor input is used as an index for the color ramp. 


Properties 


Color Ramp 
For controls see Color Ramp Widget. 


Outputs 


Image 
Standard color output. 


Alpha 


Standard alpha output. 


Examples 


Creating an Alpha Mask 


An often overlooked use case of the Color Ramp is to create 
an alpha mask, or a mask that is overlaid on top of another 
image. Such a mask allows you to select parts of the 
background to be shown through. 


Using the Color Ramp node to create an alpha mask. 


In the map above, a black-and-white swirl image, which is 
lacking an alpha channel, is fed into the Color Ramp node as 
a Factor. 


The Color Ramp node is set to a purely transparent color on 
the left end of the gradient, and a fully red color on the 
right. As you can see in the Viewer node, the Color Ramp 
node puts out a mask that is fully transparent where the 
image is black. Black is zero, so Color Ramp outputs the 
color at the left end of the gradient, which is set to 
transparent. The Color Ramp image is fully red and opaque 
where the image is white (which is 1). 


You can verify that the output image mask is indeed 
transparent by overlaying it on top of another image. 


Colorizing an Image 


In this example multiple colors are added to the color 
gradient converting a black-and-white image into a flaming 
swirl. 


1) 


Image 


Alpha @ 


Depth @ 


The shades of gray in the input image are mapped to three 
colors: blue, yellow, and red, all fully opaque (alpha of 1). 
Where the image is black, Color Ramp substitutes blue (the 
first color stop). Where it is some shade of gray, Color Ramp 
outputs a corresponding color from the gradient (bluish, 


yellow, to reddish). Where the image is fully white, the Color 
Ramp outputs red. 


Distance Node 


Computes the distance between two 
3D coordinates. 


Inputs 


Coordinate 1 
First coordinate point. 


Coordinate 2 
Second coordinate point. 


Properties 


This node has no properties. 


Outputs 


Value 
Calculated distance. 


Y Distance 


Coordinate 1: 
0.000 
0.000 
0.000 


Coordinate 2: 
0.000 
0.000 
0.000 


Value 


Math Node 


The Math Node performs math 


operations. 
Value @ 


v 


Clamp 


o Value 0.500 
@ Value 0.500 


Inputs 


The inputs of the node are dynamic. Some inputs are only 
available in certain operations. For instance, the Addend 
input is only available in the Multiply Add operator. 


Value 
Input Value. Trigonometric functions read this value as 
radians. 


Addend 
Input Addend. 


Base 
Input Base. 


Exponent 
Input Exponent. 


Epsilon 
Input Epsilon. 


Distance 
Input Distance. 


Min 
Input Minimum. 


Max 
Input Maximum. 


Increment 
Input Increment. 


Scale 
Input Scale. 


Degrees 
Input Degrees. 


Radians 
Input Radians. 


Properties 


Operation 


The mathematical operator to be applied to the input 


values: 


Functions 
Add: 
Subtract: 


Multiply: 
Divide: 


Multiply Add: 


The sum of the two values. 

The difference between the two 
values. 

The product of the two values. 

The division of the first value by the 
second value. 

The sum of the product of the two 
values with Addend. 


Power: 
Logarithm: 
Square Root: 
Inverse Square 


Absolute: 


Exponent: 


Comparison 
Minimum: 


Maximum: 


Less Than: 


Greater Than: 


Sign: 


Compare: 


The Base raised to the power of 
Exponent. 

The log of the value with a Base as 
its base. 

The square root of the value. 

Root: 

One divided by the square root of 
the value. 

The input value is read without 
regard to its sign. This turns 
negative values into positive values. 
Raises Euler’s number to the power 
of the value. 


Outputs the smallest of the input 
values. 

Outputs the largest of two input 
values. 

Outputs 1.0 if the first value is 
Smaller than the second value. 
Otherwise the output is 0.0. 
Outputs 1.0 if the first value is larger 
than the second value. Otherwise 
the output is 0.0. 

Extracts the sign of the input value. 
All positive numbers will output 1.0. 
All negative numbers will output 
-1.0. And 0.0 will output 0.0. 
Outputs 1.0 if the difference 
between the two input values is less 
than or equal to Epsilon. 


Smooth Minimum: 


Smooth Minimum. 


Smooth Maximum: 


Smooth Maximum. 


Rounding 


Round: 
Floor: 
Ceil: 
Truncate: 
Fraction: 


Modulo: 


Wrap: 


Snap: 


Ping-pong: 


Trigonometric 


Sine: 
Cosine: 
Tangent: 
Arcsine: 
Arccosine: 


Arctangent: 


Arctan2: 


Rounds the input value to the 
nearest integer. 

Rounds the input value down to the 
nearest integer. 

Rounds the input value up to the 
nearest integer. 

Outputs the integer part of the 
value. 

Returns the fractional part of the 
value. 

Outputs the remainder once the first 
value is divided by the second 
value. 

Outputs a value between Min and 
Max based on the absolute 
difference between the input value 
and the nearest integer multiple of 
Max less than the value. 

Rounds the input value down to the 
nearest integer multiple of 
Increment. 

The output value is moved between 
0.0 and the Scale based on the input 
value. 


The Sine of the input value. 

The Cosine of the input value. 

The Tangent of the input value. 
The Arcsine of the input value. 
The Arccosine of the input value. 
The Arctangent of the input value. 
Outputs the Inverse Tangent of the 
first value divided by the second 
value measured in radians. 


Hyperbolic Sine: 
The Hyperbolic Sine of the input 
value. 

Hyperbolic Cosine: 
The Hyperbolic Cosine of the input 
value. 

Hyperbolic Tangent: 
The Hyperbolic Tangent of the input 


value. 
Conversion 
To Radians: Converts the input from degrees to 
radians. 
To Degrees: Converts the input from radians to 
degrees. 
Clamp 


Limits the output to the range (0.0 to 1.0). See Clamp. 


Outputs 


Value 
Numerical value output. 


Examples 


Manual Z-Mask 


Minimum and maximum function example. 


This example has one scene input by the top Render Layers 
node, which has a cube that is about 10 units from the 
camera. The bottom Render Layers node inputs a scene 
with a plane that covers the left half of the view and is 7 
units from the camera. Both are fed through their respective 
Map Value nodes to divide the Z-buffer by 20 (multiply by 
0.05, as shown in the Size field) and clamped to be a 
min/max of 0.0/1.0 respectively. 


For the minimum function, the node selects those Z values 
where the corresponding pixel is closer to the camera; so it 
chooses the Z values for the plane and part of the cube. The 
background has an infinite Z value, so it is clamped to 1.0 
(shown as white). In the maximum example, the Z values of 
the cube are greater than the plane, so they are chosen for 


the left side, but the plane Render Layers Z are infinite 
(mapped to 1.0) for the right side, so they are chosen. 


Using Sine Function to Pulsate 


Using sine function example. 


This example has a Time node putting out a linear sequence 
from O to 1 over the course of 101 frames. At frame 25, the 
output value is 0.25. That value is multiplied by 2 x pi 
(6.28) and converted to 1.0 by the Sine function, since \ 
(sin(2 x pi/ 4) = sin(pi/ 2) = +1.0\). 


Since the sine function can put out values between (-1.0 to 
1.0), the Map Value node scales that to 0.0 to 1.0 by taking 
the input (-1 to 1), adding 1 (making O to 2), and multiplying 
the result by one-half (thus scaling the output between 0 to 
1). The default Color Ramp converts those values to a gray- 
scale. Thus, medium gray corresponds to a 0.0 output by 
the sine, black to -1.0, and white to 1.0. As you can see, \ 
(sin(pi/ 2) = 1.0\). Like having your own visual color 
calculator! Animating this node setup provides a smooth 
cyclic sequence through the range of grays. 


Use this function to vary, for example, the alpha channel of 
an image to produce a fading in/out effect. Alter the Z 
channel to move a scene in/out of focus. Alter a color 
channel value to make a color “pulse”. 


Brightening (Scaling) a Channel 


Scaling a channel example. 


This example has a Math (Multiply) node increasing the 
luminance channel (Y) of the image to make it brighter. Note 
that you should use a Map Value node with min() and max() 
enabled to clamp the output to valid values. With this 
approach, you could use a logarithmic function to make a 
high dynamic range image. For this particular example, 
there is also a Bright/Contrast node that might give simpler 
control over brightness. 


Restrict Color Selection (Posterization) 


Posterization example. 


In this example, we restrict the color values to be one of the 
six values: 0, 0.2, 0.4, 0.6, 0.8, 1. 


To split up a continuous range of values between 0 and 1 to 
certain set of values, the following function is used: \ 
(round(x x n- 0.5) / (n- 1)\), where “n” is the number of 
possible output values, and “x” is the input pixel color. Read 
more about this function. 


To implement this function in Blender, consider the node 
setup above. We string the Math nodes into a function that 
takes each color (values from 0 to 1), multiplies it up by six, 
the desired number of divisions (values become from 0 to 
6), offsets it by 0.5 (-0.5 to 5.5), rounds the value to the 
nearest whole number (produces O, 1, 2, 3, 4, 5), and then 
divides the image pixel color by five (0.0, 0.2, 0.4, 0.6, 0.8, 
1.0). 


In the case of a color image, you need to split it into 
separate RGB channels using Separate/Combine RGBA 
nodes and perform this operation on each channel 
independently. 


RGB to BW Node 


The RGB to BW Node maps an RGB color 
image to a gray-scale by the luminance. 


Y RGB to BW 


Inputs 


Image 
Color image input. 


Properties 


This node has no properties. 


Outputs 


Value 
Gray-scale value output. 


Value to Normal Node 


Computes a normal map. 


Y Value to Normal 


Normal 


& Val 0.000 
& Nabla 0.025 


Inputs 


Val 
The heightmap to compute the normal map from. 


Nabla 
Size of derivative offset used for calculating normals. 


Properties 


This node has no properties. 


Outputs 


Normal 
Standard normal output. 


Distort Nodes 


These nodes allow you to change the mapping of a texture. 


At Node 
Rotate Node 
Scale Node 
Translate Node 


At Node 


Returns the color of a texture at the 
specified coordinates. 


Texture 


Texture 


Coordinates: 
0.000 
0.000 
0.000 


Inputs 


Texture 
Standard color input. 


Coordinates 
The point at which to sample the color. For images, the 
Space is between -1 and 1 for X and Y. If the coordinates 
are not spatially varying, the node will return a single 
color. 


Properties 


This node has no properties. 


Outputs 


Texture 
Standard color output. 


Rotate Node 


Rotate the texture coordinates of an 
image or texture. 


Y Rotate 


Color 


@ Turns 0.000 


Inputs 


Color 
Standard color input. 


Turns 
The number of times to rotate the coordinates 360 
degrees about the specified axis. 


Axis 
The axis to rotate the mapping about. 


Properties 


This node has no properties. 


Outputs 


Color 


Standard color output. 


Scale Node 


Scale the texture coordinates of an 
image or texture. 


Y Scale 


Inputs 


Color 
Standard color input. 


Scale 
The amount to scale the coordinates in each of the three 
axes. 


Properties 


This node has no properties. 


Outputs 


Color 
Standard color output. 


Translate Node 


Translate the texture coordinates of an 
image or texture. 


Y Translate 


Inputs 


Color 
Standard color input. 


Offset 
The amount to offset the coordinates in each of the three 
axes. 


Properties 


This node has no properties. 


Outputs 


Color 
Standard color output. 


Input Nodes 


Input nodes provide input data for other nodes. 


Coordinates Node 
Image Node 
Texture Node 
Time Curve Node 


Coordinates Node 


Y Coordinates 


Coordinates 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Coordinates 
The Coordinates node outputs the geometry local 
coordinates, relative to its bounding box as RGB colors: 


e Red channel corresponds to X value. 
e Green channel corresponds to Y value. 
e Blue channel corresponds to Z value. 


Image Node 


The Image node can be used to load © 
an external image. 


Image 


la’ly + New 4 Oi 


Inputs 


This node has no inputs. 


Properties 


Image 
See Data-Block Menu. 


Outputs 


Color 
Standard color output. 


Texture Node 


The Texture node can be used to load 
another node-based or non-node- 
based texture. 


Y Texture 


fs 
Colorl 
Color2 


Inputs 


These two colors can be used to remap a grayscale texture. 


Color 1 
White Level. 


Color 2 
Black Level. 


Properties 


Texture 
The texture could be selected from a list of textures 
available in the current blend-file or link in textures. The 
textures themselves could not be edited in this node, but 
in the Texture panel. 


Outputs 


Color 
Standard color output. 


Time Curve Node 


The Time Curve node 
generates a factor value (from 
0.0 to 1.0) that changes 
according to the curve as time 
progresses through the 
Timeline. 


Y Time Curve 


Inputs 


This node has no inputs. 


Properties 


Curve 


The Y value defined by the curve is the factor output. For 


the curve controls see: Curve widget. 


Tip 


Flipping the curve around reverses the time input, but 
doing so is easily overlooked in the node setup. 


Start, End 
Start frame and End frame of the range of time 
specifying the values the output should last. This range 
becomes the X axis of the graph. The time input could be 
reversed by specifying a start frame greater than the end 
frame. 


Outputs 


Factor 
A speed of time factor (from 0.0 to 1.0) relative to the 
scene’s Frame Rate. The factor changes according to the 
defined curve. 


Hint 
Output values 


The Map Value node can be used to map the output to a 
more appropriate value. With sometimes curves, it is 
possible that the Time Curve node may output a number 
larger than one or less than zero. To be safe, use the 
Min/Max clamping function of the Map Value node to limit 
output. 


Example 


Time controls from left to right: no effect, slow 
down, freeze, accelerate, reverse. 


Output Nodes 


These nodes serve as outputs for node textures. 


e Output Node 
e Viewer Node 


Output Node 


This node contains the result of the 
node texture. 


Y Output 


Default 
Multiple output nodes can exist in a Color 
node texture, however, only one of 
them is active. The active one is set > 
in the Texture Panel in the Output 
selector. 


Inputs 


Color 
The color data that the texture renders. 


Properties 


File Path 
Output ID. 


Outputs 


This node has no outputs. 


Viewer Node 


The Viewer node can be used to 
preview the results of a node. 


Y Viewer 


Color 


Inputs 


Color 
Standard color input. 


Properties 


This node has no properties. 


Outputs 


This node has no outputs. 


Pattern Nodes 


e Checker Node 
e Bricks Node 


Checker Node 


The Checker node creates a 
checkerboard pattern. 


Y Checker 


Colorl 
Color2 


& Size 


Inputs 


Color 1, Color 2 
Image inputs setting the color of the squares. 


Size 
The scale of the checker pattern. 


Properties 


This node has no properties. 


Outputs 


Color 
Standard color output. 


Bricks Node 


The Bricks node creates a brick like 
pattern. 


Y Bricks 
Offset 
Frequency 
Squash 
Frequency 

Bricks 1 

Bricks 2 

Mortar 
Thickness 0.020 
Bias 0.000 
Brick Width 0.500 


Row Height 0.250 


Inputs 


Bricks 1, Bricks 2 
Sets the color range of the bricks. Brick colors are chosen 
randomly between these two colors. 


Mortar 
Sets the mortar color, in between the bricks. 


Thickness 
Sets the thickness of the mortar. 


Bias 


The bias of randomly chosen colors, between (-1 to 1). -1 
Makes all bricks Color 1, and a value of 1 makes them all 
Color 2. 


Brick Width 
Sets the horizontal size of all the bricks. 


Row Height 
Sets the vertical size of all the bricks. 


Properties 


Offset 
The relative offset of the next row of bricks. 


Frequency 
Offset every N rows. The brick pattern offset repeats 
every N rows. 


Squash 
Scales the bricks in every N rows by this amount. 


Frequency 
Squash every N rows. 


Outputs 


Color 
Standard color output. 


Texture Nodes 


These nodes generate procedural textures, and function just 
like their non-node-based counterparts. 


Common Options 


Color 1/Color 2 
Remaps the procedural texture with these colors. These 
do not function in the Magic node. 


Blend Node 

Clouds Node 
Distorted Noise Node 
Magic Node 

Marble Node 
Musgrave Node 
Noise Node 

Stucci Node 

Voronoi Node 

Wood Node 


Blend Node 


Linear 


Horizontal Vertical 


Color 1 


See Here. 


Clouds Node 


Y Clouds © 
Color 


Normal 


Blender Original 


Grayscale Color 


Soft Hard 
Depth 2 
Color 1 
Color 2 
@ Size 


See Here. 


Distorted Noise 


Y Distorted Noise © 


Color 


Normal 


Blender Original 
Blender Original 
Color 1 
Color 2 az 
@ Size 0.250 
& Distortion 1.000 


See Here. 


Node 


Magic Node 


Y Magic 


Noise Depth 


Color 1 


& Turbulence 5.000 


See Here. 


Marble Node 


Y Marble © 


Color 


Normal 


Soft Sharp Sharp... 
Soft Hard 


Blender Original 


Sin Saw 
Color 1 
Color 2 mz 
® Size 0.250 
& Turbulence 5.000 


See Here. 


Musgrave Node 


Y Musgrave © 


Color 


Normal 


Multifractal 


Blender Original 


Color 1 


H 1.000 


Lacunarity 2.000 
Octaves 2.000 
iScale 1.000 
Size 0.250 


See Here. 


Noise 


Color 1 


Color 2 


See Here. 


Stucci Node 


Y Stucci © 


Color 


Normal 


Plastic Wallin Wall... 
Soft Hard 


Blender Original 


Color 1 


@ Size 0.250 
& Turbulence 5.000 


See Here. 


Voronoi Node 


Y Voronoi © 


Color 


Normal 


Actual Distance 
Intensity 
Color 1 
Color 2 
W1 
Ww2 
W3 
Ww4 
iScale 


Size 


See Here. 


Wood Node 


Y Wood © 


Color 


Normal 


Blender Original 


Band Noise 
Sine Saw Tri 
Soft Hard 
Color 1 
Color 2 mz 
® Size 0.250 
& Turbulence 5.000 


See Here. 


Group 


Group Nodes are a collection of nodes that can be combined 
into a single node while selectively exposing inputs of the 
embedded nodes. Group nodes can simplify a node tree by 
allowing instancing and hiding parts of the tree. 


Make Group 


Creates a node group from the selected nodes, see Make 
Group for more information. 


Ungroup 


Removes the selected nodes from a group, see Ungroup for 
more information. 


Group Input 


Adds a group input node, this serves as a convenient way to 
re-add the input node in case it is accidentally deleted. 
Note, groups can only have one input, if more than one is 
added they are duplicates of each other. 


Group Output 


Adds a group output node, this serves as a convenient way 
to re-add the output node in case it is accidentally deleted. 
Note, groups can only have one output, if more than one is 
added they are duplicates of each other. 


Node Groups 


This section lists all the node groups either from the current 
blend-file or Linked or Appended from another blend-file. 


Geometry Node Editor 


The Geometry Node editor is used to edit a Node Group 
which is used by the Geometry Node Modifier. This node 
group can define many operations to modify an object’s 
geometry. 


A list of all Geometry Nodes is available in the modeling 
section. 


Interface 


Header 
View 
Standard view menu. 


Select 
Menu for Selecting Nodes. 


Add 
Menu for adding new Geometry Nodes. 


Node 
Menu for Editing Nodes. 


Geometry Node Group 
The data-block selector can change the active node 
group being edited. 


Pin (pin icon) 


The pin button will keep the current geometry node 
group selection fixed, instead of using the Active 
Modifier. When a geometry node group is pinned, it will 
remain visible in the Geometry Node editor even when 
another object or modifier is selected elsewhere. 


Parent Node Tree 


Jumps up a node group level, see Edit Group for more 
information. 


Snapping 
Controls to control snapping when transforming nodes. 


Toolbar 


The Geometry Node editor has several tools to work with 
tools that can be accessed from the Toolbar. 


Sidebar 
Node 


This tab allows you to edit the geometry node group’s 
inputs and outputs. 


Tip 


The inputs of the node group can be edited as properties 
of the Geometry Node Modifier. 


Item 


This tab gives access to the active node’s properties. 


Tool 
This tab gives access to the active tool’s settings. 
View 


This tab gives access properties that affect editor data such 
as annotations. 


Shader Editor 


The Shader Editor is used to edit materials which are used 
for . Materials used by Cycles and Eevee are 
defined using a node tree. Therefore, the main window of 
the Shader editor is a 


View Select Add Node ™# Use Nodes Slot ’ ©. Material 
Y¥ Node 


(\ PrindpledBSDOF_ ~~ v Name [" Principled BSDF 
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Tool Item 


> Color 


View 


» Properties 
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¢@ Anisotropic: 
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0.030 
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e Transmission 


sion Roughness: 


Material | "9 


Shader Editor with the default material node tree. 


A list of all is available in the rendering 
section. 


Header 


Use Nodes 
The Use Nodes setting is mostly a legacy setting and 
should always be checked for materials. 


Slot 
The S/ot menu can be used to select the active material 
Slot on the active object. The material selector to the 
right of it can change the material that is in the selected 
Slot. 


Pin (pin icon) 
The pin button will keep the current material selection 
fixed. When a material is pinned, it will remain visible in 
the Shader editor even when another object or material 
is selected elsewhere. 


Sidebar 
Options 


The Options panel in the Sidebar region contains the same 
settings that are also available in the Material tab in the 
Properties. They differ depending on the selected render 
engine. The settings are duplicated to make it possible to 
edit the entire material from the Shader editor. 


Video Sequencer 


e Introduction 
o Editor Layout 


o View Types 
o Performance 


View Types 


e Sequencer 
o Introduction 
o Channels 
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Display 
Toolbar 
Sidebar 
e Preview 
Introduction 
Header 
Toolbar 
Sidebar 
Controls 
Display 
e Sequencer & Preview 
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Introduction 


Blender is a versatile software used for modeling, sculpting, 
2D drawing, animation, and video editing. Most of the work 
is done in so-called editors: tools for viewing and modifying 
your work through a specific part of Blender. 


There are a couple of editors that can manage video: the 
Compositor, the Movie Clip Editor, the Image Editor (only for 
still images), and the Video Sequencer. 


This section describes only the interface of the Video 
Sequencer, to read more about usage of the Video 
Sequencer read the Video Editing section. 


Editor Layout 


The Video Sequencer is composed of multiple regions (see 
figure 1). They are described in more detail in the next 
sections. Figure 1 shows the combined Sequencer & Preview 
view type. This view can be broken up into the following 
regions: 


S. “">+., View Type Preview 
i selector 


Editor Type 
selector 


co 
2 
8 
= 


Sequencer 


Properties 


Figure 1: Sequence Editor shown in the Sequencer & 
Preview view type. 


Header (red), Preview (yellow), Sequencer (blue), 
Properties (gray), Panels & Tabs (yellow), Toolbar 


(purple). 


Header 
This region displays menus and buttons for interacting 


with the editor. The header changes slightly depending 
on the selected view type (see below). 


Preview 
This region shows the output of the Sequencer at the 


time of the Playhead. 


Sequencer 
This region shows timeline for managing the montage of 


Strips. 


Properties 


This region shows the properties of the active strip. Is 
divided into panels and tabs. Toggle on or off with N key. 


Toolbar 
This region shows a list of icons, clicking on a icon will 
changes the active tool. Toggle on or off with T key. 


View Types 


The Video Sequencer has three view types which can be 
changed with the View Type menu (see figure 1; top left). 
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| 
| 
| 
| 
| 
| 
! 
y 


== = = 


<——————_— 


Figure 2: Three view types for the Video Sequence 
Editor 


Sequencer 
View timeline and strip properties. 


Preview 
View preview window and preview properties. 


Sequencer & Preview 
Combined view of preview and timeline and properties of 
both. 


Tip 


It is possible to create multiple instances of any view type 
in single workspace. 


Performance 


Playback performance can be improved through several 
ways. The biggest impact on performance is to allow the 
Video Sequencer to cache the playback. There are two 
levels of cache, the first is a RAM cache, this is enabled by 
default but can be increased based on the amount of RAM 
available. The next level of cache is a disk cache which 
stores cached strips on disk. A disk cache can generally 
cache more than a RAM cache, but it can be slower. Both of 
these cache options can be configured in the Preferences. 


Another way to improve performance is by using Strip 
Proxies. These are used to cache images or movies in a file 
that is easier to playback by reducing the image quality by 
either decreasing the resolution and/or compressing the 
image. 


Sequencer 


The Sequencer is composed of two areas (see figure 1). The 
header is shown in a yellow outline and the timeline with a 
red outline. Optional, there can be a Toolbar at the left anda 
Sidebar at the right; in figure 1 they are collapsed. 
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Figure 1: Sequencer and components 


Although the Sidebar and Toolbar belong to the Timeline 
area, they are discussed in a separate section. 
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Introduction 


This Sequencer view is where strips can be selected, 
modified by moving, cutting, or extending strips. There are 
also several built-in effects that can be combined with other 
strips to change their appearance. 


The Sequencer view is horizontally divided into Channels 
each channel can contain what is called a strip. A strip can 
be an image, animation, or any number of effects. Each 
channel is numbered consecutively on the Y axis, starting 
from zero and allows up to 128 total channels. The X axis 
represents time. Each channel can contain as many strips as 
it needs as long as they do not overlap. If a strip needs to 
overlap another, it needs to be placed on a channel above 
or below the other strip. When strips are stacked, they stack 
from bottom to top where the lowest channel forms the 
background and the highest the foreground. 


Note 


The first channel 0 is unusable as a place to put strips. This 
is because it is used by the Sequencer Display to show a 
composite of all strips above channel 0. 


Channels 


Channels are horizontal tracks of along the timeline that 
contain content called Strips. A strip can be an image, 
animation, or any number of effects. Each channel is 
numbered consecutively on the Y axis, starting from 1 and 
allows up to 128 total channels. The X axis of each channel 
represents time. Each channel can contain as many strips as 
it needs along the time axis as long as they do not overlap. 
If a strip needs to overlap another, it needs to be placed on 
a channel above or below the other strip. 


Channel Region 


The Channel region can be found on the left side of the 
timeline. It is used to organize channels and control 
channels as a whole. The visibility of this region can be 
toggled with View > Channels 


Name 
The name of the channel, this can be changed to help 
with project organization by double clicking on the name. 


Mute Channel 
Disable all the strips in the channel from having an affect 
on the render. Note that individual strips can also be 
muted which is different than muting the whole channel. 


Lock Channel 
Prevent any modifications the strips in the channel. Note 
that individual strips can also be locked which is different 
than locking the whole channel. 


Navigating 


Header 


~~, & Sequencer vy View Select Marker Add _ Strip 


[ | 


Video Sequencer Header. 


View Menu 


As usual, the View Menu controls the editor’s view settings. 


Sidebar N 
Show or hide the Sidebar. 


Toolbar T 
Show or hide the Toolbar. 


Adjust Last Operation 
Displays a pop-up panel to alter properties of the last 
completed operation. See Adjust Last Operation. 


Channels 
Show or hide the Channel Region. 


Preview as Backdrop 
Displays the current frame in the background of the main 
view like in the Compositor. 


Frame Selected NumpadPeriod 
Zooms in the display to fit only the selected strips. 


Frame All Home 
Zooms the display to show all strips. 


ZOOM Shift-B 
Click and drag to draw a rectangle and zoom to this 
rectangle. 


Limit View to Contents 
Limit the timeline’s height to the maximum used channel 
Slot. 


Navigation 
Play Animation Spacebar 
Start or stop playback of animation. This will start 
playback in all editors. 


Go to Current Frame Numpado 
Scrolls the timeline so the current frame is in the 
center. 


Jump to Previous Strip PageDown 
Current frame will jump to beginning of strip. 


Jump to Next Strip PageUp 
Current frame will jump to end of strip. 


Jump to Previous Strip (Center) Alt-PageDown 
Jump to previous center of the strip. 


Jump to Next Strip (Center) Alt-PageUp 
Jump to next center of the strip. 


Range 
Set Preview Range P 
Interactively define frame range used for playback. 
Allows you to define a temporary preview range to use 


for animation playback (this is the same thing as the 
Playback Range option of the Timeline editor header). 


Set Preview Range to Strips 
Sets the frame range of preview to the range of the 
selected strips. 


Clear Preview Range Alt-P 
Clears preview range. 


Set Start Frame Ctrl-Home 
Set Start of animation range to the current frame. 


Set End Frame Ctrl-End 
Set End of animation range to the current frame. 


Set Frame Range to Strips 
Sets the frame range of preview and render animation 
to the frame range of the selected strips. 


Refresh All 
To force Blender to re-read in files, and to force a re- 
render of the 3D Viewport, click the Refresh Sequencer 
button. Blender will update and synchronize all cached 
images and compute the current frame. 


Certain operations, like moving an object in the 3D 
Viewport, may not force the Sequencer to call for a 
refresh of the rendered image (since the movement may 
not affect the rendered image). If an image or video, 
used as a strip, is changed by some application outside 
of Blender, Blender has no real way of being notified from 
your operating system. 


Sync Visible Range 
Synchronize the visible range with other time based 
editors. 


Show Seconds Ctrl-T 
Shows seconds instead of frames on the time axis. 


Show Markers 
Shows the markers region. When disabled, the Markers 
Menu is also hidden and markers operators are not 
available in this editor. 


Show Cache 
Show which frames are Cached Show all enabled types; 
Final Images, Raw Images, Preprocessed Images, 
Composite Images 


In order for this property to be visible, enable Developer 
Extras. 


Sequence Render Image 
Render an image of the current frame. 


Sequence Render Animation 


Render timeline from Preview Start to Preview End Frame 
to a Video file or series of images. 


Export Subtitles 
Exports Text strios, which can act as subtitles, toa 
SubRip file (.srt). The exported file contains all Text strips 
in the video sequence. 


Toggle Sequencer/Preview Ctrl-Tab 


Switch the editor display type between Sequencer and 
Preview. 


Markers Menu 


Markers are used to denote frames with key points or 
significant events within an animation. Like with most 
animation editors, markers are shown at the bottom of the 
editor. 


Start Walk a® Camera 1 
A a 


Markers in animation editor. 


For descriptions of the different marker tools see Editing 
Markers. 


Main View 


Adjusting the View 


Use these shortcuts to adjust the sequence area of the 
editor: 


e Pan: MMB 

e ZOOM: Wheel 

e Vertical Scroll: use Shift-Wheel, or drag on the left 

scrollbar. 

Horizontal Scroll: use Ctrl-Wheel, or drag on the lower 

scrollbar. 

e Scale View: Ctrl-MMB and drag up/down (vertical scale) or 
left/right (horizontal scale). 

e Scale View Vertically: drag on the circles on the vertical 
scrollbar. 

e Scale View Horizontally: drag on the circles on the 
horizontal scrollbar. 


Playhead 


The Playhead is the blue vertical line with the current frame 
number at the top. It can be set or moved to a new position 
by pressing or holding LmMB in scrubbing area at the top of the 
timeline. You can move the Playhead in increments by 
pressing Left Or Right, or by using Alt-Wheel. You can also 
jump to the beginning or end frame by pressing Shift-Left or 
Shift-Right. AS you do, the image for that frame is displayed 
in the Preview region. 


When you drag the frame indicator with Shift-RmB directly on 
a sequence strip, this will show the strip so/o, (temporarily 
disregarding effects and other strips, showing only this 
Strip’s output) and the strip will be highlighted. 


When holding ctrt while dragging it will snap to the start 
and endpoints of strips. 


Real-time preview is possible on reasonable computers 
when viewing an image sequence or movie (avi/mov) file. 
Scene strips can use viewport previews or proxies for real- 
time playback, otherwise displaying rendered frame is 
supported, but typically too slow for real-time playback. 


Hint 


Every other synced editor can be used for scrubbing e.g. 
the Timeline. 


Display 


Reference 
Mode: All Modes 
Header: Overlays 


Sequencer Overlays 


Overlays are information that is displayed on top of the strip 
region. There is a toggle to display or hide all overlays for 
the strip region. 


Name 
Shows the Name on the strip. 


Source 
Shows the path to the strip file on the strip. 


Duration 
Shows the length of the strip in frames on the strip. 


Offsets 
Shows overflow bars of “extra” content from either 
cutting or sliding strips. 


F-Curves 
Show animation curves for opacity and volume values as 
darkened sections of the strip. 


Thumbnails 
Displays a preview of the strip contents on top of the 
strip for movie and image strips. To draw thumbnails, this 


overlay has to be enabled and the strip’s height must be 
tall enough. See the User Interface documentation on 
how to adjust the height of strips. 


The larger the strip’s height the bigger the thumbnails 
are displayed. The number of thumbnails displayed 
depends on the thumbnail size and the strip length 
(which depends on the zoom level). 


Grid 
Show vertical and horizontal lines in the sequence 
timeline to add visual separation and a dimension of 
scale to the timeline. 


Waveform Display 
Global options for waveform display on Sound strips. 


Waveform Off: Disable waveforms for all strips. 
Waveform On: Enable waveforms for all strips. 
Use Strip Option: 
Set waveform per strip configured with 
Display Waveform. 


Toolbar 


e Introduction 
e Blade 


Introduction 


Select 
Select or move. 


Select Box 
Select strip by dragging a box. 


Blade 
Create a cut along the strip. 


Blade 


Reference 

Mode: Sequencer Mode 
Tool: Toolbar > Blade 
Shortcut: Shift-K 
Soft 


This cuts the strip in two at the location of the click. This 
will result in two strips which use the same source, fitting 
the original strip’s timing and length. 


Hard 


Like Soft Blade, it cuts a strip in two distinct strips; but 
you will not be able to drag the endpoints to show the 
frames past the cut of each resulting strip. 


Compositing 
Transform 
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Strip 


Header 


Type 
Strip type represented by an icon. 


Name 
You can name or rename your strips here. 


Color Tag 


Besides the set of Default Strip Colors strips can also 
be given an alternative predefined color. This can be 
useful to help organize your sequence by for example, 


giving a special color to all graphic overlays and a 
different color for footage. 


Mute 
If enabled the strip will not produce any output. 


Compositing 

Reference 

Panel: Sidebar > Strip » Compositing 
Blend 


Mode of blending strip with lower channels. 


Opacity 
Set the opacity (alpha) of the strip. This value, when 
animated and with the View » Show F-Curves option 


turned on, is drawn on the strip as a dark section that 
follows the animation curve. 


Transform 
Reference 
Panel: Sidebar » Strip >» Transform 
Filter 
Interpolation Methods. 
Nearest: No interpolation, uses nearest 
neighboring pixel. 
Bilinear: Simple interpolation between adjacent 
pixels. 
Position X, Y 


Used to move the frames along the X and Y axis. 


Scale X, Y 
Scale the image on the X and Y axis. 


Rotation 
Rotates the input two-dimensionally along the Z axis. 


Mirror 
Mirrors the image along the X axis (left to right) or the Y 
axis (top to bottom). 


Crop 


Reference 


Panel: Sidebar > Strip >» Crop 


Used to crop the source image. Use Top, Left, Bottom, and 
Right to control the number of pixels that are cropped. 


Video 


Reference 


Panel: Sidebar > Strip >» Video 


Strobe 
To only display each nth frame. For example, if you set 
this to 10, the strip will only display frames 1, 11, 21, 31, 
41... of the source. Strobe is a float value - this way you 
can get a strobe effect synced exactly to a beat, for 
example, by using non-integer values. 


Reverse Frames 
Strip is played backwards starting from the last frame in 
the sequence. 


Color 


Reference 


Panel: Sidebar » Strip >» Color 


Saturation 
Increase or decrease the saturation of an image. 


Multiply 


Multiplies the colors by this value. This will increases the 
brightness. 


Convert to Float 
Converts input to float data. 


Sound 


Reference 


Panel: Sidebar » Strip » Sound 


Volume 
The volume of the sound. This value, when animated and 
with the View > Show F-Curves option activated, is drawn 
on the strip as a dark section that follows the animation 
curve. The value is also reflected in the waveform. 


Pan 
Used to pan the audio between speakers in multichannel 
audio. Only works for mono sources. The number of audio 
channels can be configured in the Audio Output settings. 
For stereo output panning works from left (-1) to right (1). 
When the output uses more than two channels, values 
can be between -2 and 2, where 0 means front/center, -1 
means to the left and 1 to the right. To address rear 
speakers, you can pan to those with the higher values: 
-2, 2 is back. This value basically represents the angle at 
which it’s played if you multiply the value by 90 degrees. 
For smooth animation you can assign values outside the 
soft bounds, since the angle wraps around over multiple 
rotations. 


Display Waveform 


Display an approximate waveform of the sound file inside 
of the Sound strip. The waveform reflects strip volume 
and its animation using keyframes. 


Mono 
Mixdown all audio channels into a single one. 


Time 


Reference 


Panel: Sidebar > Strip >» Time 


The Time panel is used to control source and timeline 
position of the strip. 


Lock (padlock icon) 
Prevents the strip from being moved (found in the panel 
header). 


Channel 
Changes the channel number, or row, of the strip. 


Speed Factor 
Coefficient of playback speed. This value will affect 
length of the strip, that will not be represented in the 
timeline. 


Start 
Changes the starting frame number of the strip, which is 
the same as selecting and moving the strip. 


Duration 
Changes the length, in frames of the strip. This works by 
changing the end frame, which is the same as selecting 


and moving the strip’s right handle. 


End 
Specifies the ending time and ending frame number for 
the strip. 


Strip Offset Start/End 
Can be used to either extend the strip beyond the end 
frame by repeating the last frame. Or it can be used to 
shorten the strip, as if you were cropping the end frame. 
This is the same as adjusting the strip handles. 


Hold Offset Start/End 
Offset of the uncut strip content. 


Current Frame 
The frame number relative to the start of the active strip. 


Source 


Reference 


Panel: Sidebar > Strip » Source 


The Source panel is used to control sources of the strip such 
as filename and file path and various methods of 
interpreting these files. 


Path 


The directory that contains the source file. When the file 
is moved this can be updated instead of re-create the 
Strip. 


File 


The file name of the source file. For image strips showing 
an image sequence, this will be different for each frame. 


Change Data/Files 


Same as the Path and File fields, but this time combined 
to open the File Browser in order to find the file(s) you 
search. Same as Strip > Inputs » Change Paths/Files. 


MPEG Preseek 


Movie strip only - Use Preseek field to tell Blender to look 
backward and compose an image based on the specified 
amount of previous frames (e.g. 15 for MPEG-2 DVD). 


Color Space 
To specify the color space of the source file. 


The list of color spaces depends on the active OCIO 
config. The default supported color spaces are described 
in detail here: Default OpenColorlO Configuration 


Alpha Mode 


If the source file has an Alpha (transparency) channel, 
you can choose: 


Straight Aloha or Premultiplied Alpha 


Stream Index 


Movie strip only - For files with several movie streams, 
use the stream with the given index. 


Deinterlace 
Removes fields in a video file. For example, if it is an 
analog video and it has even or odd interlacing fields. 


Source Information 
Displays information about the strip’s media. 


Resolution 
Resolution of the active strip image output. 


FPS 
Movie strip only - The frame rate encoded into the 
video file. If this value does not match the scene 
Frame Rate the perceived speed of the media will be 
wrong unless the speed is changed to account for the 
difference in frame rate. 


Options for Sound Strips 


Sound 
Data-block menu to select a sound. 


Path 
Path to the sound file used by this data-block menu. 


Pack 
Pack sound into the blend-file. 


Caching 
Sound file is decoded and loaded into the RAM. 


Source Information 
Displays information about the strip’s media. 


Samplerate 
The number of samples per second the audio is 
encoded at. 


Channels 
The number of audio channels encoded into the audio 
stream. 


Modifiers 


Reference 
Panel: Sidebar region > Modifiers >» Modifiers 

aes Y Modifiers a 
Modifiers are used to make 5 
adjustments on the image, Use Linear Modifiers @ * 7 
like contrast, brightness, Add Strip Modifier z 
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—_ Mask Input Type Strip 
You can add these modifiers 


directly to the selected strip, 
or you can use it within an 
“Adjustment Layer” effect 
Strip, which allows you to 
apply these modifiers onto 
several strips the same time. 
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Use Linear Modifiers 
Calculate modifiers in 
linear space instead of 
sequencer space. 


Copy to Selected Strips 
Allows you to copy the modifiers to selected strips. This 
works two ways, you can either replace the old modifiers 
or append/add to the previous modifiers. 


Common Options 


Each modifier has several buttons at its top: 


Mute (eye icon) 


Disables the modifier. Very useful to compare the image, 


with / without modifications. 


Move (up/down arrow icon) 
The next two buttons are used to change the modifier’s 
position in the stack. 


Remove xX 
The cross is to delete the modifier from the stack. 


Input Mask Type 


Strip 


Use this to apply the modification on the whole image, or 


to use another strip’s image (with alpha channel) for 
masking the modifier (and only this modifier), by 
choosing it in the “Mask” select menu. 

Mask 
This allows you to choose a Mask created in the Mask 


editor which will limit the modification to the masked 
image’s zones. 


Types 
Currently, the following modifiers are supported: 


Bright/Contrast Modifier 
Adjusts the brightness and contrast of the modifier input. 


Color Balance Modifier 


Color balance adjustments, either by the Lift, Gamma, and 
Gain or the Slope, Offset and Power method. 


This modifier works similar to the Color Balance Node. 


Depending on the selected ¥ Color Balance 
method, the following Mask input Tyoe EEE 
operations can be applied to 

the color values in the Mask 
sequencer color space: Multiply Colors 1.000 


Correction Met Lift'Gamma/Gain ve 


Lift/Gamma/Gain 
Lift 
Increases the value of = 
dark colors. 


Gamma 
Adjusts midtones. 


Gain = 


Adjusts highlights. 


Offset/Power/Slope (ASC-CDL) 
The following formula is a 
applied to each RGB color - 
value separately: \(c_{out} 
= (c_{in}*s + 0)*p\) 


Slope 
The multiplier \(s\) influences all color values except 
black. Its effect is stronger the brighter the source 
color is. 


Offset 
Shifts color values after applying Slope by adding the 
Offset \(o\) to them. Note that the selected value 


shown in the UI will be subtracted by 1, so the default 
value of 1 means effectively no offset is applied. 


Power 
Over-all exponent \(p\), which mainly adjusts the 
midtones. 


Curves Modifier 


Color and RGB curves. 


This modifier works the same as the Curves Node. 


Hue Correct Modifier 


HSV multi points curves. 


This modifier works the same as the Curves Node. 


Mask Modifier 


Use it for masking the other modifiers in the stack which are 
below. 


For example, to correct the brightness only on a certain 
zone of the image, you can filter the Bright/Contrast 
modifier by placing a Mask modifier, just before it in the 
stack. You can choose to use a Mask created in the Mask 
editor, or to use another strip as a mask (the image of this 
Strip must have an alpha channel). This mask will be applied 
on all the others modifiers below it in the stack. 


Tone Map Modifier 


Used to map one set of colors to another in order to 
approximate the appearance of high dynamic range images 
in a medium that has a more limited dynamic range. 


This modifier works the same as the Jone Map Node. 


White Balance Modifier 


Use it to adjust the white balance by choosing the color that 
should be white. 


Cache 


The Cache is used to save frames in memory for preview, so 
they can be later displayed much faster than rendered from 
scratch. Cache capacity can be set in System tab of the 
Preferences. 


In order for this tab to be visible, enable Developer Extras. 


See also 


Which frames are cached can be visualized by enabling 
Show Cache. 


Cache Settings 


Reference 


Panel: Sidebar >» Cache » Cache Settings 


In this panel you can set up types of images that will be 
cached for all strips. 


Cache 
Raw 
Cache raw images read from drive, for faster tweaking 
of strip parameters at the cost of memory usage. 


Pre-processed 
Cache preprocessed images, for faster tweaking of 
effects at the cost of memory usage. 


Composite 
Cache intermediate composited images, for faster 
tweaking of stacked strips at the cost of memory 
usage. 


Final 
Cache final image for each frame. 


Strip Cache 


Reference 


Panel: Sidebar >» Cache » Cache Settings 


This panel sets the types of images that will be cached for 
the active strip. Enable overriding the cache defaults, when 
disabled, Cache Settings will be used. 


Cache 
Raw 
Cache raw images read from drive, for faster tweaking 
of strip parameters at the cost of memory usage. 


Pre-Processed 
Cache preprocessed images, for faster tweaking of 
effects at the cost of memory usage. 


Composite 
Cache intermediate composited images, for faster 
tweaking of stacked strips at the cost of memory 
usage. 


Proxy 


Proxy Settings 


Reference 
Panel: Sidebar region > Proxy & Timecode » 
Proxy Settings 
Storage 


Defines whether the proxies are for individual strips or 
the entire sequence. 


Per Strip 
Proxies are stored in the directory of the input. 


Project 
All proxies are stored in one directory. 


Proxy Directory 
The location to store the proxies for the project. 


Set Selected Strip Proxies 
Set proxy size and overwrite flag for all selected strips. 


Rebuild Proxy and Timecode Indices 


Generates Proxies and Timecodes for all selected strips, 


Same as doing Strip » Rebuild Proxy and Timecode 
Indices. 


Strip Proxy & Timecode 


Reference 


Panel: Sidebar region > Proxy & Timecode » 
Strip Proxy & Timecode 


Y ™ Strip Proxy & Timecode 


Once you have chosen the 


Prox [Timecode options, you Proxy Custom Directory 
need to select all strips for Proxy Custom File 


which you want proxies to be % 75% 
built. Then use Strip >» Rebuild 

Proxy and Timecode Indices, or 
button in Proxy Settings panel. 

Once all proxies are built, they 

will be ready to use. 


100% 
Overwrite 
Build JPEG Quality 90 


Timecode Index NoTCinuse 


In order to use proxies, you 
have to select matching Proxy Render Size in the Sequencer 
preview Sidebar panel. 


Custom Proxy 
Directory 
By default, all generated proxy images are storing to 
the <path of original footage>/BL_proxy/<clip name> 
folder, but this location can be set by hand using this 
option. 


File 
Allows you to use pre-existing proxies. 


Resolutions 


Buttons to control how big the proxies are. The available 
options are 25%, 50%, 75%, 100 percent of original strip 
size. 


Overwrite 


Saves over any existing proxies in the proxy storage 
directory. 


Quality 
Defines the quality of the images used for proxies. 


Timecode Index 
When you are working with footage directly copied from 
a camera without pre-processing it, there might be bunch 
of artifacts, mostly due to seeking a given frame in 
sequence. This happens because such footage usually 
does not have correct frame rate values in their headers. 
This issue can still arise when the source clip has the 
same frame rate as the scene settings. In order for 
Blender to correctly calculate frames and frame rate 
there are two possible solutions: 


1. Preprocess your video with e.g. MEncoder to repair 
the file header and insert the correct keyframes. 
2. Use Proxy/Timecode option in Blender. 


None: Do not use any timecode. 

Record Run: Use images in the order they are 
recorded. 

Free Run: Use global timestamp written by 


recording device. 

Free Run (Rec Date): 
Interpolate a global timestamp using 
the record date and time written by 
recording device. 

Record Run No Gaps: 
Record run, but ignore timecode, 
changes in frame rate or dropouts. 


Note 


Record Run is the timecode which usually is best to use, 
but if the source file is totally damaged, Record Run No 


Gaps will be the only chance of getting acceptable 
result. 
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Introduction 


Sequencer preview is used to display result of rendering 
Sequencer timeline. This can be further configured to 
display output from certain channel, overlay or image 
analyzer (scope). 


The Preview contains two regions (see figure 1), the Header 
is shown in a yellow outline with the Preview (red outline) 
underneath. This Preview has no fixed dimensions; you can 
zoom in or move indefinitely. However, in figure 1 you see a 
checkered area (green outline). This preview has the aspect 
ratio of the Project Dimensions; e.g. 1920 x 1080 pixels in 
figure 1. But, because the source strip could be scaled ina 
different resolution, the yellow outline shows the area that 
the source strip occupies. AS you can see, the Open movie 
“Spring” has a different resolution than the project and 
letterboxes are added at the top and bottom of the image. 


In contrast with the Sequencer View example, both the 
Toolbar and Sidebar are expanded in figure 1. The gizmos 
however are unique for the Preview. 


Figure 1: Preview window of VSE. 


Sequencer preview is used to display result of rendering 
Sequencer timeline. This can be further configured to 
display output from certain channel, overlay or image 
analyzer (Scope). You can adjust the view by zooming in 
with NumpadPlus and zoom out with NumpadMinus. 


Gizmos 


You can use gizmos to pan and zoom image in the 
Sequencer preview region. 


See Gizmos to manage the visibility of gizmos. 


Header 


Sequencer Display header. 


View Menu 


Sidebar N 
Show or hide the Sidebar. 


Toolbar T 
Show or hide the Toolbar. 


Preview During Transform 


Show a preview of the start or end frame while 
transforming a strip’s start/end handles. 


Frame Selected 


Zoom and position the bounding box of the selected 
image into the center of the preview. 


Fit Preview in Window Home 
Resize the preview so that it fits in the area. 


ZOOM Shift-B 


Click and drag to draw a rectangle and zoom to this 
rectangle. 


Fractional Zoom 
Resize the preview in steps from 1:8 to 8:1. 


Refresh All 
To force Blender to re-read in files, and to force a re- 
render of the 3D Viewport, click the Refresh Sequencer 
button. Blender will update and synchronize all cached 
images and compute the current frame. 


Certain operations, like moving an object in the 3D 
Viewport, may not force the Sequencer to call for a 
refresh of the rendered image (since the movement may 
not affect the rendered image). If an image or video, 
used as a strip, is changed by some application outside 
of Blender, Blender has no real way of being notified from 
your operating system. 


Sequence Render Image 
Render the image at the current frame. 


Sequence Render Animation 
Render timeline from Preview Start to Preview End Frame 
to a Video file or series of images. 


Export Subtitles 
Exports Text strios, which can act as subtitles, to a 
SubRip file (.srt). The exported file contains all Text strips 
in the video sequence. 


Toggle Sequencer/Preview Ctrl-Tab 
Switch the editor display type between Sequencer and 
Preview. 


Display Mode 


See Display Mode. 


Display Channels 


Color and Alpha 
Display preview image with transparency over 
checkerboard pattern. 


Color 
Ignore transparency of preview image (fully transparent 
areas will be black). 


Overlays 


See Preview Overlays. 


Toolbar 


Tweak w 
Perform a multiple actions; first of it can be select images 
and by consequence their associated strip. Second it can 
move strips using the same principles as the Move tool. 
Using the shortcut w, will cycle between this tool and 
other sub-tools described below. 


Select Box B 
Selects images within a rectangular box drawn in the 
Preview area. 


To use the tool, LMB and drag within the preview area 
to draw a rectangle, releasing the mouse confirms the 
selection. 


You can also just LMB to preform a normal single item 
selection. 


Cursor 
Changes the location of the 2D Cursor. 


To use the tool, LMB within the preview area to move the 
cursor to that position. You can also click and drag to 
interactively position the cursor. 


The movement of the cursor can be constrained along 
the global/local X or Y axis by pressing xX or Y, pressing 
the hotkeys will cycle between global/local orientations 
and disabling constraints. 


Holding Shift will move the cursor in smaller increments 
for more precision. You may also type in an exact amount 


to move for absolute precision. 


While the operation is running a message will display in 
the header indicating the distance in pixels the cursor 
has moved in each of the cardinal directions. The third 
number, between parenthesis, is the Euclidean distance 
the cursor has moved. 


Move G 
Changes the location of the selected image by adjusting 
the strip’s Position properties. 


To use the tool, LB on the image and drag it to the 
desired position. If Active Tools is enabled, you can also 
move the image by dragging the gizmo. 


The movement of the image can be constrained along 
the global/local X or Y axis by pressing xX or Y, pressing 
the hotkeys will cycle between global/local orientations 
and disabling constraints. 


Holding shift will move the image in smaller increments 
for more precision. You may also type in an exact amount 
to move for absolute precision. 


While the operation is running a message will display in 
the header indicating the distance in pixels the image 
has moved in each of the cardinal directions. The third 
number, between parenthesis, is the Euclidean distance 
the image has moved. 


Rotate R 
Moves the selected image’s in a circle about the Pivot 
Point by adjusting the strip’s Rotation property. By 
default, the image will rotate around its median but this 
can be changed by changing the Pivot Point. 


To use the tool, LMB on the image and drag it (in a circle) 
to the desired position. The further away the mouse 
cursor is from the Pivot point, the slower the rotation 
movement is. You can also use the Arrow-keys to move 
the handle very precisely. If Active Tools is enabled, you 
can also rotate the image by dragging the gizmo. 


Holding Shift will rotate the image in smaller increments 
for more precision. You may also type in an exact amount 
to move for absolute precision. 


While the operation is running a message will display in 
the header indicating the amount of rotation in the 
scene’s rotation unit. 


Scale s 
Changes the size of the image by adjusting the strip’s 
Scale properties. The scaling use the Pivot Point as 
reference. So, for example, if the Pivot Point is set to 2D 
Cursor, scaling down a strip will also move the strip in 
the direction of the 2D cursor. 


To use the tool, LB on the image and drag it to the 
desired size. The further away the mouse cursor is 
initially from the Pivot point, the more precise the scaling 
is. You can also use the Arrow-keys to adjust the scale 
very precisely. If Active Tools is enabled, you can also 
scale the image by dragging the gizmo. 


The scale of the image can be constrained along the 
global/local X or Y axis by pressing x or Y, pressing the 
hotkeys will cycle between global/local orientations and 
disabling constraints. 


Holding Shift will scale the image in smaller increments 
for more precision. You may also type in an exact amount 


to scale for absolute precision. 


The amount of scaling is relative meaning a scale value 
of 0.4 will scale the image to 40% of its size. 


While the operation is running a message will display in 
the header indicating the amount the image has been 
scaled in each of the cardinal directions. 


Transform 
Supports any combination of the moving, rotating, 
scaling at the same time. In the figure below, the 
Transform tool is enabled and strip 3 selected. 
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The Transform tool 


With the four squares at the corners of the strip, you can 
scale the strip. The circle on top is for rotating and the 
crosshair in the middle is for moving the strip. 


Sample 
Used to sample a pixel’s color from the preview. 


To use the Sample tool, LMB anywhere in the preview. 
Information about the pixel under the mouse cursor is 


shown in an overlay at the bottom of the editor. 


In the order of appearance, the following information is 
shown: 


e The X and Y coordinates of the clicked pixel. 
Remember that the left bottom corner is location (0, 
0). 

e The values for the red, green, and blue component as 
from the color picker. 

e The alpha value of the pixel. 

e The color-managed values of the red, green, and blue 
component (the color as you see in the preview). 

e The hue, saturation, value, and luminance equivalent 
values of the color-managed values. 
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Sample tool example. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 


Erase previous drawn annotations. 


Sidebar 


The sidebar of the Preview can be toggled with the menu: 
View >» Sidebar or with the shortcut N. 


Video Sequence Editor with two sidebars: Preview and 
Sequencer. shows the sidebar of the Preview, but also the 
sidebar of the sequencer. In the Preview sidebar, the View 
tab is active and all panels are expanded. Safe Areas are 
enabled and an Annotation is added. 


Video Sequence Editor with two sidebars: Preview 
and Sequencer. 


Tool 


Reference 


Editor: Video Sequencer 
View Type: Preview 


Panel: Sidebar > Tool tab 


Displays information about the active tool. 
View 


View Settings 


Reference 

Editor: Video Sequencer 

View Type: Preview 

Panel: Sidebar > View tab >» View Settings 


Proxy Render Size 
Size to display proxies at in the preview region. Using a 
smaller preview size will increase speed. 


No Display: Disables the preview. 
Scene Size: Matches proxy size to the final render 
resolution. 


25%, 50%, 75%, 100%: 
Proxies are sized to be the selected 
percent of the original input. 


Use Proxies 
Use optimized files for faster scrubbing when available. 
Proxies limit the visual accuracy of the preview by 
reducing the preview resolution and using compressed 
copies of the input. 


Prefetch Frames 
Automatically fill the cache with frames after the current 
frame in the background. Use this to achieve a more 


consistent playback speed. This feature currently doesn’t 
Support rendering Scene strips. 


Channel 
Selects the channel to show in the preview. 


Channel 0 is the compositing result of all strips. Channel 
1 is the current frame’s image from the strip in channel 1 
only (channel 1 is at the bottom of the stack). The display 
of these modes is either the composite (channel 0) or the 
frame from the strip (channels 1 through n). 


Show Overexposed 
Shows overexposed (bright white) areas using a zebra 
pattern. The threshold can be adjust with the slider. 


2D Cursor 

Reference 

Editor: Video Sequencer 

View Type: Preview 

Panel: Sidebar > View tab >» 2D Cursor 


The 2D cursor is the white-red circle with a cross-hair that is 
Shown in the main region. It can be used by setting the Pivot 
Point to 2D Cursor to transform all strips in relation to the 
location of the 2D cursor. 


The visibility of the 2D cursor can be controlled with the 2D 
Cursor overlay option. 


Location X, Y 
The location of the 2D cursor relative to the center of the 
main region. The edge of the image will be 0.5 away, so 


(0.5, 0.5) will be the top right corner. 


The 2D cursor’s location can also be set with Cursor tool 
or by Shift -RMB. 


Frame Overlay 


Reference 

Editor: Video Sequencer 

View Type: Preview 

Panel: Sidebar > View tab > Frame Overlay 


Option to enable the overlay. It can be used for comparing 
the current frame to a reference frame. 


Set Overlay Region 
Selects the rectangular bounds for the overlay region. 
This area can be defined by pressing 0 key over the 
preview. 


Frame Offset 
The slider controls the offset of the reference frame 
relative to current frame. 


Overlay Type 


It describes the way the reference frame should be 
displayed. 


Rectangle: Which means the rectangle area of 
reference frame will be displayed on 
top of current frame. 


Reference: Only the reference frame is displayed 
in the preview region. 
Current: Only the current frame is displayed in 


the preview region. 


Tip 

It is possible to have several Sequence Editors opened 
and they can use different overlay types. So it is 
possible to have current and reference frames displayed 
in different editor spaces. 


Overlay Lock 
It’s still possible to lock the reference frame to its current 
position. 


Safe Areas 


Reference 

Editor: Video Sequencer 

View Type: Preview 

Panel: Sidebar > View tab > Safe Areas 


Shows guides used to position elements to ensure that the 
most important parts of the video can be seen across all 
screens. 


See also 


Camera Safe Areas. 


Scene Strip Display 


Reference 


Editor: Video Sequencer 
View Type: Preview 


Panel: Sidebar > View tab » Scene Strip Display 


It allows you to control how the images of Scene Strips are 
displayed in the preview. 


Shading 
Method for rendering the viewport. See the 3D Viewport’s 
Viewport Shading options. 


Override Scene Settings 
Use the Workbench render settings from the sequencer 
scene, not the Workbench render settings from the 
source scene. This option is only available, if Solid 
Shading is activate. 


Annotations 

Reference 

Editor: Video Sequencer 

View Type: Preview 

Panel: Sidebar > View tab >» Annotations 


Allows you to use Annotations in the Sequencer. 


Metadata 

Reference 

Editor: Video Sequencer 
View Type: Preview 


Panel: Sidebar > Metadata tab 


Lists information that has been encoded in the currently 
displayed movie or image strip; note that this is the strip 
under the playhead, not the active (selected) strip. Note, 
this metadata is readonly and cannot be edited in Blender. 
Metadata can include the filename, the date created, the 
camera model etc. The metadata from saved from a Blender 
render is also displayed in the appropriate fields (camera, 
time, etc...; see Rendered Output for a full list. Some other 
graphic program also store some metadata, however, only 
the text stored in the header field “Comments” can be read 


Some of this metadata can also be made visible in the 
Preview with the Metadata overlay. 


Tip 


To edit a files metadata you can use an external program 


such as exiftool. For example, the command to change the 
“Comments” field is: 


exiftool --comments="My new comment" name-of-file.png 


Note 


The metadata will only be displayed for the image/ movie 
strip and not from strips processed by any effect strip. For 
example, adding an effect strip (eg. Glow) will hide the 
metadata from view. Of course, the metadata isn’t 
removed from the file. Hiding the effect strip will display it 
again. 


Controls 


e Pivot Point 


Pivot Point 


The Pivot Point is primarily used in operations such as rotate 
and scale. It defines the point around which the strip image 
will be rotated or scaled. Using pop up menu in the header 
of the Sequencer preview, you can change the location of 
the pivot point. 


The Pivot Point is also extensively used in the 3D Viewport. 


Bounding Box Center 
The bounding box is a rectangular box that is wrapped as 
tightly as possible around the selection. 


Median Point 
The median point is the points that is closest to all the 
origins of the selected strips. You can think of it as the 
midpoint of the area that is covered with the selected 
Strips. 


2D Cursor 
Sometimes you want to rotate a strip around a specific 
point in the preview. Therefore, you can set the 2D 
Cursor and change the pivot point accordingly. 


Individual Origins 
If multiple strips are selected, you may want to rotate or 
scale these strip around there own origins instead of for 
example the median point of all selected strips. For 
example, if you have three portrait strip’s of faces, you 
probably want each face to be rotated around its 
individual origin. 


Display 


e Display Mode 
o Image Preview 
o Luma Waveform 
o Chroma Vectorscope 
o Histogram 
e Gizmos 
o Viewport Gizmos 
« Overlays 


Display Mode 


The display mode affects how the image of the current 
frame is represented in the preview region. There are 
several modes available, each having a specific purpose. 


Image Preview 


The Image Preview mode shows you what the resulting 
video will look like when saved. This is the main working 
mode for adding strips and moving them around, cutting, 
grouping (making meta) and splicing them through special 
effects. 


Luma Waveform 


For the selected channel, brightness, or luminosity, is 
mapped with this display. 


A luma waveform allows you to judge the quality of the 
luminance distribution across the video signal, you can view 
a luma waveform instead of the usual output display on 
every control monitor. 


The display plots for every scanline the luminance value. 
The lines are all drawn on top of each other. The points get 
brighter if the lines cross (which is very likely with several 
hundred scanlines). You will understand the picture most 
easily if you plug an oscilloscope to the Luma-video-output 
of your television set. It will basically look the same. 


In this mode, the vertical axis represents the luminosity: O at 
the bottom, 1 at the top; the horizontal axis is a mapping 
from the horizontal axis of the frame. There are as many 
curves as scanlines in the frame: each one of these curves 
represents the luminosity of the pixels of one line. Moreover, 
the color of a pixel in this mode represents the number of 
pixels from the matching column of the frame sharing the 
same luminosity, i.e. the number of curves that cross at this 
point (black/transparent, for no pixel, white/opaque for at 
least three pixels). 


Separate Colors 
Separates RGB channels into separate graphs. 


This mode is good for: 


e If the waveform does not fill the whole picture you might 
want to play with the Bright/Contrast modifier until it 
fills the whole picture (contrast autostretch). 

e With the more advanced Curves or Color Balance 
modifiers, you can be more precise. 

e You can judge if you want to dump the whole thing since 
it is completely distorted and clips at the top or the 
bottom. 


The various 
horizontal lines in 
the Luma waveform 
match the uniform- 
colored lines of the 
picture. Note that 
the ‘gray 20%’ one- 
pixel width line 
(inside the yellow 
strip) is represented 
in the Luma 
waveform by a gray 
line. The two lines 
drawing an “X” are 
from the two linear 


tone shades (white - 


> black and black - 


> white). Finally, the 


The curves are quite 
visible. We found a 
luma of 80-100% for 
the sky, a luma 
around 40% for the 
sea, and a luma of 
10-20% for the 
mountains, growing 
around 40% for the 
sunny part. 


broken line matches 
the complex tone 
shade at the bottom 
of the picture. 


Note 


The pictures (first green frame, at the top) are only 50px 
high, to limit the number of curves displayed in the Luma 
waveform. 


Use this display to check for appropriate contrast and 
luminosity across all frames in the channel. When spots in 
the film that should have even illumination do not, it looks 
like a flashbulb went off or an extra light was suddenly 
turned on. This can happen if two strips were rendered or 
shot under different lighting conditions but are supposed to 
be contiguous. 


Chroma Vectorscope 


Use this mode to judge the quality of the color-distribution 
and saturation, you can also view a U/V scatter-plot. 


The picture is converted to YUV-format. The U and V values 
represent the angle of the color. For pixel of the picture, one 
point is plotted in the display at the U and V value position. 
If several pixels happen to have the same UV value the pixel 
in the plot gets brighter. 


To help you understand what color is meant, a hexagram 
marking the extreme positions (red, magenta, blue, cyan, 
green, yellow) is shown and a red cross to mark the origin. 


In other words, for the selected channel, this display shows 
the color space of the image inside a hexagon. Each point of 
the hexagon is a primary color: red, magenta, blue, cyan, 
green, and yellow. Black is at the center, and overall 
saturation is scaled as dots closer to the outside. The 
example to the right shows that the image has a lot of red 
(50% saturation) and small amount of blue, with no green. 


Always: remember to activate an additional control monitor 
of the end result. Color calibration is a matter of taste and 
depends on what you want. 


Use this display to check for too much color saturation. 
While over-saturated images look great for op-art and 
computer displays, they might not when shown on the big 
screen TV. 


This mode is good for: 


e If your picture looks very moody or desaturated you 
might want to take a look at the U/V plot. You will most 
likely see all pixels building a crowd at the origin. If you 
add saturation using the Saturation slider in the Filter 
panel or any modifiers that change color, you can see in 
the U/V plot if you distort the color. 

e If you do color-matching on a by hand basis you can 
match the angle you see of different channels monitors. 


Example image. 


Example of a Chroma Vectorscope Preview. 


Histogram 


This mode displays a graph showing the distribution of color 
information in the pixels of the currently displayed image. 
The X axis represents values of pixel, from 0 to 1 (or 0 to 
255), while the Y axis represents the number of pixels in 
that tonal range. A predominantly dark image would have 
most of its information toward the left side of the graph. 


Use this mode to balance out the tonal range in an image. A 
well-balanced image should have nice and smooth 
distribution of color values. 


Example image. 


Example of Histogram Preview. 


Gizmos 


Which gizmos that are displayed in the preview region can 
be changed via the Gizmos popover. There is a toggle to 
hide all gizmos by clicking the toggle next to the popover. 


Viewport Gizmos 


Navigate 
Enable/disable the navigation gizmo. 


Active Tools 
Enable/disable the gizmo of the active tool. 


Overlays 


Overlays are information that is displayed on top of the 
preview region. There is a toggle to show or hide all 
overlays for the preview region. 


Preview Overlays 


2D Cursor 
Shows the 2D Cursor in the image preview region. 


Frame Overlay 
Displays the Frame Overlay, to compare the current 
frame to a reference frame. 


Safe Areas 
Display an overlay on the preview, marking where the 
title safe regions are. 


Metadata 
Display Image Metadata in the preview area. 


Annotations 
Displays Annotations in the preview region. 


Sequencer & Preview 


Figure 1 shows the combined Sequencer & Preview View 
Type. It looks very much alike the default Video Editing 
Workspace (but without the File Browser, Properties and 
Timeline editor). It is however only one instance of the Video 
Sequence Editor with the View Type Sequencer & Preview, 
while the workspace contains two instances. As a result the 
combi-view has only one Sidebar and one Toolbar with all 
the tools and properties of both view types. 


Figure 1: Combined Sequencer & Preview 


Some users prefer working in this view because all the tools 
are available. On the other hand, the toolbar and Sidebar 
occupy the whole screen and so, it is not possible to have 
the Sequencer timeline full width without also hiding the 
Sidebar and Toolbar for the preview and vice versa. 


It’s also more difficult to add a small window. One common 
used technique in the workspace is to replace the File 
Browser window (temporarily) with another editor, e.g. Dope 
Sheet. 


And of course, it’s also not possible to have the Sequencer 
timeline or the Preview alone in fullscreen (Ctri-Spacebar); 
eventually on a second monitor. 


Movie Clip Editor 


e Introduction 
o Header 
¢ Display 
o Mask Display 
o Clip Display 
e« Sidebar Region 
o Footage 
o View 


Introduction 


The Movie Clip Editor has two main purposes, it can be used 
for tracking or masking movies. The empty editor looks like 


the image below. 


» Metadata 


Proxy/Timecode 


Y Marker 


& Add 


» Tracking Settings Extra 
» Track 


Movie Clip Editor interface. 


Header 


Mode 
e Tracking 
e Mask 
View 
Menu of operators for controlling how the content is 
displayed in the editor. 


Center View to Cursor 
Centers the view so that the cursor is in the middle of 
the view. 


Select 

Menu of operators for Selecting Markers. 
Clip 

Menu of operators for Editing Movie Clips. 


Clip 
A data-block menu used for add a movie file. Both movie 
files and image sequences can be used in the Clip editor. 
When a movie clip is loaded into the Clip editor, extra 
panels are displayed in the interface. 


Pivot Point 
See Pivot Points. 


Toggle Lock Selection L 
Display selected tracks at the same screen position along 
the whole footage during playback or tracking. This 
option helps to control the tracking process and stop it 
when the track is starting to slide off or when it jumped. 


Clip Display 
See Clip Display. 


Display 


e Mask Display 


e Clip Display 
o Marker Display 


Mask Display 


This popover controls mask display options. 


Spline 
Toggles the display of the mask splines. This option is 
useful while combined with the Overlay option below to 
see a simplified view of the mask. Note the splines must 
be enabled to select and edit the spline points. 


Edge Display Type 
Style of the edge. 


Overlay 
Added mask overlay to both Image and Clip editors. 


Overlay Mode 
Alpha Channel: 
Which displays the rasterized mask 
aS a grayscale image. 
Combined: Displays both the clip along with the 
mask overlayed on top. 


Blending Factor 
How much the clip is mixed with the grayscale mask 
representation when using “Combined” Overlay Mode. 


Clip Display 


This pop-over contains display settings related to editor 
itself. 


R,G, B 
Control the color channels used for frame preview. It is 
needed because the tracking algorithm works with 
grayscale images and it is not always obvious to see 
which channels disabled will increase contrast of feature 
points and reduce noise. 


Grayscale Preview (B/W) 
Shows the whole frame gray-scale. 


Mute (eye icon) 
Shows black frames in the preview instead of the movie 
clip. It helps to find tracks which are tracked inaccurately 
or which were not tracked at all. 


Render Undistorted 
Applies the Lens Distortion settings to the viewport 
image in order to display the footage undistorted. It is 
only a preview option, which does not actually change 
the footage itself. 


Show Stable 
This option makes the displayed frame be affected by the 
2D stabilization settings (available in reconstruction 
mode only). It is only a preview option, which does not 
actually change the footage itself. 


Grid 


Displays a grid which is originally orthographic, but is 
affected by the distortion model (available in distortion 
mode only). This grid can be used for manual calibration 
- distorted lines of grids are equal to straight lines in the 
footage. 


Calibration 
Applies the distortion model for annotation strokes 
(available in distortion mode only). This option also helps 
to perform manual calibration. A more detailed 
description of this process will be added later. 


Display Aspect Ratio 
Changes the aspect ratio for displaying only. It does not 
affect the tracking or solving process. 


Marker Display 


Defines how markers are displayed in the editor. Settings 
can be found in the Clip Display pop-over. 


Pattern 
Can be used to disable displaying of rectangles which 
correspond to pattern areas of tracks. In some cases it 
helps to make the clip view cleaner to check how good 
tracking is. 


Search Alt-s 
Can be used to disable displaying of rectangles which 
correspond to search areas of tracks. In some cases it 
helps to make the clip view cleaner to check how good 
tracking is. Only search areas for selected tracks will be 
displayed. 


Path 


And Length control displaying of the paths of tracks. The 
ways tracks are moving can be visible looking at only one 
frame. It helps to determine if a track jumps from its 
position or not. 


Show Disabled Alt-D 
Makes it possible to hide all tracks which are disabled on 
the current frame. This helps to make view more clear, to 
see if the tracking is accurate enough. 


Info 
Displays information such as track name and status of 
the track (if it is keyframed, disabled, tracked or 
estimated). Names and status for selected tracks are 
displayed. 


3D Markers 
Shows the markers after solving the movie clip. Therefore 
the solved position of each track is projected back to the 
movie clip and displayed as a small point. The color of 
the point depends on the distance between the projected 
coordinate and the original coordinate: if they are close 
enough, the point is green, otherwise it will be red. This 
helps to find tracks which were not solved nicely and 
need to be tweaked. 


Display Thin 
The way in which markers are displayed compact (black 
outline and yellow foreground color) makes tracks visible 
on all kind of footage (both dark and light). But 
sometimes it can be annoying and this option will make 
the marker display more compactly - the outline is 
replaced by dashed black lines rendered on top of the 
foreground, so that marker areas are only 1px thick. 


Sidebar Region 


Footage 

Proxy/Timecode 

A proxy is a smaller image (faster to v @& Proxy/Timecode 
load) that stands in for the main Build Original 

image. When you rebuild proxies 25%) 50% 

Blender computes small images (like Build Undistorted 
thumbnails) for the big images and 25% 50% 

may take some time. After Quality 90 
computing them, though, editing Proxy Custom Directory 
functions like scrubbing and Build Proxy / Timecode 


scrolling is much faster but gives a pees Wee) No TC in use 
low-res result. Make sure to disable Proxy Size None, full renders 
proxies before final rendering. 


Once you have chosen the Proxy/Timecode options, you 
need to use Clip » Proxy » Rebuild Proxy and Timecode 
Indices to generate the proxy clip and it will be available 
after Blender makes it. 


Build Original 
Used to define which resolutions of proxy images should 
be built. 


Build Undistorted 
Builds images from undistorted original images for the 
sizes set above. This helps provide faster playback of 
undistorted footage. 


Quality 


Defines the quality of the JPEG images used for proxies. 


Proxy Custom Directory 
By default, all generated proxy images are storing to the 
<path of original footage>/BL_ proxy/<clip name> folder, but 
this location can be set by hand using this option. 


Rebuild Proxy 


Regenerates proxy images for all sizes set above and 
regenerate all timecodes which can be used later. 


Timecode 
When you are working with footage directly copied from 
a camera without pre-processing it, there might be bunch 
of artifacts, mostly due to seeking a given frame in 
sequence. This happens because such footage usually 
does not have correct frame rate values in their headers. 
This issue can still arise when the source clip has the 
same frame rate as the scene settings. In order for 
Blender to correctly calculate frames and frame rate 
there are two possible solutions: 


1. Preprocess your video with e.g. MEncoder to repair 
the file header and insert the correct keyframes. 
2. Use Proxy/Timecode option in Blender. 


None: Do not use any timecode. 

Record Run: Use images in the order they are 
recorded. 

Free Run: Use global timestamp written by 


recording device. 

Free Run (Rec Date): 
Interpolate a global timestamp using 
the record date and time written by 
recording device. 

Record Run No Gaps: 


Record run, but ignore timecode, 
changes in frame rate or dropouts. 


Note 

Record Run is the timecode which usually is best to use, 
but if the source file is totally damaged, Record Run No 
Gaps will be the only chance of getting acceptable 
result. 


Proxy Render Size 
Defines which proxy image resolution is used for display. 
If Render Undistorted is set, then images created from 
undistorted frames are used. If there are no generated 
proxies, render size is set to “No proxy, full render”, and 
if render undistorted is enabled, undistortion will happen 
automatically on frame refresh. 


Footage Settings 


See Image Settings. 
View 
2D Cursor 


The 2D cursor is the dashed gray cross-hair that is shown in 
the main region. It can be used by setting the pivot point to 
2D Cursor to transform all points in relation to the location 
of the 2D cursor. 


Location X, Y 
The location of the 2D cursor is relative to the bottom left 
of the main region. The edge of the image will be 0.5 


away, so (0.5, 0.5) will be the top right corner. 


The 2D cursor’s location can also be set with Shift-RMB. 


Dope Sheet 


e Introduction 
o Dope Sheet Modes 
o Main Region 

e Editing 
o Control 


Modes 


e Action Editor 
e Grease Pencil 


e Shape Key 


Introduction 
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The Dope Sheet. 


The Dope Sheet gives the animator a birds-eye-view of the 
keyframes inside the scene. 


The Dope Sheet is inspired by classical hand-drawn 
animation process, in which animators will make use of a 
chart, showing exactly when each drawing, sound and 
camera move will occur, and for how long. This is called an 
exposure sheet or ‘dope sheet’. While CG foundations 
dramatically differ from classical hand-drawn animation, 
Blender’s Dope Sheet inherits a similar directive. 


Dope Sheet Modes 


*> Dope Sheet 


*> Dope Sheet 
Action Editor 

(®) Shape Key Editor 
@ Grease Pencil 
(© Mask 

f | Cache File 


Mode 


Dope Sheet modes. 


While the Dope Sheet Mode allows you to edit multiple 
actions at once, the other ones are dedicated to view and 
edit specific data-blocks used in different context of 
animation. 


Dope Sheet 

Action Editor 

Shape Key Editor 

Grease Pencil 

Mask 

Cache File: Alembic Todo 2.78. 


Main Region 


Navigation 


As with most editors, you can: 


Pan 
Pan the view vertically (values) or horizontally (time) with 
click and drag (MMB). 


Zoom 
Zoom in and out with the mouse wheel (Wheel). 


Scale View 
Scale the view vertically or horizontally (ctri-MMB). 


In addition, you can also use the scrollbars to pan and zoom 
the view. 


Keyframes 
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Z Scale 


The Dope Sheet Editor with object channels. 


This area contains keyframes for all visible action channels. 
As with the other time-based editors, the X axis represents 
time. The Y axis represents a stack of action channels. 


On these channels lay the keyframes, which can show 
different information: 


Gray 


Yellow 


Diamond 


Round 


Circle 


Square 


Rhombus 


Various 
colors 


Gray bar 
between 
keys 


Green line 


between 
keys 


Unselected 


Selected 


Free Keyframe Handle 


Auto-Clamped Keyframe Handle 


Automatic Keyframe Handle 


Vector Keyframe Handle 


Aligned Keyframe Handle 


These represent custom keyframe tags set by 
the user (Key >» Keyframe Type) 


Held key (the two keyframes are identical) 


Fixed keyframe interpolation (set in Key > 
Interpolation Mode) 


Upwards Maximum Extreme keyframe (visible if View > 
arrow Show Curve Extremes are enabled) 


Downwards Minimum Extreme keyframe (visible if View > 
arrow Show Curve Extremes are enabled) 


A diagonal hash fill in the background is used to display the 
Manual Frame Range of the action the channel belong to. 


Selecting Keyframes 


Selection tools are available in the Select menu in the 
header, and the main shortcuts are listed below: 


Selecting 
Click on a key to select it. Hold Shift to extend the 
current selection. 


Box Selecting 
Click and drag to box select multiple keyframes at once. 
You can hold shift to extend or ctrl to subtract from the 
current selection. 


Select Lasso 
See Select Lasso. 


Select/Deselect All 
e To select all keys, press A. 
e To deselect all keys, press Alt-A. 
e To inverse the selection, press Ctrl-I. 
Before/After Current Frame [, ] 
Select all to the right or left. Or hold Shift-ctrit and click 
on either side of the Playhead. 


See the Select menu for a full list of selection tools. 


Manipulating Keyframes 


Keyframe tools are available in the Key menu in the header, 
and the main shortcuts listed below: 


Moving Keyframes 
To move a single keyframe, click and drag on a key. To 
move multiple keyframes, make sure several keys are 
selected and press G. 


Scaling Keyframes 
To scale (stretch) selected keys, press S. 


Extending Keyframes 
To extend the time between two keys, select all with 4, 
place the Playhead between two keyframes and press E. 


See the Key menu for a full list of selection tools. 


Channels Region 


je 


v Summary 

v foot_ik.R 

X Location (foot_ik.R) -0.13088m 
Y Location (foot_ik.R) -0.53001m 
Z Location (foot_ik.R) -0.000345 
W Quaternion Rotation (foot_ik.R) 0.854 

X Quaternion Rotation (foot_ik.R) 0.000 

Y Quaternion Rotation (foot_ik.R) -0.048 

Z Quaternion Rotation (foot_ik.R) 0.043 

X Scale (foot_ik.R) 1.000 

Y Scale (foot_ik.R) 1.000 

Z Scale (foot_ik.R) 1.000 
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The Action editor’s channels region. 


See 


Header 


Here you find the menus, a first group of controls related to 
the editor “mode”, a second one concerning the action 
data-blocks, and a few other tools (like the copy/paste 
buttons, and snapping type). 


View Menu 


Adjust Last Operation 
Displays a pop-up panel to alter properties of the last 
completed operation. See 


Show Handles and Interpolation 


Instead of displaying all keyframes as *aacige 
diamonds, different icons are used to _—— 
show the Bézier handle type. When 

curves use a different interpolation type, — Handle types. 
a line is shown between keys to highlight 

that. 


See Handles & Interpolation Display. 


Show Extremes 
Detect keys where the curve 
changes direction based on 
comparing with the adjacent key Extreme markers. 
values, and display that by changing 
the keyframe icons to resemble an 
arrow. A muted version of the icon is 
used if the curve overshoots the extreme, or for groups 
with different results for contained curves. 
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See Graph editor’s View Menu. 
Markers Menu 


Markers are used to denote frames with key points or 
Significant events within an animation. Like with most 
animation editors, markers are shown at the bottom of the 
editor. 


Markers in animation editor. 


There are some options that are exclusive to the Dope Sheet 
editor: 


Sync Markers 
Sync Markers with keyframe edits. 


Show Pose Markers 
Available in Action and Shape Key modes. Shows pose 
markers owned by the active action instead of the scene 
ones. 


Make Markers Local 
Available in Action and Shape Key modes. Converts 
selected scene markers in pose markers, assigning them 
to the active action. 


For more information and the description of the other 
marker tools, see Editing Markers. 


Key Menu 


Keyframe Type R 
Sets the Keyframe Types of the selected keyframes. 


See F-Curve. 
Filters 


Only Show Selected 
Only include keyframes related to the selected item this 
item could be sequencer strips, nodes, objects, or any 
other type of data. 


Show Hidden 
Include keyframes from objects or bones that are not 
visible. 


Only Show Errors 


Only include curves and drivers that are disabled or have 
errors. Useful for debugging. 


F-Curve Name Filter 
Fuzzy/Multi-Word name filtering matches word 
Snippets/partial words, instead of having to match 
everything. It breaks down the search text based on 
whitespace placement. e.g. “lo ro” will filter all location 
and rotation, while “Ic rt” will not work. 


Filter by Type 
Filter curves by property type. 


Filtering Collection 
Select a collection to only show keyframes from objects 
contained in that collection. 


Sort Data-Blocks 
Objects data-blocks appear in alphabetical order, so that 
it is easier to find where they occur (as well as helping to 
keep the animation of related objects together in the NLA 
editor for instance). 


If you find that your playback speed suffers from this 
being enabled (it should only really be an issue when 
working with lots of objects in the scene), you can turn 
this off. 


Summary 
Toggles the “Dope Sheet Summary” channel at the top of 
the Channels Region. This is used to give an overview of 
all the channels by combining all the actions into one 
channel. 


Sidebar Region 


Action Panel 


Action 
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Actions with and without a Manual Frame Range in 
Dope Sheet. 


When the editor is in the Action mode, or a channel 
belonging to an action is selected in Dope Sheet mode, this 
panel allows changing some settings of the selected action, 
specifically the Manual Frame Range. 


Custom Properties 
Create and manage your own properties to store data in the 


action’s data block. See the Custom Properties page for 
more information. 


Editing 
Control 


Auto Snapping 


Activates automatic snapping when you moving keys. 


Frame Step: Snap to 1.0 frame intervals. 
Second Step: Snap to 1.0 second intervals. 
Nearest Frame: 

Snap to actual frames (NLA-action time). 
Nearest Second: 

Snap to actual seconds (NLA-action time). 
Nearest Marker: 

Snap to nearest marker. 


Proportional Editing 


Todo. 


Action Editor 


The Action Editor is where you can define and control 
actions. It enables you to view and edit the F-Curve data- 
blocks you defined as Actions in the F-Curve editor. So it 
takes place somewhere in between the low-level F-Curves, 
and the high-level NLA editor. 


It gives you a slightly simplified view of the F-Curve data- 
blocks (Somewhat similar to F-Curve shown without 
handles). The editor can list all Action data-blocks of an 
object at once. 


Each Action data-block forms a top-level channel (see 
below). Note that an object can have several Constraint 
(one per animated constraint) and Pose (for armatures, one 
per animated bone) F-Curve data-blocks, and hence an 
action can have several of these channels. 
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The Action Editor. 


Header 


Layer Previous/Next (down/up arrow peak icon) 
Switch between different actions stacked/stashed on top 
of each other in the NLA stack, without having to go to 
the NLA Editor and leaving tweak mode and reentering it 
on the other strip. 


Clicking on the up/down arrow buttons to go to the action 
in the NLA track above/below the NLA Strip being whose 
action is being tweaked in the Action Editor. 


If there are multiple actions/strips on the same 
layer/track, then only the one closest to the current 
frame will be used. 


The operators will take into account the settings to 
view/edit the action in isolation (i.e. Solo and NLA 
Muting). This was done to make it easier to preview 
different stashed actions. 


e If moving from a solo’d NLA track to the active 
action, the NLA stack will be muted so that the action 
can be edited in isolation. 

Likewise, if the NLA stack is muted when editing the 
action, the NLA track below it will be edited with solo 
enabled. 

If switching between NLA Tracks, the solo status for 
the previous track will be transferred to the new 
track. 


Note 


These still work when you are not editing the action 
used by an NLA Strip. If you are just animating a new 
action normally, it is possible to use the down arrow 
button to temporarily jump down to the previous action. 
Without losing the new action you are working on, and 


then use the up arrow button to get back to it once you 
are done checking the other action(s). 


Action 
A data-block menu. 


Add + 
When an action is created it is stored in an NLA Action 
Stash. 


Unlink x 
When Shift-LMB clicking it clears the Fake User and 
removes the stashed action from the NLA stack too. 


Push Down (strips with down arrow icon) 
Adds the active action on to the NLA stack as a 
contributing strip. This is basically the same as pressing 
the Push Down button in the NLA Editor. 


Stash (snowflake icon) 
Stashes the active action on to the NLA stack. i.e. it is 
added as a non-contributing stack in the same way that it 
would if you were creating a new action instead. 


Note 


In both of these cases (Push Down and Stash), once the 
action has been added to the NLA stack, it is 
cleared/unassigned from the active action slot (i.e. it 
cannot be edited anymore from the Action/Graph Editors, 
unless you enter “Tweak Mode” on the corresponding 
Strips later). 


Grease Pencil 


This Mode allows you adjust the timing of the Grease Pencil 
object’s animation frames. It is especially useful for 
animators blocking out shots, where the ability to re-time 
blocking is one of the main purposes of the whole exercise. 


This mode can be accessed by changing the Dope Sheet 
editor’s Mode selector (found in the header to the far left) to 
Grease Pencil. 


To use this editor mode, make sure you have a Grease Pencil 
object selected. 
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Channels Region 


Grease Pencil (light blue) 
The channels’ region shows the Grease Pencil data-blocks 
containing the layers. Multiple blocks are used for each 
area (e.g. one for the 3D Viewport and the Image editor). 


Layers (gray) 
These channels contain the keyframes to which the 
layers are bound. 


Opacity 


Controls the layers Opacity. 


Mask (mask icon) 
Toggle the Masks visibility. 


Onion Skinning (onion skin icon) 
Toggle the use the layer for Onion Skinning. 


Viewport/Render Visibility (eye icon) 
Toggle layer visibility in the viewport and in render. 


Lock Animation (checkbox icon) 
Toggles playback of animation or keep the channel 
Static. 


Lock (padlock icon) 
Toggle layer from being editable. 


Header 


Layer Move 
Moves the selected layer/channel up or down in the 
evaluation stack. 


Layer Add/Remove 
Adds/removes Grease Pencil layers/channels. 


Insert Keyframe 


Insert Keyframe I can be used for creating blank Grease 
Pencil frames at a particular frame. It will create blank 
frames if Additive Drawing is disabled, otherwise it will make 
a copy of the active frame on that layer, and use that. 


Copying Frames 


It is possible to copy frames from one layer to another, or 

from object to object, using the Copy and Paste tools in the 
Key menu. Note that keyframes will be pasted into selected 
layers, SO make sure you have a destination layer selected. 


Main View 


The keyframes can be manipulated like any other data in 
the Dope Sheet. Interpolated keyframes (alias breakdowns) 
are visualized as smaller light blue points. 


Sidebar 


The Sidebar contains a copy of the Grease Pencil Layer 
Properties. 


Shape Key 
Shape Key Editor 


The Shape Key Editor is used to adjust the animation timing 
of shape keys. These are stored inside an Action data-block. 
It lets you edit the Value of shape keys over time. 


This mode of the Dope Sheet uses a similar interface as the 
Action Editor Mode with the distinction of the absence of 
header filter controls and tools for channels. 


Mask 


In the Dope Sheet’s Mask Mode mask shape keyframes can 
be selected and edited. All Mask data-blocks in the blend- 
file are shown. 


See Masking. 


Timeline 


The Timeline editor, identified by a clock icon, is used for 
manipulating keyframes and scrubbing the Playhead. 


@-» Playback v Keying » View Marker © 14 Od dD > Pi 
(0) 0 


40) 50 100 


The Timeline. 


The Timeline gives the user a broad overview of a scene’s 
animation, by showing the current frame, the keyframes of 
the active object, the start and end frames of your 
animation sequence, as well as markers set by the user. 


The Timeline includes Transport Controls, to play, pause, 
and skip through an animation sequence. 


It also includes tools for manipulating Keyframes, Keying 
Sets, and Markers. 


Main View 


The main Timeline region displays the animation frames 
over time. 
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Here you can see the Keyframes (diamond shapes), 
Playhead (blue handle), Scrollbar (along the bottom). 


Adjusting the View 


The Timeline can be panned by holding mms, then dragging 
the area left or right. 


You can zoom the Timeline by using ctrl-MMB, the mouse 
Wheel, Or pressing NumpadMinus and NumpadPlus. 


You can also use the scrollbars, located at the bottom or the 
right of the editor, to pan and zoom the view. 


Playhead 


The Playhead is the blue vertical line with the current frame 
number at the top. 


The Playhead can be set or moved to a new 
position by pressing or holding L™B in 
scrubbing area at the top of the timeline. 


The Playhead can be moved in single-frame 
increments by pressing Left or Right, or you 
can jump to the beginning or end frame by 
pressing Shift-Left Or Shift-Right. 


Playhead. 


Frame Range 


By default, the Frame Range is set to start at frame 1 and 
end at frame 250. You can change the frame range in the 
top right of the Timeline header, or in the Output Properties. 


Keyframes 


For the active and selected objects, keyframes are displayed 
as diamond shapes. 


You can click to select one at a time, or select several by 
holding shift, or by dragging a box around the keyframes. 
You can then move single keys by dragging them, and you 
can move multiple keys by pressing G and scale them with s. 


Only Selected Channels can be enabled. Timeline > View > 
Only Selected Channels. For Armatures, this will display the 
object keyframes, and the keyframes for the active and 
selected pose bones. 


Markers 


See the Markers page for more information. 


Header 


Popovers 


Playback Popover 


All 3D Viewports 


Animation Editors 


Set Start Frame Set End Frame 


& v Playback ¥ Keying v View 


The Playback popover contains options controlling the 
animation playback. 


Sync 
When you play an animation, the frame rate 
is displayed at the top left of the 3D (67) Collection | 
Viewport. If the scene is detailed and 
playback is slower than the set Frame Rate, 


these options are used to synchronize the Vj ota 
lewport 
payeace red FPS. 


Play Every Frame 
Plays every frame even if playback is 
Slow. 


Frame Dropping 
Drop frames if playback becomes slower than the 
scene’s frame rate. 


Sync to Audio 
Drop frames if playback becomes too slow to remain 
synced with audio. 


Audio 
Scrubbing 
If your animation has sound, this option plays bits of 
the sound wave while you move the Playhead with LMB 
or keyboard arrows. 


Mute 
Mute the sound from any audio source. 


Playback 
Limit Playback to Frame Range 
Don’t allow selecting frames outside of the playback 
range using the mouse. 


Follow Current Frame 
Animation editors can be setup to always follow the 
time indicator as animation is being played back. 
Following will be done when animating and changing 
frame: When the cursor reaches the end of the screen, 
the next range of frames of the same width will be 
displayed. 


Play In 
Active Editor 
While playing, updates the Timeline, if Animation 
Editors and All 3D Viewports disabled. 


3D Viewport 


While playing, updates the 3D Viewport and the 
Timeline. 


Animation Editors 
While playing, updates the Timeline, Dope Sheet, 
Graph Editor, Video Sequencer. 


Image Editor 
The Image editor in Mask mode. 


Properties Editor 
When the animation is playing, this will update the 
property values in the UI. 


Movie Clip Editor 
While playing, updates the Movie Clip Editor. 


Node Editors 


While playing, updates the Node properties for the 
node editors. 


Video Sequencer 
While playing, updates the Video Sequencer. 


Show 
Subframes 
Display and allow changing the current scene 
subframe. 


Keying Popover 


@- 


The Keying popover contains options that affect keyframe 


insertion. 


Active Keying Set 


Keying Sets are a set of 


keyframe channels in one. 
They are made so the user 


can record multiple 
properties at the same 
time. With a keying set 


selected, when you insert 


a keyframe, Blender will 
add keyframes for the 
properties in the active 
Keying Set. There are 


some built-in keying sets, 


LocRotScale, and also 
custom keying sets. 


Custom keying sets can be 


by 


Available 
BBone Shape 
Delta Location 
Delta Rotation 
Delta Scale 
Location 


LocRot 


. LocRotScale 


LocScale 


Rotation 


Timeline Keying Sets. 


defined in the panels Properties » Scene > Keying Sets + 


Active Keying Set. 


Insert Keyframes (plus icon) 


Insert keyframes on the current frame for the 
properties in the active Keying Set. 


Delete Keyframes (minus icon) 
Delete keyframes on the current frame for the 
properties in the active Keying Set. 


New Keyframe Type 
Keyframe Types on insertion. 


Cycle-Aware Keying 
When inserting keyframes into trivially cyclic curves, 
special handling is applied to preserve the cycle integrity 
(most useful while tweaking an established cycle): 


e If a key insertion is attempted outside of the main 
time range of the cycle, it is remapped back inside 
the range. 

e When overwriting one of the end keys, the other one 
is updated accordingly. 


In addition, when adding a new curve into an action with 
a Manual Frame Range and Cyclic Animation enabled, the 
curve is automatically made cyclic with the period 
matching the frame range. For convenience this check 
and conversion is also done before adding the second 
keyframe to such a curve. 


Auto Keying Popover 


The record button ({4)) enables ©] 1s 04 4 D> ve > 
Auto Keyframe: \t will add and/or 11012 13014 
replace existing keyframes for 

the active object when you Timeline Auto Keyframe. 
transform it in the 3D Viewport. 

For example, when enabled, first 

set the Playhead to the desired 

frame, then move an object in the 3D Viewport, or set a new 
value for a property in the UI. 


When you set a new value for the properties, Blender will 
add keyframes on the current frame for the transform 


properties. Other use cases are Fly/Walk Navigation to 
record the walk/flight path and Lock Camera to View to 
record the navigation in camera view. 


Note 


Note that Auto Keyframe only works for transform 
properties (objects and bones), in the 3D Viewport (i.e. you 


can’t use it e.g. to animate the colors of a material in the 
Properties...). 


Add & Replace / Replace 
This controls how the auto keyframe mode works. Only 
one mode can be used at a time. 


Add & Replace 
Add or replace existing keyframes. 


Replace 
Only replace existing keyframes. 


Only Active Keying Set 


When enabled, new keyframes for properties will be 
inserted into the active Keying Set. 


Layered Recording 
Adds a new NLA Track and strip for every loop/pass made 


over the animation to allow non-destructive tweaking. 


Menus 


View Menu 


The View Menu controls what you see, and what it looks like. 


Adjust Last Operation 


Displays a pop-up panel to alter properties of the last 
completed operation. See Adjust Last Operation. 


Show Seconds Ctrl-T 


Whether to show the time in the X axis and the Playhead 
as frames (based on the FPS) or as seconds. 


Sync Visible Range 
It synchronizes the horizontal panning and scale of the 
current editor with the other editors (Graph, Dope Sheet, 
NLA and Sequencer) when this option is set. That way 
you always have these editors showing the same section 
of frames. 


Show Markers 


Shows the markers region. When disabled, the Markers 
Menu is also hidden and markers operators are not 
available in this editor. 


Only Keyframes from Selected Channels 
For Armatures, this will display the object keyframes, and 
the keyframes for the active and selected pose bones. 


Cache 
Show Cache 
Show all enabled types. 


Soft Body, Particles, Cloth, Smoke, Dynamic Paint, 
Rigid Body. 


Timeline Cache. 


Frame All Home 
Maximize the area based on the Animation Range. 


Go to Current Frame Numpado 
Centers the Timeline to the Playhead. 


Markers Menu 


Markers are used to denote frames with key points or 
Significant events within an animation. Like with most 
animation editors, markers are shown at the bottom of the 
editor. 


Markers in animation editor. 


For descriptions of the different marker tools see Editing 
Markers. 


Header Controls 


The Timeline header controls. 
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Timeline header controls. 


1. Popovers for Playback and Keying, 2. Transport 
Controls, 3. Frame Controls 


Transport Controls 


These buttons are used to set, play, rewind, the Playhead. 


Jump to Start (| []) Shift-Left 
This sets the cursor to the start of 
frame range. 


Jump to Previous Keyframe (@[]) Down Transport controls. 
This sets the cursor to the 
previous keyframe. 


Rewind (<) Shift-Ctrl-Spacebar 
This plays the animation sequence in reverse. When 
playing the play buttons switch to a pause button. 


Play (bm) Spacebar 
This plays the animation sequence. When playing the 
play buttons switch to a pause button. 


Jump to Next Keyframe ([]@) Up 
This sets the cursor to the next keyframe. 


Jump to End ({]] ) Shift-Right 
This sets the cursor to the end of frame range. 


Pause (i) Spacebar 
This stops the animation. 


Frame Controls 


Current Frame Alt-Wheel 
The current frame of the animation/playback range. Also 
the position of the Playhead. 


Preview Range (clock icon) 


This is a temporary frame range used for previewing a 
Smaller part of the full range. The preview range only 


affects the viewport, not the rendered output. See 
Preview Range. 


Start Frame 
The start frame of the animation/playback range. 


End Frame 
The end frame of the animation/playback range. 


Graph Editor 


e Introduction 

o Main Region 

o Header 
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Introduction 


The Graph Editor allows users to adjust animation curves 
over time for any animatable property. F-Curves. 
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The Graph Editor. 


Main Region 


The curve view allows you to view and edit F-Curves. An F- 
Curve has several key parts: 


Curve 
The curve defines the value (Y axis) of the property over 
time (X axis). 


See F-Curves. 


Keyframes 
Keyframes are user-defined values on certain frames and 
are represented by little black squares which become 
orange if selected. 


See Keyframes for more information. 


Handles 
Each keyframe has a handle that helps determine the 
values of the curve between keyframes. These handles 
are represented by extruding lines with circular ends and 
can be selected and modified to change the shape of the 
curve. 


See F-Curve Handles for more information. 


A simple curve. 


See also 


See F-Curves for more info. 


Navigation 


As with most editors, you can: 


Pan 
Pan the view vertically (values) or horizontally (time) with 
click and drag MMB. 


Zoom 
Zoom in and out with the mouse wheel wheel. 


Scale View 
Scale the view vertically or horizontally ctr1-MMB. 


In addition, you can also use the scrollbars to pan and zoom 
the view. 


Playhead & 2D Cursor 


The current frame is 
represented by a blue 
vertical line called the 
Playhead. 


As in the Timeline, you 
can change the current 
frame by LmB-dragging 
in the scrubbing area 
at the top of the editor. 


The blue horizontal line 

is called the 2D Cursor. Graph Editor 2D Cursor. 
This can be enabled or 

disabled via the View 

Menu or the View 

Properties panel. 


These two lines can be used as a reference for moving and 
scaling keyframe handles. 


See also 


See Graph Editor’s View Tab. 


View Axes 


For Actions the X axis represents time, the Y axis represents 
the value to set the property. 


Depending on the selected curves, the values have different 
meaning: for example rotation properties are shown in 
degrees. 


Header 


View Menu 


Realtime Updates 
When transforming keyframes, changes to the animation 
data are propagated to other views. 


Show Cursor 
Toggles the visibility of the Playhead & 2D Cursor. 


Show Sliders 
A toggle option that shows the value sliders for the 
channels. See the Fig. The Action editor’s channels 
region.. 


AutoMerge Keyframes 
Automatically merge nearby keyframes. 


Show Markers 
Shows the markers region. When disabled, the Markers 
Menu is also hidden and markers operators are not 
available in this editor. 


Use High Quality Display 


Display F-Curves using Anti-Aliasing and other effects 
(disable for a better performance). 


Show Extrapolation 
Toggles the visibility of the extrapolated portion of 
curves. 


Show Handles ctrt-H 
Toggles the display of a curve’s handles in the curve 
view. 


Only Selected Curve Keyframes 
Only shows the keyframes markers on the selected 
curves. 


Only Selected Keyframes Handles 
Only shows the handles for the currently selected curves. 


Frame All Home 
Reset viewable area to show all keyframes. 


Frame Selected NumpadPeriod 
Reset viewable area to show selected keyframes. 


Go to Current Frame Numpado 
Centers the area to the Playhead. 


See also 


e See Graph Editor’s View Tab. 
e See Timeline’s View Menu. 


Preview Range 


Set Preview Range P 


Interactively define frame range used for playback. 
Allows you to define a temporary preview range to use 
for animation playback (this is the same thing as the 
Playback Range option of the Timeline editor header). 


Clear Preview Range Alt-P 
Clears the preview range. 


Set Preview Range to Selected Ctrl-Alt-P 
Sets the preview range to playback the selected NLA 
Strips. 


Markers Menu 


Markers are used to denote frames with key points or 
Significant events within an animation. Like with most 
animation editors, markers are shown at the bottom of the 
editor. 
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Markers in animation editor. 


For descriptions of the different marker tools see Editing 
Markers. 


View Controls 
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View controls. 


Show Only Selected 
Only include curves related to the selected objects and 
data. 


Show Hidden 
Include curves from objects/bones that are not visible. 


Show Only Errors 
Only include curves and drivers that are disabled or have 
errors. Useful for debugging. 


Filter (funnel icon) 
Only include curves with keywords contained in the 
search field. 


Multi-Word 
Fuzzy/Multi-Word name filtering matches word 
Ssnippets/partial words, instead of having to match 
everything. It breaks down the search text based on 
whitespace placement. e.g. “lo ro” will filter all 
location and rotation, while “Ic rt” will not work. 


Type Filter 
Filter curves by property type. 


Filtering Collection 
Select a collection to only show keyframes from 
objects contained in that collection. 


Sort Data-Blocks 
Objects data-blocks appear in alphabetical order, so 
that it is easier to find where they occur (as well as 
helping to keep the animation of related objects 
together in the NLA for instance). 


If you find that your playback speed suffers from this 
being enabled (it should only really be an issue when 
working with lots of objects in the scene), you can turn 
this off. 


Normalize 
Normalize curves so the maximum or minimum point 
equals 1.0 or -1.0. 


Auto 
Automatically recalculate curve normalization on 
every curve edit. This is useful to prevent curves from 
jumping after tweaking it. 


F-Curve Controls 
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F-Curve controls. 


Proportional Editing o 
See Proportional Editing. 


Auto Snap 
Auto snap the keyframes for transformations. 


e No Auto-Snap 

e Frame Step 

e Second Step 

e Nearest Frame 
e Nearest Second 
e Nearest Marker 


Pivot Point 


Pivot point for rotation. 


Bounding Box Center 
Center of the selected keyframes. 


2D Cursor 
Center of the 2D Cursor. Playhead + Cursor. 


Individual Centers 
Rotate the selected keyframe Bézier handles. 


Create Ghost Curves (framed F-Curve icon) 
Creates a picture with the current shape of the curves. 


Sidebar Region 
The panels in the Sidebar region. 


View Tab 


Show Cursor ¥ @ Show Cursor 
Toggles the visibility of the 2D Girsorx er 
Cursor. Y 0.000 


Cursor to Selection 


Cursor X, Y 
Moves the cursor to the specified 
frame (X value) and value (Y mieys Tee: 
value). 


Cursor to Selection 
Places the 2D Cursor at the midpoint of the selected 
keyframes. 


See also 


Graph Editor’s View Menu. 


Further Tabs 


F-Curve Tab 
See F-Curve. 


Modifiers Tab 
See F-Curve Modifiers. 


Channels 
Channels Region 
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The Channels region. 


The channels region is used to select and manage the 
curves for the Graph editor. This part shows the objects and 


their animation data hierarchy each as headers. Each level 
can be expanded/collapsed by the small arrow to the left of 
its header. 


Scenes, Objects (dark blue) 

Actions, Shape keys, etc. (light blue) 
Groups (green) 

Channels (gray) 


Name Filter ctri-F 
Only displays channels that match the search text. 
Pressing the invert button displays all channels except 
the channels that match the search text. 


Controls 


On the headers, there are toggles to control channel’s 
setting: 


Pin (pin icon) 
Make the channel always visible regardless of the current 
selection (Graph editor only). 


Hide (eye icon) 
Hides the channel(s)/curve (Graph editor only). 


Modifiers (wrench icon) 


Deactivates the F-Curve modifiers of the selected curve 
or all curves in the channel. 


Mute (checkbox) 
Deactivates the channel/curve. 


Lock (padlock icon) Tab 
Toggle channel/curve from being editable. Selected 
channels can be locked by pressing Tab. 


Note 


In the Dope Sheet this is also working inside the NLA, 
but that it does not prevent edition of the underlying F- 


Curve. 
Selecting 
e Select channel (text in white/black): LMB 
e Multi Select/Deselect: Shift-LMB 
e Select All: A 
e Deselect All: Alt-A 
e Box Select: (LMB drag) or B (LMB drag) 
e Box Deselect: (Ctr1-LMB drag) or B (Shift-LMB drag) 
e Select all keyframes in the channel: double LMB ona 


channel header. 
Editing 


e Rename: Ctrl-LMB 

Delete selected: xX or Delete 

Lock selected: Tab 

Enable Channel Setting: Shift-Ctrl-w 
Disable Channel Setting: Alt-w 
Toggle Channel Setting: Shift-w 


Sliders 
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X Location (foot_ik.R) -0.13088m 
Y Location (foot_ik.R) -0.53001m 
Z Location (foot_ik.R) -0.000345 
W Quaternion Rotation (foot_ik.R) 0.854 

X Quaternion Rotation (foot_ik.R) 0.000 

Y Quaternion Rotation (foot_ik.R) -0.048 

Z Quaternion Rotation (foot_ik.R) 0.043 

X Scale (foot_ik.R) 1.000 

Y Scale (foot_ik.R) 1.000 

Z Scale (foot_ik.R) 1.000 
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The Action editor showing sliders. 


On channels headers you can have another column with 
number fields or sliders, allowing you to change the value 
on the current keyframes, or to add new keyframes. See 
View Menu for how to show these sliders. 


Editing 
Delete Channels 


Reference 


Menu: Channel » Delete Channels 
Shortcut: X 


Deletes the whole channel from the current action (i.e. 
unlink the underlying F-Curve data-block from this action 
data-block). 


Warning 


The x shortcut is area-dependent: if you use it in the left 
list part, it will delete the selected channels, whereas if you 
use it in the main area, it will delete the selected 
keyframes. 


Un/Group Channels 


Reference 
Menu: Channel » Un/Group Channels 
Shortcut: Ctrl-Alt-G, Ctrl-G 


Un/Groups the selected channels into a collection that can 
be renamed by double clicking on the group name. For 
example, this helps to group channels that relate a part of 
an armature to keep the editor more organized. 


Toggle/Enable/Disable Channel Settings 


Reference 

Menu: Channel > Toggle/Enable/Disable Channel 
Settings 

Shortcut: Shift-W, Shift-Ctrl-W, Alt-W 


Enable/disable a channel’s setting (selected in the menu 
that pops up). 


Protect, Mute 
Todo. 


Toggle Channel Editability 


Reference 
Menu: Channel > Toggle Channel Editability 
Shortcut: Tab 


Locks or unlocks a channel for editing. 


Extrapolation Mode 


Reference 
Menu: Channel » Extrapolation Mode 
Shortcut: Shift-E 


Change the extrapolation between selected keyframes. 


Extrapolation defines the behavior of a curve before the first 
and after the last keyframes. 


There are two basic extrapolation modes: 


Constant: The default one, curves before their first 
keyframe and after their last one have a 
constant value (the one of these first and 
last keyframes). 


Curves ends are straight lines (linear), as 
defined by the slope of their first and last 
keyframes. 


Linear: Addition 
al extrapolation 
methods (e.g. the 
Cycles modifier) 
are located in the 


F-Curve 
Modifiers. 
Constant extrapolation. 
Linear extrapolation. 
Show/Hide 


Hide Selected Curves H 
Hides the selected curves. 


Hide Unselected Shift-H 
Show only the selected curve (and hide everything else). 


Reveal Curves Alt-H 
Show all previous hidden curves. 


Expand/Collapse Channels 


Reference 
Menu: Channel >» Expand/Collapse Channels 
Shortcut: NumpadPlus, NumpadMinus 


Expands or collapses selected channels. 
Move 

Reference 

Menu: Channel > Move... 


This allows you to move selected channels up/down Pageup, 
PageDown, or directly to the top/bottom Shift-PageUp, Shift- 
PageDown. 


Revive Disabled F-Curves 
Reference 
Menu: Channel > Revive Disabled F-Curves 


Clears “disabled” tag from all F-Curves to get broken F- 
Curves working again. 


F-Curves 


e Introduction 


° 


Direction of Time 


e Editing 


oO 0 0 0 0 0 0 0 0 0 0 0 0 0 O09 0 80 0 OO OA 


ie) 


Transform 
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Copy/Paste 
Duplicate 
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Clean Keyframes 
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Un-Bake Curve 
Discontinuity (Euler) Filter 
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e F-Curve Modifiers 
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Adding_a Modifier 
Types of Modifiers 


Introduction 


After animating some property in Blender using keyframes 
you can edit their corresponding curves. When something is 
“animated”, it changes over time. This curve is shown as 
something called an F-Curve. Basically what an F-Curve 
does is an interpolation between two animated properties. 
In Blender, animating an object means changing one of its 
properties, such as the object’s location, or its scale. 


As mentioned, Blender’s fundamental unit of time is the 
“frame”, which usually lasts just a fraction of a second, 
depending on the frame rate of the scene. As animation is 
composed of incremental changes spanning multiple 
frames, usually these properties are not manually modified 
frame-by-frame, because: 


e It would take ages! 

e It would be very difficult to get smooth variations of the 
property (unless you compute mathematical functions 
and type a precise value for each frame, which would be 
Crazy). 


This is why nearly all direct animation is done using 
interpolation. 


The idea is simple: you define a few Keyframes, which are 
multiple frames apart. Between these keyframes, the 
properties’ values are computed (interpolated) by Blender 
and filled in. Thus, the animators’ workload is significantly 
reduced. 


For example, if you have: 


e Acontrol point of value 0 
at frame O, 

e another one of value 10 
at frame 25, 

e and you use linear 
interpolation, then, at 
frame 5 we get a value of 
2. 


The same goes for all 
intermediate frames: with 
just two points, you get a Example of an interpolation. 
smooth increase from (0 to 

10) along the 25 frames. 

Obviously, if you would like the frame 15 to have a value of 
9, you would have to add another control point (or 
keyframe)... 


Direction of Time 


Although F-Curves are very similar to Bézier, there are some 
important differences. 


For obvious reasons, a property represented by a curve 
cannot have more than one value at a given time, hence: 


e When you move a control point ahead of a control point 
that was previously ahead of the point that you are 
moving, the two control points switch their order in the 
edited curve, to avoid the curve going back in time. 

e For the above reason, it is impossible to have a closed F- 
Curve. 


Two control points switching: the curve cannot go back in 
time! 


Before moving the After moving the 
second keyframe. second keyframe. 


Editing 


Transform 

Reference 

Mode: Edit Mode 
Menu: Key » Transform 


An F-Curve can be edited by transforming the locations of 
the keyframes. 


Move, Rotate, Scale 
Like other elements in Blender, keyframes can be moved, 
rotated, or scaled as described in Basic Transformations. 


Extend 
Moves keyframes relative to the current frame. If the 
mouse is to the left of the Playhead, this operator only 
affects the selected keyframes that are to the left of the 
Playhead. On the contrary, if the mouse is to the right of 
the Playhead, this operator only affects the selected 
keyframes that are to the right of the Playhead. 


Tip 
For precise control of the keyframe position and value, you 


can set values in the Active Keyframe of the Sidebar 
region. 


Snap 


Reference 


Menu: Key > Snap 
Shortcut: Shift-S 


Keyframes can be snapped to different properties by using 
the Snap Keys tool. 


Selection to Current Frame 
Snap the selected keyframes to the current frame. 


Selection to Cursor Value 
Snap the selected keyframes to the 2D Cursor. 


Selection to Nearest Frame 
Snap the selected keyframes to their nearest frame 
individually. 


Selection to Nearest Second 
Snap the selected keyframes to their nearest second 
individually, based on the FPS of the scene. 


Selection to Nearest Marker 
Snap the selected keyframes to their nearest marker 
individually. 


Flatten Handles 
Flatten the Bézier handles for the selected keyframes. 


Flatten Handles snapping example. 


Before Flatten After Flatten 
Handles. Handles. 


Equalize Handles 
Ensure selected keyframes’ handles have equal length. 


Side 

Side of the keyframes’ Bézier handles to affect 

Left: Equalize selected keyframes’ left 
handles. 

Right: Equalize selected keyframes’ right 
handles. 

Both: Equalize both of a keyframe’s 
handles. 


Handle Length 
Length to make selected keyframes’ Bézier handles. 


Flatten 
Make the values of the selected keyframes’ handles 
the same as their respective keyframes. 


Cursor to Selected ctri-G 


Places the cursor at the midpoint between selected 
keyframes. 


Cursor Value to Selection 


Places the cursor value on the average value of selected 
keyframes. 


Mirror 

Reference 

Menu: Key » Mirror 
Shortcut: Ctrl-M 


Selected keyframes can be mirrored over different 
properties using the Mirror Keys tool. 


By Times over Current Frame 
Mirror horizontally over the current frame. 


By Values over Cursor Value 
Mirror vertically over the 2D cursor. 


By Times over Time 0 
Mirror horizontally over frame O. 


By Values over Value 0 
Mirror vertically over value O. 


By Times over First Selected Marker 
Mirror horizontally over the first selected marker. 


Insert Keyframes 


Reference 


Menu: Key » Insert Keyframes 
Shortcut: I 


Inserts a keyframe to the active F-Curve at the mouse 
position. The newly added keyframes will be selected, 
making it easier to quickly tweak the newly added 
keyframes. All previously selected keyframes are kept 
selected by using I. 


Add F-Curve Modifier 


Reference 
Menu: Key » Add F-Curve Modifier 
Shortcut: Shift-Ctri-M 


Opens a pop-up allowing you to add modifiers to the active 
F-Curve. Settings for the modifier can be found in the 
Sidebar >» Modifiers tab. 


Bake Sound to F-Curves 


Reference 


Menu: Key > Bake Sound to F-Curves 


The Bake Sound to F-Curves operator takes a sound file and 
uses its sound wave to create the animation data. 


Lowest Frequency 


Cutoff frequency of a high-pass filter that is applied to 
the audio data. 


Highest Frequency 


Cutoff frequency of a low-pass filter that is applied to the 
audio data. 


Attack Time 


Value for the hull curve calculation that tells how fast the 
hull curve can rise. The lower the value the steeper it can 
rise. 


Release Time 
Value for the hull curve calculation that tells how fast the 
hull curve can fall. The lower the value the steeper it can 
fall. 


Threshold 


Minimum amplitude value needed to influence the hull 
curve. 


Accumulate 


Only the positive differences of the hull curve amplitudes 
are Summarized to produce the output. 


Additive 


The amplitudes of the hull curve are summarized. If 
Accumulate is enabled, both positive and negative 
differences are accumulated. 


Square 


Gives the output as a square curve. Negative values 
always result in -1, and positive ones in 1. 


Square Threshold 
All values lower than this threshold result in 0. 


Jump to Keyframes 


Reference 


Menu: Key > Jump to keyframes 


Shortcut: Ctrl-G 


Places the 2D cursor at the center of the selected 
keyframes. 


Copy/Paste 


Reference 

Menu: Key > Copy Keyframes, Key » Paste 
Keyframes 

Shortcut: Ctrl-C, Ctrl-v 


Use ctri-c to copy selected keyframes and ctri-v to paste 
the previously copied keyframes. During the paste action, 
the Adjust Last Operation panel provides some options in 
how the paste is applied. 


Offset 
No Offset 
Pastes the keyframes in the location they were copied 
from. 


Frame Relative 
Pastes the keyframe relative to the current frame 
based on the locations of the keyframes relative to the 
current frame when they were copied. 


Frame Start 
Pastes the keyframes with the first keyframe of the 
copied set placed at the current frame. 


Frame End 
Pastes the keyframes with the last keyframe of the 
copied set placed at the current frame. 


Type 
Mix 
Integrates the pasted keyframes in with existing 


keyframes only overwriting keyframes that share a 
frame. 


Overwrite All 


Removes all previous keyframes and replaces them 
with the pasted keyframes. 


Overwrite Range 
Overwrite keys in pasted range. 


Overwrite Entire Range 
Overwrite keys in pasted range, using the range of all 
copied keys. 


Flipped 
Paste keyframes from mirrored bones if they exist. 


Duplicate 


Reference 


Menu: Key >» Duplicate 
Shortcut: Shift-D 


Duplicates the selected keyframes. You can reposition them 
by moving the mouse. 


Delete Keyframes 


Reference 


Menu: Key > Delete Keyframes 
Shortcut: X, Delete 


Pressing X Or Delete Opens a pop-up menu from where you 
can delete the selected keyframes. 


Handle Type 


Reference 
Menu: Key > Handle Type 
Shortcut: V 


Sets the handle type of the selected keyframes. 


Interpolation Mode 


Reference 
Menu: Key » Interpolation Mode 
Shortcut: T 


Sets the interpolation mode between the selected 
keyframes. 


Easing Mode 


Reference 


Menu: Key > Easing Mode 
Shortcut: Ctrl-E 


Sets the easing mode of the selected keyframes. 


Decimate 

Reference 

Menu: Key » Decimate (Ratio) 

Menu: Key » Decimate (Allowed Change) 


The Decimate tool simplifies an F-Curve by removing 
keyframes that influence the curve shape the least. 


Mode 


Controls which method is used pick the number of 
keyframes to use. 


Ratio 
Deletes a defined percentage of keyframes, the 


amount of keyframes to delete is define by the 
Remove property. 


Error Margin 
Deletes keyframes which only allowing the F-Curve to 
change by a defined amount. The amount of change is 
controlled by the Max Error Margin which controls how 
much the new decimated curve is allowed to deviate 
from the original. 


Slider Operators 
Breakdown 


Reference 


Menu: Key > Slider Operators > Breakdown 


Moves the selected keyframes to an in between position 
relative to the adjacent keyframes. To use this operator, 
drag the mouse left or right to adjust the operator’s Factor 
property. 


Factor 
The amount to favor either the left or the right key. 
Values less than 0.5 favor the left keyframe, values 
greater than 0.5 favor the right keyframe, a value of 0.5 
results in no change. 


Blend to Neighbor 


Reference 


Menu: Key » Slider Operators > Blend to 
Neighbor 


Transitions the current keyframe with the neighboring 
keyframes in the timeline. In order for this operator to work, 
there must be a keyframe before and after the current 
frame. To use this operator, drag the mouse left or right to 
adjust the operator’s Blend property. 


Blend 
The amount to favor either the left or the right key. 
Values less than 0.5 favor the left keyframe, values 
greater than 0.5 favor the right keyframe, a value of 0.5 
results in no change. 


Blend to Default Value 


Reference 


Menu: Key » Slider Operators > Blend to 
Neighbor 


Transitions the current keyframe towards the property’s 
default value. To use this operator, drag the mouse left or 
right to adjust the operator’s Blend property. 
Blend 
The amount to favor either the current key or the default 
value. A value of 0 represents the current key, a value of 
1 represents the default value. 
See also 


The Reset to Default operator resets any property to its 
default value without the need of keyframing. 


Clean Keyframes 


Reference 
Menu: Key > Clean Keyframes 
Shortcut: X 


Clean Keyframes resets the keyframe tangents on selected 


keyframes to their auto-clamped shape, if they have been 
modified. 


F-Curve before F-Curve after 
cleaning. 


cleaning. 
Clean Channels 
Reference 
Menu: Key » Clean Channels 
Shortcut: X 


Acts like the Clean Keyframes tool but will also delete the 
channel itself if it is only left with a single keyframe 
containing the default property value and it’s not being used 
by any generative F-Curve modifiers or drivers. 


Note 


The modified curve left after the Clean tool is run is not the 
same as the original, so this tool is better used before 
doing custom editing of F-Curves and after initial keyframe 
insertion, to get rid of any unwanted keyframes inserted 
while doing mass keyframe insertion (by selecting all 
bones and pressing I for instance). 


Smooth Keys 


Reference 


Menu: Key >» Smooth Keys 
Shortcut: Alt-0 


There is also an option to smooth the selected curves, but 
beware: its algorithm seems to be to divide by two the 
distance between each keyframe and the average linear 
value of the curve, without any setting, which gives quite a 
strong smoothing! Note that the first and last keys seem to 
be never modified by this tool. 


F-Curve before F-Curve after 
smoothing. Smoothing. 


Sample Keyframes 


Reference 
Menu: Key >» Sample Keyframes 
Shortcut: Shift-Alt-0 


Sampling a set of keyframes replaces interpolated values 
with a new keyframe for each frame. 


F-Curve before F-Curve after 
Sampling. sampling. 


Bake Curve 


Reference 
Menu: Key >» Bake Curve 
Shortcut: Alt=C 


Baking a curve replaces it with a set of sampled points, and 
removes the ability to edit the curve. 


Un-Bake Curve 


Reference 


Menu: Key » Un-Bake Curve 


Unbaking a curve replaces the baked curve with an unbaked 
curve, adding the ability to edit it. 


Discontinuity (Euler) Filter 


Todo. 


Properties 


Active F-Curve 


Reference 


Panel: Sidebar region > F-Curve » Active F- 
Curve 


Y Active F-Curve 


@ XLocation 


Display Color Auto XYZ to RGB 


Handle Smoothing Continuous Acceleration 


Active F-Curve panel. 
This panel displays properties for the active F-Curve. 


Channel Name 
ID Type + Channel name (X Location). 


Data Path 
RNA Path to property. 


RNA Array Index 


Index to the specific property affected by the F-Curve if 
applicable. 


Display Color 


The method used to determine the color of the F-Curve 
shown in the Graph editor. 


Auto Rainbow: Increment the hue of the F-Curve color 
based on the channel index. 

Auto XYZ to RGB: 
For property sets like location XYZ, 
automatically set the set of colors to 
red, green, blue. 

User Defined: Define a custom color for the active F- 
Curve. 


Handle Smoothing 
Selects the method used to compute automatic Bézier 
handles (Automatic, Auto Clamped, Vector). 


Auto Clamped 


= 


Handle smoothing mode comparison. 


Yellow: None, Cyan: Continuous Acceleration. 
From left to right, four Auto Clamped keys, one 
Vector, and the rest are Automatic. 


None: Only directly adjacent key values are 
considered when computing the 
handles. Vector handles are pointed 
directly at the adjacent keyframes. 
This older method is very simple and 
predictable, but it can only produce 


truly smooth curves in the most trivial 
cases. Note the kinks in the yellow 
curve around the keys located between 
the extremes, and near the Vector 
handles. 


Continuous Acceleration: 
A system of equations is solved in 
order to avoid or minimize jumps in 
acceleration at every keyframe. Vector 
handles are integrated into the curves 
as smooth transitions to imaginary 
straight lines beyond the keyframe. 
It produces much smoother curves out 
of the box, but necessarily means that 
any changes in the key values may 
affect interpolation over a significant 
stretch of the curve; although the 
amount of change decays 
exponentially with distance. This 
change propagation is stopped by any 
key with Free, Aligned, or Vector 
handles, as well as by extremes with 
Auto Clamped handles. 
The mode also tends to overshoot and 
oscillate more with fully Automatic 
handles in some cases (see the right 
end of the image above). So it is 
recommended to use Auto Clamped by 
default, and only switch to Automatic 
handles in places where this is desired 
behavior. That effect can also be 
reduced by adding in-between keys. 


Tip 


Considering the upsides and 
downsides of each mode, Continuous 
Acceleration should be better suited 
for limited animation, which uses a 
small number of interpolated keys 
with minimal manual polish. In case of 
highly polished high key rate 
animation, the benefits of smoothing 
may not outweigh the workflow 
disruption from more extensive 
change propagation. 


Active Keyframe 


Reference 


Panel: Sidebar region >» F-Curve >» Active 
Keyframe 


Y Active Keyframe 


Interpolation _/ Bezier 


Key Frame 1.000 
Value 0.000 


Left Handle Type 74 Auto Clamped 


Frame 0.000 
Value 0.000 


Right Handle Type 4 Auto Clamped 
Frame 2.000 
Value 0.000 


Active Keyframe panel. 


Interpolation 


Mode for the Interpolation between the current and next 
keyframe. 


Interpolation 


Constant: 


Constant. 
There is no interpolation at all. The 
curve holds the value of its last 
keyframe, giving a discrete (stairway) 
“curve”. Usually only used during the 
initial “blocking” stage in pose-to-pose 
animation workflows. 


Linear: 


Linear. 
This simple interpolation creates a 
straight segment, giving a non- 
continuous line. It can be useful when 
using only two keyframes and the 
Extrapolation extend mode, to easily 
get an infinite straight line (i.e. a linear 
curve). 


Bezier: 


Bézier. 


The more powerful and useful 
interpolation, and the default one. It 
gives nicely smoothed curves, i.e. 
smooth animations! 


Note 

Remember that some F-Curves can only take discrete 
values, in which case they are always shown as if 
constant interpolated, whatever option you chose. 


Easing (by strength) 


Different methods of easing interpolations for F-Curve 
segment. The “Robert Penner easing equations” 
(basically, equations which define some preset ways that 
one keyframe transitions to another) which reduce the 
amount of manual work (inserting and tweaking 
keyframes) to achieve certain common effects. For 
example, snappy movements. 


e Linear 

e Sinusoidal 
e Quadratic 

e Cubic 

e Quartic 

e Quintic 

e Exponential 


e Circular 


See also 
For more info and a few live demos, see 


https://easings.net and http://robertpenner.com/easing/ 


Dynamic Effects 


These additional easing types imitate (fake) physics- 
based effects like bouncing/springing effects. The 
corresponding settings can be found in the Sidebar 
region > Active Keyframe panel. 


Back: Cubic easing with overshoot and settle. 
Use this one when you want a bit of an 
overshoot coming into the next 
keyframe, or perhaps for some wind-up 
anticipation. 

Back 
The back property controls the size 
and direction (i.e. above/below the 
curve) of the overshoot. 


Bounce: Exponentially decaying parabolic 
bounce, like when objects collide. e.g. 
for Bouncing balls, etc. 


Elastic: Exponentially decaying sine wave, like 
an elastic band. This is like bending a 
stiff pole stuck to some surface, and 
watching it rebound and settle back to 
its original state. 

Amplitude 
The amplitude property controls how 
strongly the oscillation diverges 
from the basic curve. At 0.0, there is 


no oscillation (i.e. it just snaps to the 
B-value like an extreme exponential 
transition), and at 1.0 a profile 
similar to the one shown in the icon 
occurs. 

Period 
The period property controls the 
frequency with which oscillations 
occur. Higher values result in denser 
oscillations. 


Easing 
The Easing Type controls which end of the segment 
between the two keyframes that the easing effects apply 
to. It has no effect if the Interpolation Mode is set to 
either Constant, Linear, or Bézier. 


Automatic Easing: 
The most commonly expected of the 
below behaviors is used. For the 
transitional effects, this is basically 
ease in, while for the physics effects it 
is ease out. 

Ease In: Effect builds up to the second 
keyframe. 

Ease Out: Effect fades out from the first 
keyframe. 

Ease In Out: Effect occurs on both ends of the 
segment. 


Key Frame 
Set the frame for the active keyframe. 


Value 
Set the value for the active keyframe. 


Left/Right Handle Type 
When using Bézier-interpolated curves it is possible to 
control the slope of the curve at the control points. This is 
done via the curve point handles; you can set the type of 
handle to use for the curve points by pressing v or 
choosing Key, Handle Type in the Graph editor menu. 
Each curve point can have a different handle type, even 
within the same curve. 


There are three automatic modes, Automatic, Auto 
Clamped, and Vector, where Blender automatically 
determines the curve’s slope at each control point. The 
neighboring control points have the most influence of the 
Slope, and points further away have a smaller influence. 
This can be controlled per F-Curve with the Auto Handle 
Smoothing properties. 


By using the other, non-automatic modes, you have full 
manual control over the slope. 


Automatic: 


Auto handles. 
Handle positions are automatically 
chosen to produce smooth curves. 


Auto Clamped: 


Vector: 


Aligned: 


Auto clamped handles. 
Automatic handles clamped to prevent 
overshoots and changes in the curve 
direction between keyframes (S- 
shapes). 


Vector handles. 
Creates automatic linear interpolation 
between keyframes. The segments 
remain linear when keyframe centers 
are moved. However, when the handles 
are moved, the handle type switches to 
Free, 


Aligned handles. 
The two handles of the curve point are 
locked together to always point in 
exactly opposite directions. This results 
in a curve that is always smooth at the 
control point. 


Free: 


Free handles. 
The handles can be moved completely 
independently, and thus can result in a 
sharp change of direction. 


Frame, Value 
Set the frame and value for the left/right interpolation 
handle for the active keyframe. 


F-Curve Modifiers 


Reference 


Panel: Sidebar region > Modifiers >» Modifiers 


F-Curve modifiers are similar to object modifiers, in that 
they add non-destructive effects, that can be adjusted at 
any time, and layered to create more complex effects. Like 
object modifiers, F-Curve modifiers are evaluated from the 
top down. In other words, the top modifier is calculated first 
and consequent modifiers are calculated in order. Modifiers 
can be moved by dragging the modifier box from the top 
right. 


Modifiers can be muted or hidden by toggling the checkbox 
in the modifier’s panel header. They can be removed using 
the delete button in the modifier’s panel header. 


Adding a Modifier 


Y Modifiers 


Add Modifier 


> @ Noise 


> Limits 


Modifiers panel. 


The F-Curve modifier panel is located in the Sidebar region. 
Select a curve by selecting one of its curve points, or by 


selecting the channel list. Click on the Add Modifier menu to 
select a modifier. 


Types of Modifiers 


Generator Modifier 


Generator creates a polynomial function. These are basic 
mathematical formulas that represent lines, parabolas, and 
other more complex curves, depending on the values used. 


Mode 
Method used to represent the equation. 


Expanded Polynomial: 
Equation in the form \(\y = x*1 + x*2 
+... + x*n\). 

Factorized Polynomial: 
Equation in the form \(y = (Ax + B)(Cx 
+ D)\). 


Additive 


This option causes the modifier to be added to the curve, 
instead of replacing it by default. 


Order 


Specify the order of the polynomial, or the highest power 
of x for this polynomial. (Number of coefficients: 1.) 


Change the Coefficient values to reshape the curve. 


See also 


The Wikipedia Page for more information on 
polynomials. 


Influence 


Controls the percentage of affect the modifier has on the 
F-Curve. 


Restrict Frame Range 


Start/End 
The frame on which the modifier’s effect starts/ends. 


Blend In, Out 
The number of frames, relative the start/end values 
above, the modifier takes to fade in/out. 


Built-in Function Modifier 


These are additional formulas, each with the same options 
to control their shape. Consult mathematics reference for 
more detailed information on each function: 


Type 
The built-in function to use. 
Sine: Sine. 
Cosine: Cosine. 
Tangent: Tangent. 


Square Root: The square root of the value. 
Natural Logarithm: 

The natural log of the value. 
Normalized Sine: 

\(sin(x)/x\). 


Additive 
This option causes the modifier to be added to the curve, 
instead of replacing it by default. 


Amplitude 
Adjusts the Y scaling. 


Phase Multiplier 
Adjusts the X scaling. 


Phase Offset 
Adjusts the X offset. 


Value Offset 
Adjusts the Y offset. 


Influence 
Controls the percentage of affect the modifier has on the 
F-Curve. 


Restrict Frame Range 


Start/End 
The frame on which the modifier’s effect starts/ends. 


Blend In, Out 
The number of frames, relative the start/end values 
above, the modifier takes to fade in/out. 


Envelope Modifier 


Allows you to adjust the overall shape of a curve with 
control points. 


Reference 
Set the Y value the envelope is centered around. 
Min 
Lower distance from Reference Value for 1:1 default 
influence. 


Max 
Upper distance from Reference Value for 1:1 default 
influence. 


Add Control Point 
Add a set of control points. They will be created at the 
current frame. 


Point 
Frame 
Set the frame number for the control point. 
Min 
Specifies the lower control point’s position. 


Max 
Specifies the upper control point’s position. 


Influence 
Controls the percentage of affect the modifier has on the 
F-Curve. 


Restrict Frame Range 


Start/End 
The frame on which the modifier’s effect starts/ends. 


Blend In, Out 
The number of frames, relative the start/end values 
above, the modifier takes to fade in/out. 


Cycles Modifier 


Cycles allows you add cyclic motion to a curve that has two 
or more control points. The options can be set for before 
and after the curve. 


Note 


The Cycles Modifier can only be the first modifier. 


Before/After Mode 

No Cycles: Do not repeat curve data before/after. 

Repeat Motion: 
Repeats the curve data, while 
maintaining their values each cycle. 

Repeat with Offset: 
Repeats the curve data, but offsets the 
value of the first point to the value of 
the last point each cycle. 

Repeat Mirrored: 
Each cycle the curve data is flipped 
across the X axis. 


Count 
Set the number of times to cycle the data. A value of 0 
cycles the data infinitely. 


Influence 
Controls the percentage of affect the modifier has on the 
F-Curve. 


Restrict Frame Range 


Start/End 
The frame on which the modifier’s effect starts/ends. 


Blend In, Out 
The number of frames, relative the start/end values 
above, the modifier takes to fade in/out. 


Trivially Cyclic Curves 


When the Cycle Mode for both ends is set to either Repeat 
Motion or Repeat with Offset, and no other options of the 
modifier are changed from their defaults, it defines a simple 
infinite cycle. 


This special case receives some additional support from 
other areas of Blender: 


e Automatic Bézier handle placement is aware of the 
cycle and adjusts to achieve a smooth transition. 

e The Cycle-Aware Keying option can be enabled to take 
the cycle into account when inserting new keyframes. 


Noise Modifier 


Modifies the curve with a noise formula. This is useful for 
creating subtle or extreme randomness to animated 
movements, like camera shake. 


Blend Type 
Replace: Adds a -0.5 to 0.5 range noise function 
to the curve. 
Add: Adds a 0 to 1 range noise function to 
the curve. 
Subtract: Subtracts a O to 1 range noise function 
to the curve. 
Multiply: Multiplies a 0 to 1 range noise function 
to the curve. 
Scale 


Adjust the overall size of the noise. Values further from 0 
give less frequent noise. 


Strength 
Adjusts the Y scaling of the noise function. 


Offset 
Offsets the noise in time. 


Phase 
Adjusts the random seed of the noise. 


Depth 
Adjusts how detailed the noise function is. 


Influence 
Controls the percentage of affect the modifier has on the 
F-Curve. 


Restrict Frame Range 


Start/End 
The frame on which the modifier’s effect starts/ends. 


Blend In, Out 
The number of frames, relative the start/end values 
above, the modifier takes to fade in/out. 


Limits Modifier 


Limit curve values to specified X and Y ranges. 


Minimum X, Y 
Cuts a curve off at these frames ranges, and sets their 
minimum value at those points. 


Minimum X, Y 
Truncates the curve values to a range. 


Influence 
Controls the percentage of affect the modifier has on the 
F-Curve. 


Restrict Frame Range 


Start/End 
The frame on which the modifier’s effect starts/ends. 


Blend In, Out 
The number of frames, relative the start/end values 
above, the modifier takes to fade in/out. 


Stepped Interpolation Modifier 


Gives the curve a stepped appearance by rounding values 
down within a certain range of frames. 


Step Size 
Specify the number of frames to hold each frame. 


Offset 
Reference number of frames before frames get held. Use 
to get hold for (1-3) vs (5-7) holding patterns. 


Start Frame 
Restrict modifier to only act before its “end” frame. 


End Frame 
Restrict modifier to only act after its “start” frame. 


Influence 
Controls the percentage of affect the modifier has on the 
F-Curve. 


Restrict Frame Range 


Start/End 
The frame on which the modifier’s effect starts/ends. 


Blend In, Out 
The number of frames, relative the start/end values 
above, the modifier takes to fade in/out. 


Drivers Editor 


The Drivers Editor allows users to drive one property with 
another. See Drivers and F-Curves. 


1] 
a] 
eat 
& a. 
at 
$a% 
& ar 
$a% 
&$ 4% 
$a% 
& ar 
0 
4% 


The Drivers Editor. 


Main Region 


The main view allows you to view and edit Driver F-Curves. 
An F-Curve has several key parts: 


Axes 
The curve defines the relationship between two 
properties: The current (driven) property (Y axis) and the 
driver (X axis). 


See F-Curves. 


Handles 
Each point on the driver curve has a handle that helps 
determine the relationship between the two values. They 
can be selected and modified to change the shape of the 
curve. 


See F-Curve Handles for more information. 


A simple driver. 


See also 


See F-Curves for more info. 


Navigation 


As with most editors, you can: 


Pan MMB 
Pan the view vertically (values) or horizontally (time) with 
click and drag MMB. 


ZOOM Wheel 
Zoom in and out with the mouse wheel. 


Scale View Ctrl-MMB 
Scale the view vertically or horizontally. 


Frame All Home 
Fit the curve in the available space. 


In addition, you can also use the scrollbars to pan and zoom 
the view. 


Header 


View Controls 
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View controls. 


Normalize 
Normalize curves so the maximum and minimum points 
equal 1.0 and -1.0 respectively. 


Auto 
Automatically recalculate curve normalization on 
every curve edit. Disabling this setting may be useful 
to prevent curves from jumping after tweaking. 


Show Only Selected (mouse cursor icon) 
Only include curves related to the selected objects and 
data. 


Show Hidden (dashed object icon) 
Include curves from objects/bones that are not visible. 


Show Only Errors (warning triangle icon) 
Only include curves and drivers that are disabled or have 
errors. Useful for debugging. 


Create Ghost Curves (square with curve icon) 
Makes a visual indication in the background of the editor 
with a snapshot of the current state of the selected 
curves. This is useful to have a base for comparison on 
top of which to make edits. 


Filter (funnel icon) 
Type Filter 
Filter curves by property type. 


Sort Data-Blocks (az icon) 
Object data-blocks appear in alphabetical order, so 
that it is easier to find where they occur (as well as 
helping to keep the animation of related objects 
together). 


This option may affect the playback speed for heavy 
scenes. 


Curve Controls 


- 


ie\v Nearest Frame v (@ 


Curve controls. 


Pivot Point 
Pivot point for rotation. 


Bounding Box Center 
Center of the selected curve handles. 


2D Cursor 
Center of the 2D Cursor. Playhead + Cursor. 


Individual Centers 


Rotate the selected curve handles. 


Auto Snap 
Auto snap the curve handles when editing. 


No Auto-Snap 
Frame Step 
Second Step 
Nearest Frame 
Nearest Second 
Nearest Marker 


Proportional Editing 0 
See Proportional Editing. 


Sidebar Region 


Drivers Tab 


See Drivers Panel. 


Modifiers Tab 


See F-Curve Modifiers. 


View Properties Panel 


¥ ™ Show Cursor 


Cursor X 0.000 
Y 0.000 


Cursor to Selection 


View Properties panel. 


Show Cursor 
Show the vertical Cursor. 


Cursor from Selection 
Set the 2D cursor to the center of the selected curve 
handles. 


Cursor X 
Time Cursor X position. 


Cursor Y 
Vertical Cursor Y position. 


Nonlinear Animation 


Introduction 
o Header 

e Tracks 

o Action Track 

o Action Stashing 
e Strips 

o Action Strips 

o Transition Strips 

o Sound Clip Strips 

o Meta Strips 
e Editing 
Transform 
snap 
Bake Action 
Duplicate 
Linked Duplicate 
Split Strips 
Delete Strips 
Delete Tracks 
Toggle Muting 
Apply Scale 
Clear Scale 
Sync Action Length 
Make Single User 
Swap Strips 
Move Strips Up 
Move Strips Down 
Track Ordering 
Remove Empty Animation Data 
Start Editing Stashed Action 
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e Sidebar 
o Edited Action 
o Strip 
o Modifiers 


Introduction 


The NLA editor, short for NonLinear Animation, can 
manipulate and repurpose Actions, without the tedium of 
handling keyframes. It is often used to make broad, 
significant changes to a scene’s animation, with relative 
ease. It can alSo repurpose, chain together a sequence of 
motions, and “layered” actions, which make it easier to 
organize, and version-control your animation. 


Header 


View Menu 


Adjust Last Operation 
Displays a pop-up panel to alter properties of the last 
completed operation. See Adjust Last Operation. 


Realtime Updates 
When transforming NLA-strips, the changes to the 
animation are propagated to other views. 


Show Control F-Curves 
Overlays a graph of the NLA-strip’s influence on top of 
the strip. 


Show Markers 
Shows the markers region. When disabled, the Markers 
Menu is also hidden and markers operators are not 
available in this editor. 


Show Local Markers 


Shows action-local markers on the strip, this is useful 
when synchronizing time across strips. 


Local markers shown on a strip. 


Set Preview Range P 
Selecting a preview range by dragging in the NLA Editor. 


Clear Preview Range Alt-P 
Unset the preview range 


Auto Select Preview Range Ctrl-Alt-P 


Automatically select the preview range based on the 
range of keyframes. 


See also 


See Timeline’s View Menu. 


Select Menu 


All A 
Select all NLA-strips. 


None Alt-A 
Deselect all NLA-strips. 


Invert Ctrl-I 
Invert the current selection of NLA-strips. 


Box Select B 
Select NLA-strips by drawing a box. All NLA-strips that 
intersects the box will be added to the current selection. 


Border Axis Range Alt-B 
Select NLA-strips by drawing a box. All NLA-strips that 
intersects the frames of the drawn box will be added to 
the current selection. 


Before Current Frame [ 
Select all NLA-strips before the current frame. 


After Current Frame |] 
Select all NLA-strips after the current frame. 


Markers Menu 


Markers are used to denote frames with key points or 
significant events within an animation. Like with most 
animation editors, markers are shown at the bottom of the 
editor. 


Markers in animation editor. 


For descriptions of the different marker tools, see Editing 
Markers. 


Edit Menu 


Transform 
Move 
Move the selected NLA-strips in time or to different 
NLA-track. 


Extend ec 
Extend the selected NLA-strips. 


Scale s 
Scale the selected NLA-strips. 


Snap 
Selection to Current Frame 
Move the start of selected NLA-strips to the current 
frame. 


Selection to Nearest Frame 
Move the start of the selected NLA-strips to the 
nearest frame. 


Selection to Nearest Second 
Move the start of the selected NLA-strips to the 
nearest second. 


Selection to Nearest Marker 
Move the start of the selected NLA-strips to the 
nearest marker. 


Duplicate Shift-D 
Make a copy of the selected NLA-strips. 


Linked Duplicate Alt-D 
Make a shallow copy of the selected NLA-strips. 


Split Strips Y 
NLA-Split the selected strips into two NLA-strips. The split 
happens at the current frame. 


Delete Strips x 
Delete selected NLA-Strips. 


Delete Tracks 
Delete the selected NLA track and all strips that it 
contains. 


Toggle Muting H 
Mute or unmute the selected NLA-strips. Muted NLA- 
Strips will not influence the animation. 


Apply Scale ctrl-a 
Apply the scale of the selected NLA-strips to their 
referenced Actions. 


Clear Scale Alt-s 
Reset the scaling of the selected NLA-strips. 


Sync Action Length 
Synchronize the length of the action to the length used in 
the NLA-strip. 


Make Single User u 
This tool ensures that none of the selected strips use an 
action which is also used by any other strips. 


Swap Strips Alt-F 
Swap the order of the selected NLA-strips in their NLA- 
track. 


Move Strips Up PageUp 
Move selected NLA-strips a track up if there is room. 


Move Strips Down PageDown 
Move selected NLA-strips a track down if there is room. 


Track Ordering 


To Top 
Move selected track to the top of the tracks. 


Up 
Move selected track one track up. 


Down 
Move selected track one track down. 


To Bottom 
Move selected tracks to the bottom of the tracks. 


Remove Empty Animation Data 
Remove Animation Data from selected objects when they 
don’t contain any animation. 


Start Editing Stashed Action Shift-Tab 
It will enter and exit Tweak Mode as usual, but will also 
make sure that the action can be edited in isolation (by 
flagging the NLA track that the action strip comes from 
as being “solo”). This is useful for editing stashed 
actions, without the rest of the NLA Stack interfering. 


Start Tweaking Strips Actions Tab 
The contents of Action strips can be edited, but you must 
be in Tweak Mode to do so. The keyframes of the action 
can then be edited in the Dope Sheet. 


Add 


Add Action Strip Shift-A 
Add an NLA-strip referencing an Action to the active 
track. 


Add Transition Shift-T 


Add an NLA-strip to create a transition between a 
selection of two adjacent NLA-strips. 


Add Sound Strip Shift-Kk 
Add an NLA-strip controlling when the speaker object 
plays its sound clip. 


Add Meta-Strip ctrl-G 
Group selected NLA-strips into a meta strip. A meta strip 
will group the selected NLA-strips of the same NLA-track. 


Remove Meta-Strip Ctrl-Alt-G 
Ungroup selected Meta strips. 


Add Tracks 
Add a new NLA-Track on top of the selected object. 


Add Track Above Selected 
Add a new NLA-Track just above the selected NLA-track. 


Include Selected Objects 
Let the selected objects appear in the NLA Editor. This is 
done by adding an empty animation data object to the 
selected object. 


Tracks 


Tracks are the layering system of the NLA. At its most basic 
level, it can help organize strips. But it also layers motion 
much like an image editor layers pixels - the bottom layer 
first, to the top, last. 
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NLA Tracks and Strips. 


Solo (star icon) 
Toggling Solo Track causes only the selected tracks 
effects to be visible when animating. This is very useful 
for debugging complex animations. 


Mute (checkbox) 
Keeps the track from having an effect on the animation. 
(Mute only applies when Solo is not used.) All strips in 
that track are shown as being muted (dashed outline). 


Lock (padlock icon) 
Prevents changes from being made to this layer. This is 
useful, for example, if you want to select several strips 
and move them; but you want to keep a few tracks 
excluded from the change. 


Action Track 


By default, the Action Editor automatically stores the 
keyframes you create through the 3D Viewport by storing 
them into an action based on the name as the object you 
are working on. 


Push Down Action (push down icon) 
Turns the active action into a new NLA strip at the top of 
the NLA stack. 


Push Down action button. 


Pin (pin icon) 
If you try moving the strip, while in Tweak Mode, you will 
notice that the keys will go along with it. On occasion, 
you will prefer the keys to remain on their original 
frames, regardless of where the strip is. To do so, hit the 
unpin icon, next to the strip. 
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NLA strip with pinned keys. 
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The unpinned keys return to their original frames. 


Action Stashing 


When creating a new action, if the existing action only has a 
single user (i.e. the current reference only), it will get 
“stashed” in the NLA stack. Action Stashing should prevent 
most cases actions getting lost. 


The action “stashing” method works by storing otherwise 
unused/dormant actions in the NLA stack as strips in special 
muted NLA tracks. This way, the action is linked up to a 


particular data-block (i.e. to a specific object, or to a specific 
material/light/etc.) and will be preserved for later use. 


Deleting & Converting 


If you decide that you no longer want a stashed action 
anymore, simply delete the corresponding NLA strip, then 
save and reload the file. 


Also, note that since these are NLA strips, you can reuse 
these as normal NLA strips simply by un-muting (and 
renaming) the NLA track they live in. You may also want to 
move it above all the other stashed-action tracks. 


Strips 


There are four kinds of strips: Action, Transition, Sound clip 
and Meta. 


Action Strips 


Action Strips are a container of keyframe data of an action. 
Any action used by the NLA first must be turned into an 
Action strip. This is done so by clicking the Push Down 
Action button see above. Alternatively, you can go to Add > 
Action Strip. 


Note 


Action Strips only playback the keyframe data that fits into 
the length of the strip. This includes any modifiers that 
might extend keyframe data. 


Transition Strips 


Transitions interpolate between Actions. They must be 
placed in between other strips. Select two or more strips on 
the same track, and go to Add >» Transition. 


Transition Strip. 


Sound Clip Strips 


Controls when a speaker plays a sound clip. Add » Sound 
Clip. 


Meta Strips 


Meta strips group strips together as a whole, so you can 
move them as one. If you find yourself moving a lot of strips 
together, you can group them into a Meta strip. A Meta strip 
can be moved and duplicated like a normal strip. 


Reference 
Menu: Add » Add Meta-Strips 
Shortcut: Shift-G 


Select two or more Combine them into a 
Strips. meta strip. 


A Meta strip still contains the underlying strips. You can 
ungroup a Meta strip. 


Reference 


Menu: Add >» Remove Meta-Strips 
Shortcut: Alt-G 


Editing 
Transform 


Todo. 


Snap 


Todo. 


Bake Action 


Reference 

Editor: Nonlinear Animation 

Menu: Edit » Bake Action 

Reference 

Editor: 3D Viewport 

Mode: Object and Pose Modes 

Menu: Header > Object Animation >» Bake 


Action... 


The final motion of objects or bones depends not only on 
the keyframed animation, but alSo on any active F-Curve 
modifiers, drivers, and constraints. On each frame of all the 
scene’s frames, the Bake Action operator computes the final 
animation of the selected objects or bones with all those 


modifiers, drivers, and constraints applied, and keyframes 
the result. 


This can be useful for adding deviation to a cyclic action like 
a Walk Cycle, or to create a keyframe animation created 
from drivers or constraints. 


Duplicate 


Reference 


Menu: Edit » Duplicate 


Creates a new instance of the selected strips with a copy of 
the action. 


Linked Duplicate 


Reference 
Menu: Edit » Linked Duplicate 
Shortcut: Alt-D 


The contents of one Action strip can be instanced multiple 
times. To instance another strip, select a strip, go to Edit > 
Linked Duplicate. It will uses the same action as the 
selected strips. 


Now, when any strip is tweaked, the others will change too. 
If a strip other than the original is tweaked, the original will 
turn to red. 


Linked duplicated strip being edited. 


Split Strips 
Todo. 

Delete Strips 
Todo. 

Delete Tracks 
Todo. 

Toggle Muting 
Todo. 

Apply Scale 


Todo. 


Clear Scale 


Todo. 


Sync Action Length 


Todo. 


Make Single User 


Reference 
Menu: Edit » Make Single User 
Shortcut: U 


This tool ensures that none of the selected strips use an 
action which is also used by any other strips. 


Note 


This does not recursively go inside meta strips. 


Swap Strips 
Todo. 


Move Strips Up 


Todo. 


Move Strips Down 


Todo. 


Track Ordering 


Todo. 


Remove Empty Animation Data 


Reference 


Menu: Edit » Remove Empty Animation Data 


This operator removes AnimData data-blocks (restricted to 
only those which are visible in the animation editor where it 
is run from) which are “empty” (i.e. that is, have no active 
action, drivers, and NLA tracks or strips). 


It is sometimes possible to end up with a lot of data-blocks 
which have old and unused Animation Data containers still 
attached. This most commonly happens when doing motion 
graphics work (i.e. when some linked-in objects may have 
previously been used to develop a set of reusable assets), 
and is particularly distracting in the NLA Editor. 


Start Editing Stashed Action 


Reference 


Menu: Edit » Start Editing Stashed Action 
Shortcut: Shift-Tab 


It will enter and exit Tweak Mode as usual, but will also 
make sure that the action can be edited in isolation (by 
flagging the NLA track that the action strip comes from as 
being “solo”). This is useful for editing stashed actions, 
without the rest of the NLA Stack interfering. 


When you finished editing the strip, simply go to Edit >» Stop 
Editing Stashed Action or press Shift-Tab. 


Strip in NLA mode. Strip in Tweak mode. 


Start Tweaking Strips Actions 
(Full Stack) 


Reference 


Menu: Edit » Start Tweaking Strips Actions (Full 
Stack) 


Allows you to edit the contents of the strip without disabling 
all the tracks above the tweaked strip. This allows 
keyframing to work as expected, and preserves the pose 
that you visually keyed. 


When you finished editing the strip, simply go to Edit >» Stop 
Tweaking Strips Actions or press Tab. 


Note 


For transitions above the tweaked strip, keyframe 
remapping will fail for channel values that are affected by 
the transition. A work around is to tweak the active strip 
without evaluating the upper NLA stack. 


Start Tweaking Strips Actions 
(Lower Stack) 


Reference 

Menu: Edit » Start Tweaking Strips Actions 
(Lower Stack) 

Shortcut: Tab 


The contents of Action strips can be edited, but you must be 
in Tweak Mode to do so. The keyframes of the action can 
then be edited in the Dope Sheet. 


When you finished editing the strip, simply go to Edit >» Stop 
Tweaking Strips Actions or press Tab. 


Sidebar 
Edited Action 


Reference 


Panel: Sidebar >» Edited Action 


Y Animation Data 
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Animations 


CubeAction 


Actio.. Hold 


Modifiers 


Actio.. Replace 


Action Influence: 


Edited Action panel. 


This pannel is avalable for actions that have not been 
“Pushed Down”. 


Action 
A Data-Block menu that allows you to edit actions shown 
in the action track. See also the Action Editor’s Action. 


Extrapolation 
Action to take for gaps past the strip extents. 


Hold 
Affects both sides of the strip. This should only be set 
on the very first strip. When the order of strips 
changes (for example by dragging them in the NLA 


editor), a strip that is marked as Hold is no longer the 
very first strip will automatically be set to Hold 
Forward by Blender. 


Hold Forward 


Affects the region after the clip, only. This can be set 
on any Strip. 


Nothing 


Affects only the region of the strip itself. This can be 
set on any strip. 


Blending 


Affects how the property values directly produced by the 
Strip are combined with the result of evaluating the stack 
below. The bottom-most strip is blended on top of the 
default values of the properties. 


Replace 


The top strip is linearly blended in with the 
accumulated result according to influence, completely 
overwriting it if influence is set to 100%. 


Multiply, Subtract, Add 


The result of the strip is multiplied, subtracted, or 
added to the accumulated results, and then blended 
in according to influence. 


\(result = mix(previous, previous (+-*) value, 
influence)\) 


Combine 


Depending on the type of each property, one of the 
following methods is automatically chosen: 


Axis/Angle Rotation 


\(result = previous + value * influence\) 


This results in averaging the axis and adding the 
amount of rotation. 


Quaternion Rotation 
Quaternion math is applied to all four channels of 
the property at once: 


\(result = {previous} \times {value} * 
{influence }\) 


Proportional (Scale) 
\(result = previous * (value / default) * 
{influence }\) 


Others 
\(result = previous + (value - default) * 
{influence }\) 


This allows layering actions that can also be used as a 
standalone. Properties keyframed at their default 
values remain at default. 


Note 

Since this blending mode is based on using 
quaternion multiplication to calculate the Quaternion 
Rotation properties, it always drives all four channels 
during playback, and /nsert Single Keyframe is forced 
to insert all four keys. Other types of channels can 
still be keyed individually. 


Influence 
Amount the active Action contributes to the result of the 


NLA stack. 


Strip 


Name 
Name of the track which the strip currently belongs to. 


Mute 
Toggles NLA strip evaluation, the strip outline will be 
dashed. 


Active Strip 


Reference 


Panel: Sidebar » Strip » Active Strip 


Y Active Strip 
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Name 
Type 
Strip Extents 
Start Frame: 
End Frame: 
Extrap.. Hold Forward 
Blendin.. Replace 
Auto Blend In/Out 
Blend In: 
Blend Out: 
Playback Settings 
Muted 


Reversed 


Active Strip panel. 


Frame Start, End 
The boundaries of the strip itself. Note that this will 
stretch the duration of the Action, it will not cause 


greater or fewer keyframes from the Actions to play (see 
below for that option). 


Extrapolation 
See Extrapolation. 


Blending 
See Blending. 


Blend In, Out 
The first and last frame that represents when this strip 
will have full influence. 


Auto Blend In/Out 
Creates a ramp starting at the overlap of the strips. The 
first strip has full control, and it ramps linearly giving the 
second strip full control by the end of the overlapping 
time period. 


Playback 
Reversed 
Cause this strip to be played completely backwards. 


Cyclic Strip Time 
Cycle the animated time within the action start and 
end. 


Animated Influence 


Enabling alteration of the degree of influence this strip has 
as a keyframable value. If influence isn’t animated, the 
Strips will fade linearly, during the overlap. These can be 
found in the Dope Sheet or Graph Editors under the NLA 
Control! Curves and look like group channels. They appear 
before all the groups or F-Curves for that channel. 


Animated Strip Time 
Same as Animated Influence, but with Strip Time. 
Action Clip 


Reference 


Panel: Sidebar region > Animations » Action Clip 


¥ Action Clip 


Action 

Action Extents 
Start Frame: 
End Frame: 

Sync Length 

Playback Settings 
Scale: 
Repeat: 


Action Clip panel. 


This represents the ‘object data’ of the strip. Much like the 
transform values of an object. 


Action 


A reference to the Action contained within the strip. Can 
be changed to replace the current strip’s value with 
another Action. 


Frame Start, End 
How much of the Action to use. 


For instance, it is common to set the first and last 
keyframe of an Action to be the same keyframes. The 


problem with this is if you loop the animation, there is a 
Slight hitch where the same keyframes are played twice. 
To fix this, simply reduce the End Frame. 


Note 

If you select values that are above or below the actual 
keyframe count of the Action, then the F-Curve 
Extrapolation will be applied. 


Sync Length 
Causes the Start and End Frames, above, to be reset to 
the first and last keyframed frames of the Action. 


Now 
The Now button causes the Start and End Frames, above, 
to be reset to the first and last keyframed frames of the 
Action. 


Playback Scale 
Stretches strip, another way of increasing the Strip 
Extents: End Frame, above. 


Repeat 
Also expands the strip, but by looping from the first 
keyframe and going forward. 


Action 
Reference 
Panel: Sidebar region > Animations » Action 


This panel is identical to the one in Dope Sheet, and allows 
viewing or changing properties of the action used in the 


Action Clip, i.e. Manual Frame Range. 
Modifiers 


Reference 


Panel: Sidebar region > Modifiers >» Modifiers 


Like its counterparts in graph and video editing, Modifiers 
can stack different combinations of effects for strips. 


See F-Curve Modifiers. 


Text Editor 


Blender has a Text Editor among its editor types, accessible 
via the Editor type menu, or the shortcut Shift-F11. 


Header 


The newly opened Text editor is empty, with a very simple 
header. More options become available when a text file is 
created or opened. 


ew Text Templates ff» + New [gy Open 


Text header. 


Text header with a text loaded. 


Editor Type 
The standard editor selection button. 


Menus 
Editor’s menus. 


Resolve Conflict 


Resolves modified file conflicts when an external text file 
is updated from another program. 


Reload from Disk 
Opens the file from drive again, overriding any local 
changes. 


Make Text Internal 
Converts the external text data-block into an internal 
one. 


Ignore 
Hides the warning message until the external text file 
is modified externally again. 


Text 


A data-block menu to select a text or to create a new 
one. After that the header will change. 


Run Script (play icon) 
Executes the text as a Python script Alt-P. See Template 
Menu. 


Show 
Toggle display options. 


Line Numbers, Word Wrap, Syntax Highlighting 


Script Node Update (refresh icon) 
When an OSL-file is opened, this updates the Shader 
Script node with new options and sockets from the script. 


View Menu 


Sidebar Ctrt-T 
Show or hide the Sidebar. 


Line Numbers 
Displays the text file’s line numbers on the left of the 
Main View. 


Word Wrap 


Wraps words that are too long to fit into the horizontal 
Space by pushing them to a new “pseudo line”. 


Syntax Highlight 
Colors special words, in the Main View, that are used in 
the Python programming language. 


Highlight Line 
Emphasizes the active line by altering the color of the 
background. 


Navigation 
Top Ctrl-Home 
Moves the view and cursor to the start of the text file. 


Bottom Ctrl-End 
Moves the view and cursor to the end of the text file. 


Line Begin Home 
Moves the cursor to the start of the current line. 


Line End End 
Moves the cursor to the end of the current line. 


Previous Line Up 
Moves the cursor to the same position in the line 
above the current line. 


Next Line Down 
Moves the cursor to the same position in the line 
below the current line. 


Previous Word Ctrl-Left 
Moves the cursor to the beginning of the previous 
word. If the cursor is in the middle of a word, the 
cursor is moved to the beginning of the current word. 


Next Word Ctrl-Right 
Moves the cursor to the end of the next word. If the 
cursor is in the middle of a word, the cursor is moved 
to the end of the current word. 


Text Menu 


New Alt-N 
Creates a new text Data Block. 


Open Text Block Alt-o. 
Loads an external text file that is selected via the File 
Browser. 


Reload Alt-R 
Reopens (reloads) the current buffer (all non-saved 
modifications are lost). 


Save Alt-S 
Saves an already open file. 


Save AS Shift-Ctrl-Alt-S. 
Saves text as a new text file, a File Browser is opened to 
select the directory to save the file along with giving the 
file a name and file extension. 


Register 
Run the text data-block as a Python script on loading the 
blend-file. Read more about the registration of Python 
modules in API documentation. 


Live Edit 
Todo. 


Run Script Alt-P 


Executes the text as a Python script, see Running Scripts 
for more information. 


Edit Menu 


Undo/Redo 
See Undo & Redo. 


Cut ctrl-x 
Cuts out the marked text into the text clipboard. 


Copy Ctrl-c 
Copies the marked text into the text clipboard. 


Paste Ctrl-vV 
Pastes the text from the clipboard at the cursor location 
in the Text editor. 


Duplicate Line ctr1-D 
Duplicates the current line. 


Move Line(s) Up Shift-Ctrl-Up 
Swaps the current/selected line(s) with the above. 


Move Line(s) Down Shift-Ctrl-Down 
Swaps the current/selected line(s) with the below. 


Find & Replace Ctrl-F 
Shows the Find & Replace panel in the Sidebar. 


Find & Set Selection ctr1l-G 
Finds the next instance of the selected text. 


Jump To ctrl-J 
Shows a pop-up, which lets you select a line number 
where to move the cursor to. 


Text Auto Complete Tab 
Shows a selectable list of words already used in the text. 


Text to 3D Object 
Converts the text file to a Text Object either as One 
Object or One Object Per Line. 


Select Menu 


All Ctrl-A 
Selects the entire text file. 


Line Shift-Ctrl-A 
Selects the entire current line. 


Word double-click LMB 
Selects the entire current word. 


Top Shift-Ctrl-Home 
Selects everything above the cursor. 


Bottom Shift-Ctrl-End 
Selects everything below the cursor. 


Line Begin Shift-Home 
Selects everything between the beginning of the current 
line and the cursor. 


Line End Shift-End 
Selects everything between the cursor and the end of the 
current line. 


Previous Line Shift-Up 
Selects everything between the cursor and the position 
of the cursor one line above. 


Next Line Shift -Down 


Selects everything between the cursor and the position 
of the cursor one line below. 


Previous Word Shift-Ctrl-Left 
Selects everything between the cursor and the beginning 
of the previous word. If the cursor is in the middle of a 
word, select everything to the beginning of the current 
word. 


Next Word Shift-Ctrl-Right 
Selects everything between the cursor and the end of the 
next word. If the cursor is in the middle of a word, select 
everything to the end of the current word. 


Format Menu 


Indent Tab 
Inserts a tab character at the cursor. 


Unindent Shift-Tab. 
Unindents the selection. 


Toggle Comments Ctrl-Stlash. 
Toggles whether the selected line(s) are a Python 
comment. If no lines are selected the current line is 
toggled. 


Convert Whitespace 
Converts indentation characters To Spaces or To Tabs. 


Template Menu 
The Text Editor has some dedicated Python scripts, which 


are useful for writing tools, like a class/function/variable 
browser, completion... 


Python, OpenShading Language 


Main View 


Typing on the keyboard produces text in the text buffer. 


As usual, pressing, dragging and releasing LmB selects text. 
Pressing RMB opens the context menu. 


Tip 
Usages for the Text editor 


The Text editor is handy also when you want to share your 
blend-files with others. The Text editor can be used to write 
iN a README text explaining the contents of your blend-file. 
Be sure to keep it visible when saving! 


Sidebar 


Find & Replace 


Find Text Ctrl-F 
Searches for instances of a text that occur after the 
cursor. Using the eyedropper icon will search for the 
currently selected text and sets the selection to the 


match. Find Next searches for the next instance of the 
text. 


Replace Text Ctrl-H 
Searches for the text specified in Find Text and replaces 
it with the new text. Using the eyedropper icon will set 
the currently selected text as the replace text. Replace 


searches for the next match and replaces it. Replace All 
searches for the match and replaces all occurrences of 
the match with the new text. 


Case 
Search is sensitive to upper-case and lower-case letters. 


Wrap 
Search again from the start of the file when reaching the 
end. 


All 
Search in all text data-blocks instead of only the active 
one. 


Properties 


Margin 
Shows a right margin to help keep line length at a 
reasonable length when scripting. The width of the 
margin is specified in Margin Column. 


Font Size Ctrl-wheelUp 
The size of the font used to display text. 


Tab Width 
The number of character spaces to display tab characters 
with. 


Indentation 
Use Tabs or Spaces for indentations. 


Footer 


The Text editor footer displays if the text is saved internal or 
external and if there are unsaved changes to an external 
file. For external files, this region also displays the file path 
to the text file. 


Usage 


Running Scripts 


The most notable keystroke is Alt-P which makes the 
content of the buffer being parsed by the internal Python 
interpreter built into Blender. Before going on it is worth 
noticing that Blender comes with a fully functional Python 
interpreter built-in, and with a lots of Blender-specific 
modules, as described in the Scripting & Extending Blender 
section. 


Python Console 


The Python Console is a quick way to execute commands, 
with access to the entire Python API, command history and 
auto-complete. The command prompt is typical for Python 
3.x, the interpreter is loaded and is ready to accept 
commands at the prompt >>>. 


The Python Console is a good way to explore the 
possibilities of Blender built-in Python. The Python Console 
can be used to test small bits of Python code which can then 
be pasted into larger scripts. 


Autocomplete 


Python Console. 


Interface 


Header Menus 
View Menu 


Zoom In / Zoom Out 
Increases/Decreases the font size of the console text. 


Move to Previous Word Ctrl-Left 
Moves the cursor to the beginning of the previous word. 
If the cursor is in the middle of a word, the cursor is 
moved to the beginning of the current word. 


Move to Next Word Ctrl-Right 
Moves the cursor to the end of the next word. If the 
cursor is in the middle of a word, the cursor is moved to 
the end of the current word. 


Move to Line Begin Home 
Moves the cursor to the start of the current line. 


Move to Line End End 
Moves the cursor to the end of the current line. 


Console Menu 


Clear All 
Refreshes the console giving the view a fresh start. Note 
that command history is not cleared. 


Clear Line Shift-Return. 
Removes everything from the prompt line. 


Delete Previous Word Ctri-Backspace 
Deletes everything between the cursor and the beginning 
of the previous word (separated by periods). If the cursor 
is in the middle of a word, deletes everything to the 
beginning of the current word. 


Delete Next Word ctrl-Delete 
Deletes everything between the cursor and the end of 
the next word. If the cursor is in the middle of a word, 
deletes everything to the end of the current word. 


Copy as Script Shift-Ctrl-c 
Copies the full history buffer to the clipboard, this can be 
pasted into a text file to be used as a Python script. 


Copy Ctrl-c 
Copy the selection. 


Paste Ctrl-V 
Paste into the command line. 


Indent Tab 
Inserts a tab character at the cursor. 


Unindent Shift-Tab 
Unindents the selection. 


Backward in History Up 
Changes the current command to previous command as 
they appear in the command history. 


Forward in History Down 
Changes the current command to next command as they 
appear in the command history. 


Autocomplete Tab 
See Auto Completion for more information. 


Main View 


Key Bindings 


e Left / Right - Cursor motion. 

e Ctrl-Left / Ctrl-Right - Cursor motion, by word. 
e Backspace / Delete - Erase characters. 

e Ctrl-Backspace / Ctrl-Delete - Erase words. 

e Return - Execute command. 


e Shift-Return - Add to command history without 
executing. 


Usage 


Aliases 


Some variables and modules are available for convenience: 
e C: Quick access to bpy. context. 


e D: Quick access to bpy.data. 
e bpy: Top level Blender Python API module. 


First Look at the Console Environment 


To check what is loaded into the interpreter environment, 
type dir() at the prompt and execute it. 


Auto Completion 


Now, type bpy. and then press Tab and you will see the 
Console auto-complete feature in action. 


Console Autocomplete 


You will notice that a list of submodules inside of bpy appear. 
These modules encapsulate all that we can do with Blender 
Python API and are very powerful tools. 


Lets list all the contents of bpy.app module. 


Notice the green output above the prompt where you 
enabled auto-completion. What you see is the result of auto 
completion listing. In the above listing all are module 
attributed names, but if you see any name end with (, then 
that is a function. 


We will make use of this a lot to help our learning the API 
faster. Now that you got a hang of this, lets proceed to 
investigate some of modules in bpy. 


Before Tinkering with the Modules 


If you look at the 3D Viewport in the default Blender scene, 
you will notice three objects: Cube, Light and Camera. 


e All objects exist in a context and there can be various 
modes under which they are operated upon. 

e At any instance, only one object is active and there can 
be more than one selected object. 

e All objects are data in the blend-file. 


e There are operators/functions that create and modify 
these objects. 


For all the scenarios listed above (not all were listed, mind 


you...) the bpy module provides functionality to access and 
modify data. 


Examples 
bpy.context 


Note 


For the commands below to show the proper output, make 
sure you have selected object(s) in the 3D Viewport. 


P-]» Console Autocomplete 


>>> bpy.context.mode 


>>> bpy.context.active object 


>>> bpy.context.selected objects 


bpy.context.mode 
Will print the current 3D Viewport mode (Object, Edit, 
Sculpt, etc.). 


bpy.context.object OF bpy.context.active object 
Will give you access to the active object in the 3D 
Viewport. 


Change the X location to a value of 1: 
bpy.context.object.location.x = 1 

Move the object from previous X location by 0.5 unit: 
bpy.context.object.location.x += 0.5 

Change the X, Y, Z location: 
bpy.context.object.location = (1, 2, 3) 

Change only the X, Y components: 
bpy.context.object.location.xy = (1, 2) 

The data type of object’s location: 
type(bpy.context.object. location) 

Now that is a lot of data that you have access to: 
dir(bpy.context.object. location) 


bpy.context.selected objects 
Will give access to a list of all selected objects. 


Type this and then press Tab: 
bpy.context.selected objects 

To print out the name of first object in the list: 
bpy.context.selected objects[0] 


The complex one... But this prints a list of objects not 
including the active object: 


[obj for obj in bpy.context.selected objects if obj != 
bpy.context.object] 


bpy.data 


bpy.data has functions and attributes that give you access to 
all the data in the blend-file. 


You can access following data in the current blend-file: 
objects, meshes, materials, textures, scenes, screens, 
sounds, scripts, etc. 


That is a lot of data. 


P-]¥ Console Autocomplete 


>>> bpy.data.objects 


>> for object in bpy.data.objects: 
print(f"{object.name} is at location {object.location}") 


bpy.ops 


The tool system is built around the concept of operators. 
Operators are typically executed from buttons or menus but 
can be called directly from Python too. 


See the bpy.ops API documentation for a list of all operators. 


Info Editor 


The Info editor logs executed operators, warnings and error 
messages. Logged reports can be selected by clicking on 
them. To select multiple reports, hold down Shift-LMB. 


Info Editor. 


Interface 


Header Menus 
View Menu 


Area 
Area controls, see the user interface documentation for 


more information. 
Info Menu 


Select All A 
Selects the full log history. 


Deselect All Alt-A 
Deselects any selected reports. 


Invert Selection Ctrl-I 


Selects non-selected reports and deselects existing 
selection. 


Box Select B 
Selects reports inside the defined box. 


Delete x 
Removes selected reports from the log. 


Copy Ctrl-c 
Copies selected reports to the clipboard. 


Outliner 


Introduction 

Interface 

Selecting_and Activating 
Editing 

Usage 


Introduction 


The Outliner is a list that tev (ly = 
organizes data in the = scene Collection 
blend-file, i.e. the scene v (Em Collection 
data, Video Sequencer Camera 


data, or anything that 


gets stored in a blend-file. Light 


The Outliner can be used 


to: 


The Outliner editor. 


View the data in the 

scene. 

Select and deselect objects in the scene. 

Hide or show an object in the scene. 

Enable or disable selection (to make an object 
“unselectable” in the 3D Viewport). 

Enable or disable the rendering of an object. 
Delete objects from the scene. 

Unlink data (equivalent to pressing the X button next to 
the name of a data-block). 

Manage collections in the scene. 


Each row in the Outliner shows a data-block. You can LMB 
click the disclosure triangle to the left of a name to expand 
the current data-block and see what other data-blocks it 
contains. Holding Shift when clicking on the disclosure 
triangle will expand child data-blocks recursively. LMB 
Clicking and dragging along disclosure triangles will expand 
or collapse multiple data-blocks. 


Example 


¥ (W) backpack GEO 
> Plane.o22  &} 
4) robo rs A SH A 


> a Vertex Groups 


v V body_noSmooth GEO 

- Plane.oos 360s 3 
- V body_smooth_GEO 
> V cape _flap_GEO 


v V cape_GEO 


ground V 
sun charger ¥V; 


sun charger redLight © 


The Outliner with different kinds of data. 


Interface 


Header 


Display Mode 


The editors header has a select menu that let you filter what 
the Outliner should show. It helps to narrow the list of 
objects so that you can find things quickly and easily. 


Scenes 
Shows everything the Outliner can display (in all scenes, 
all view layers, etc.). 


View Layer 
Shows all the collections and objects in the current view 
layer. 


Video Sequencer 
Lists data, images and videos, that are used by the Video 
Sequencer. 


Blender File 
Lists all data in the current blend-file. 


Data API 
Lists every data-block along with any properties that they 
might have. 


Library Overrides 
Display library override data in the current blend-file. 
Separated further into two view modes: 


Properties: 
Display data-blocks with overridden properties. The 
overridden properties are listed together with widgets 
to modify the value of the properties. 


Hierarchies: 
Visualize the hierarchical dependencies between data- 
blocks with library overrides. For example, to create a 
library override of a mesh used by an object inside of 
a linked collection, Blender automatically creates 
(disabled) library overrides for the object and the 
collection, resulting in a collection > object > mesh 
library override hierarchy. 


This library override view mode has a column on the 
right side of the editor to toggle if the library is 
editable or not. 


Orphan Data 
Lists data-blocks which are unused and/or will be lost 
when the file is reloaded. It includes data-blocks which 
have only a fake user. You can add/remove Fake User by 
clicking on cross/tick icon in the right side of the Outliner 
editor. 


Display Filter 


You can search the view for data-blocks, by using Search 
field in the header of the Outliner, 


Filter 


Restriction Toggles 
Set which Restriction Columns should be visible. 


Sort Alphabetically 
Sort the entries alphabetically. 


Sync Selection 
Sync Outliner selection to and from the 3D Viewport and 
Video Sequencer editors. Disable to manage collections, 
object relations, and scene data without changing the 
selection state. Selection syncing is only available in 
Scenes, View Layer, and Video Sequencer display modes. 


Show Mode Column 
Show the object mode toggling column in View Layer and 
Scenes display modes. 


Search 


Exact Match 
The results of Display Filter must match the full text and 
not just a part of it. 


Case Sensitive 
The results of Display Filter are case sensitive. 


Filter 


Some options will only show if compatible with the active 
Display Mode. 


All View Layers 
Toggle between only the active or all the view layers of 
the scene. Combined with disabling the Objects filter it 
gives a compact overview of all the collections in relation 
to the view layers. 


Collections 


List the objects and collections under the collection 
hierarchy of the scene. Objects may appear in more than 
one collection. 


Objects 
List of all the objects, respecting the other filter options. 
Disabled only if you need an overview of the collections 
without the objects. 


Object State 
List the objects based on their state or restrictions. The 
results can be inverted using the /nvert button. 


All 
The default option, no restrictions. 
Visible 
List only the objects visible in the viewports. The 
global and temporary visibility settings are taken into 
consideration. 
Invisible 
List only the objects not visible in the viewports. 
Selected 
Lists the object(s) that are currently selected in the 3D 
Viewport. See selecting in the 3D Viewport for more 
information. 
Active 
Lists only the active (often last selected) object. 
Selectable 


List all objects whose Selectability option is enabled. 


Object Contents 
List materials, modifiers, mesh data, ... 


Object Children 
List the object children. If the Collections option is 
enabled, you will see the object children even if the 
children are not in the collection. Yet the Outliner shows 
them as a dashed line. 


Data-Block 
Allows you to filter out certain data-blocks currently 
present in the scene. 


System Overrides 
Shows the data-block properties that are 
defined/controlled automatically (e.g. to make users of 
an overridden data-block point to the override data, not 
the original linked data). Only available in the Library 
Overrides Display Mode. 


Miscellaneous 


Some options in the header will only show if compatible with 
the active Display Mode. 


New Collection (View Layer) 
Add a new collection inside selected collection. 


Filter by Type (Orphan Data, Blender File) 
Restrict the type of the data-blocks shown in the Outliner. 


Keying Sets (Data API) 
Add/Remove selected data to the active Keying Set. 


Drivers 
Add/Remove Drivers to the selected item. 


Purge (Orphan Data) 


Recursively remove all unused data-blocks from the file 
(cannot be undone). 


Main Region 


Object Mode 


The far left of the Outliner contains a region to toggle the 
current Object Mode. When an object is in a mode other 
than Object Mode, the mode icon will be displayed in this 
region. Any other objects that are valid to be added or 
Swapped into the current mode display a dot. Clicking the 
dot icon will swap that object with the current active object. 
For modes that support Multi-Object Editing, ctri-LMB on the 
dot icon will add that object to the current mode. Clicking 
the mode icon next to the active object removes it or all 
other objects from the current mode depending if multiple 
object are in the same mode. 


Restriction Columns 


The following toggles, in the right side of the Outliner editor, 
are available for collections, objects, bones, modifiers and 
constraints. 


By default only the temporary viewport visibility is enabled. 
The other options can be enabled in the Restriction Toggles 
option in the Outliner filter. 


e Holding Shift sets or unsets the value to all its child 
collections or objects. 

e Holding ctrl isolates the object or collection, so they are 
the only ones with its value set. 


Enable Collection (checkbox, collection only) 
Exclude the collection from the view layer. 


Visibility (eye icon) 
Toggles the visibility of the object or collection in the 3D 
Viewport. This is a file-local setting, and does not get 
imported when this data-block is linked into another 
blend-file. Objects hidden this way are still part of the 


View Layer and evaluated, so they still affect playback 
performance. 


Note 


The following options are hidden by default and need to be 
enabled in the Outliner Filter before they can be used. 


Selectability (mouse cursor icon) 
Toggles the ability to select the objects from the 3D 
Viewport. This is useful for if you have placed something 
in the scene and do not want to accidentally select it 
when working on something else. 


Global Viewport Visibility (Screen icon) 
This will still render the object/collection, but it will be 
ignored by all the viewports. Often used for collections 
with high-poly objects that need to be instanced in other 
files. Objects hidden this way are no longer part of the 
View Layer, are not evaluated, and such do not 
negatively affect playback performance. 


Rendering (camera icon) 
This will still keep the object visible in the scene, but it 
will be ignored by the renderer. Usually used by support 
objects that help modeling and animation yet do not 
belong in the final images. 


Holdout (collection only) 
Mask out objects in collection from view layer. 


Indirect Only (collection only) 
Objects in these collections only contribute to indirect 
light - Cycles only. 


Selecting and Activating 


Selection is 
done with LMB 
(and/or the v {Ee Collector 
context menu) 
on the row of a 
data-block. 
Single 
selections will 
also activate 
the data-block. Selected data-blocks with the Cube active. 
The rows of 

selected data- 

blocks are highlighted blue, with the active data-block 
highlighted in a lighter blue. 


Scene Collection 


Clicking in empty space below the list of data-blocks will 
deselect all. 


Note 


By default, selecting data-blocks in the Outliner will select 
the respective objects, bones, and sequences in the 3D 
Viewport and Video Sequencer. Selections in the 3D 
Viewport and Video Sequencer will be synced to each 
Outliner. To disable selection syncing, turn off the toggle in 
the filter popover. 


Children of a data-block can also be selected by clicking the 
icon that is displayed to the right of the parent data-block’s 
name. 


Selecting Multiple Data-Blocks 


Extend the selection one data-block at a time using Ctrl-LMB. 
Each data-block added to the selection this way will be 
made the active data-block. 


Select a range of elements from the active element using 
Shift-LMB. To select a range without deselecting the previous 
selection, use Shift-Ctrl-LMB. 


A click and drag from any location in the Outliner other than 
a name or icon will begin a box selection. Use Shift to add 
and ctrl to subtract from existing selections with box select. 
Box select can also be started with B. 


To select all items use A; Alt-A will deselect all items. 


The keyboard arrow keys can be used to navigate and select 
in the Outliner. Keyboard selection and navigation starts 
from the active data-block. 


Up Select the previous element in the list. 
Down Select the next element in the list. 


Select the previous element without 


Shift- 
zee deselecting. 


Shift-Down Select the next element without deselecting. 


Left Close the data-block or select the parent. 


Right Open the data-block to view children or select 
the first child. 


Shift-Left Close this and all child data-blocks. 


Shift-Right Open this and all child data-blocks. 


Properties Editor Sync 


When clicking the data-block icons or any other data icon 
(modifiers, constraints, object data, etc.), Properties will 
change to the corresponding tab to modify the properties of 
that data-block.This feature can be enabled or disabled in 
Properties editor using the Sync with Outliner option. 


Editing 
Context Menu 


Show the context menu for a data-block with Rms on the icon 
or name. Depending on the type of the preselected data- 
block(s), you will have all or part of the following options: 


Copy/Paste 
Copy/pastes selected data-blocks. 


Delete 
Deletes the selected data-block. 


Select, Select Hierarchy, Deselect 
Add object to current selection without making it the 
active one. 


Collections 


Collections are a way Blender uses to organize scenes. 
Collections contain objects and everything else in a scene. 
They can include collections themselves and are fully 
recursive. 


See also 


Read more about Collections. 


New 
Creates a new collection. 


Duplicate Collections 
Recursively duplicates the collection including all child 
collections, objects, and object data. 


Duplicate Linked 
Duplicate entire hierarchy keeping content linked with 
Original. 


Delete Hierarchy 
Deletes the collection and removes all its child objects or 
collections. It is important to note that this only deletes 
the collection, if child objects are part of another 
collection they will stay in the scene collection and their 
data-blocks will not be deleted from the blend-file. 


Instance to Scene 
Creates a new collection instance. 


Visibility 
Controls the collection’s visibility in the 3D Viewport and 
the final render. 


Isolate 
Hides all collections except the selected collection and 
any parent collections (if any exist). 


Show/Hide 
Shows/Hides the selected collection from the View 


Layer. 


Show/Hide Inside 
Shows/Hides all items that are a member of the 
selected collection, include child collections, from the 


View Layer. 


Enable/Disable in Viewports 
Enables/disables drawing in the View Layer. 


Enable/Disable in Renders 
Enables/disables visibility of the collection in renders. 


View Layer 
Controls the collection’s interactions with the View Layer. 


Disable/Enable in View Layer 
Disables/Enables the collection from the view layer. 


Set Color Tag 
Assigns or clears a collection’s color tag for the selected 
collection. 


ID Data 


Unlink 
To unlink a data-block from its “owner” (e.g. a material 
from its mesh). 


Make Local 
To create a “local” duplicate of this data-block. 


Make Single User 
This feature is not yet implemented. 


Delete 
Deletes the selected data-block. 


Make Library Override 
Make a local override of this linked data-block. 


Make Library Override Hierarchy 
Make a local override of this linked data-block, and its 
hierarchy of dependencies. 


Reset Library Override 


Reset this local override to its linked values. 


Reset Library Override Hierarchy 
Reset this local override to its linked values, as well as its 
hierarchy of dependencies. This allows you to update 
local overrides when the relationship between data- 
blocks changed in the linked library data. 


Resync Library Override Hierarchy 
Rebuilds the local override from its linked reference, as 
well as its hierarchy of dependencies. 


Delete Library Override Hierarchy 
Deletes the local override (including its hierarchy of 
override dependencies) and relinks its users to the linked 
data-blocks. 


Remap Users 
Remap Users of a data-block to another one (of same 
type of course). This means you can e.g. replace all 
usages of a material or texture by another one. 


Copy/Paste 
Copy/pastes selected data-blocks. 


Add Fake User, Clear Fake User 
Adds a “dummy” (fake) user so that the selected data- 
block always gets saved even if it has no users. The fake 
user can be removed with Clear Fake User. 


Rename F2 
Renames the selected data-block. 


Select Linked 
Selects the linked data, see Select Linked for more 
information. 


Mark as Asset 


See Creating_an Asset. 


Clear Asset 


See Removing Assets. 


Clear Asset (Set Fake User) 


See Removing Assets. 


View 


The view menu is part of the context menu and supported in 
all the Outliner elements. 


Show Active Period 
Centers the Tree View to selected object. 


Show Hierarchy Home 
To collapse all levels of the tree. 


Show/Hide One Level NumpadPlus/ NumpadMinus 
Expand one level down in the tree or collapse one level 
using the keyboard shortcuts. 


Usage 


Relations Management 


Data-blocks can be 
dragged and dropped to 


Scene Collectior 


manage data relations in ¥ © collection 
the Outliner. To begin a . 
drag and drop, Le click 
and drag from the name » ‘7 Cube 
or icon of a data-block. v 4 Empty 
a Light Unkinside Collection 
Objects can be moved to TH Collection2  Srobjects 
collections by dropping 


on the name or contents Linking objects to a collection. 
of a collection. To link an 

object to a collection, 

hold ctrt while dropping. To set parent-child relations 
between objects, drop an object onto another object while 
holding Shift. 


Note 


Drag and drop will attempt to operate on the entire 
selection. Selected data-blocks that are incompatible with 
the operation will remain unmodified. 


Modifiers, Constraints, & Visual 
Effects 


You can manage Modifiers, Constraints, and Visual Effects 
from the Outliner in a couple ways: 


e To change the order with in the stack select the desired 
modifier and move it above or below other modifiers. 

e To copy a single modifier to another select the modifier 
and drag it on top of the desired object. 

e To copy the whole modifier stack to another object 
select the modifier icon and drag in to the desired 
object. 


Drag & Dropping to 3D Viewport 


Objects & Object Data 


Dragging object data-blocks from the Outliner to the 3D 
Viewport creates a duplicate of the object. Dragging object 
data data-blocks from the Outliner to the 3D Viewport 
creates a linked duplicate of the object. 


Properties 


The 
Properties 
shows and 
allows 
editing of 


many active 


data, 
including 
the active 
scene and 
object. 


Tabs 
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Rotation Mode 


» Delta Transform 


>» Relations 

>» Collections 
> Instancing 

>» Motion Paths 


> Visibility 


» Viewport Display 


>» Custom Properties 
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XYZ Euler 


The Properties, with Object properties shown. 


The Properties has several categories, which can be chosen 
via tabs (the icons column to its left). Each tab regroups 
properties and settings of a data type, and is documented in 
its own manual sections, linked below. 


Active Tool and Workspace Settings 


This first tab contains settings for the active tool (in the 3D 
Viewport) and the current workspace. 


Scene 


These tabs contain settings for the active scene. 


Render: Eevee, Cycles or Workbench settings 
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Collection 


This tabs contain settings for the active Collection. 
Object 


These tabs are used to add features, and to change 
properties for the active object. Depending on the type of 
the active object, some of those will be hidden. 


Object 

Modifiers (or Grease Pencil Modifiers) 
Object Visual Effects 

Particles 

Physics 

Object Constraints 


Object Data 


The main tab of that category (often the only one) always 
has the same name, Object Data, but its icon will change 
based on the actual type of the active object. 


Geometry Objects: 


e Mesh 
e Curve 

e Surface 

e Text 

e Metaball 

e Grease Pencil 


Rigging and Deformation Objects: 


e Armature 

o Bone 

o Bone Constraints 
e Lattice 


Other Types of Objects: 


Empty 
Speaker 
Camera 
Light 

Light Probe 


Object Shading 


Depending on the type of the active object, some of those 
will be hidden. 


e Material 
e Texture 


Header 
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The header of the Properties. 


Display Filter ctrt-F 
Allows you to search for a property by its name. The 
results will be highlighted with there corresponding panel 
also highlighted and expanded. The search also works 
across multiple Tabs; graying out tabs with no search 
results. You can start a search using Ctrl-F or clear a 
search with Alt-F. This filter is useful if you do not 
remember where a property is within the Properties. 


Data Context 
Just below the header is a list of icons and text items 
which show the owner of the properties being edited, 
together with some dependency context if needed. In the 
example above, the material “Material” is used by the 
active object “Cube”. 


Toggle Pin ID 
By toggling on the pin icon to the right, Blender will 
display only the currently shown data-block’s properties 
in that editor, disregarding further selection changes. 
Toggle off that pin to switch back to default behavior, 
showing active data-block’s properties. 


Options 


Sync with Outliner 


Sync tabs with the Outliner data-block selection. See 
Properties Editor Sync for more information. 


Always: Always, when possible, change 
Property editor tabs when clicking an 
icon in an Outliner. 


Never: Never change Property editor tabs 
when clicking an icon in an Outliner. 
Auto: Change tabs only when the Property 


editor shares a border with an Outliner. 


File Browser 


The File Browser is used in all the file-related operations. 
These include: 


e Opening and saving blend-files. 

e Browsing inside other blend-files, when appending or 
linking data-blocks, see Linked Libraries. 

e Importing from/exporting to other file formats. 

e Picking new locations for existing file paths (images, 
videos, fonts...). 


The most common way to use this editor is through modal 
operators (like opening or saving a blend-file). The File 
Browser will appear in a new window, waiting for the 
operation to complete, and then close returning the main 
window. 


You can use the File Browser as any other editor type, to 
browse through the file system. The main purpose of this is 
to be able to drag-and-drop from the File Browser into other 
editors. 


e Images into the 3D Viewport (to set as background or 
apply as material texture). 
e Media files into the Video Editing. 
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The File Browser. 


Interface 
Main Region 


The main region of the File Browser acts similar to the file 
browser built into you operating system. The region contains 
an array of files, folders, or internal blend-file data in a grid 
or list of items. You can navigate, select, and edit these 
items just as you would in your operating system’s file 
browser. 


Previews 


In its Thumbnail display mode, the File Browser supports 
many types of previews. These include: 


e Image and video formats 
e Fonts 


e Blend-files 
e Internal Data-blocks 


In order to get previews for data-block, there previews must 
be generated. See Blend-files Previews for how to generate 
and manage Blender data previews. 


The File Browser in Thumbnail mode. 


File Path Region 


The File Path is above the main region and can aid in 
navigating and adjust how items are displayed. 


Previous Folder Backspace, Alt-Left 
Move to previous folder (in navigation history). 


Next Folder Shift-Backspace, Alt-Right 
Move to next folder (in navigation history). 


Parent File P, Alt-Up 
Move up to parent directory. 


Refresh File List R, NumpadPeriod 
Refresh current folder. 


Create Directory I 


Will ask you to confirm and create a new directory inside 
current one, scroll to it in the main view, and let you 
enter its name. 


File Path ctrt-L 
Text field for the current folder path. Tab will auto- 
complete an existing path. If you type a nonexistent 
directory path, you will be prompted to create that new 
directory. 


Search Ctrl-F 
Filter items by name. The wildcard * will match anything, 
e.g. bl*er will match both blender and blogger. There is 
always an implicit wildcard at start and end of the search 
text, SO blender will also match test blender file.blend. 
This field can also be used to filter some specific file 
extension (e.g. .png will list all PNG files). 


Display Mode 
Controls how files are displayed. 


Vertical List: Displays files and folders in a vertical 
list. 

Horizontal List: 
Displays files and folders in a horizontal 
list. 

Thumbnails: Shows previews. 


Display Settings 


Display Size 
The size of the thumbnails, or the width of the columns. 


Recursion 
The number of directory levels to show at once in a flat 
Way. 


None: List only the current directory content. 

Blend File: List the whole content of a blend-file 
(only available when linking or 
appending data-blocks). 


One Levels: List all subdirectories’ content, one 
level of recursion. 
Two Levels: List all subdirectories’ content, two 


level of recursion. 
Three Levels: List all subdirectories’ content, three 
levels of recursion. 


Hint 

Showing several levels of directories at once can be 
handy to e.g. see your whole collection of textures, 
even if you have arranged them in a nice set of 
directories to avoid having hundreds of files in a single 
place. 


In the Append/Link case, showing the content of the 
whole blend-file will allow you to link different types of 
data-blocks in a single operation. 


Warning 


The more levels you show at once, the more time it will 
take to list them all (typically, it will be exponential, 
showing three levels at once may take three orders of 
magnitude more time to be fully listed). 


Sort By 
Sorts items by one of the four methods: 
Name: Sort the file list alphabetically. 
Extension: Sort the file list by extension/type. 


Modified Date: Sort files by modification time. 


Size: Sort files by size. 
Filter Settings 


On the right side of the file path are the filtering options. 
The toggle with the funnel icon controls whether filtering is 
enabled or not. 


File Types 
Filters files by categories, like folders, blend-files, images, 
etc. 


Blender IDs 
When appending or linking, you can also filter by data- 
block categories, like scenes, animations, materials, etc. 


Show Hidden H 
Shows hidden files (starting with a .). 


Execution Region 


File Name 
Text field to edit the file name and extension. When 
saving, if the background is red, a file with same name 
already exists in the folder. Tab will auto-complete to 
existing names in the current directory. 


Increment Filename -, + 
Removes/Decreases or adds/increases a trailing 
number to your file name (used e.g. to store different 
versions of a file). 


Cancel Esc 
Cancels the file selection (and the underlying operation), 
and closes the File Browser. Using the Back to Previous 
button in the Jopbar will have the same effect. 


Confirm Return 
The main button to validate the operation, which defines 
its name. Double-clicking on a non-directory item will 
have the same effect. 


Source List Region 

The left region displays different ways to quickly access 
some directories. The region is divided into separate panels 
each containing a Ul List of directories. Clicking on one of 
the directories will immediately navigate to that folder. 


Volumes 


Contains all OS-defined available volumes, e.g. drives or 
network mounts. 


System 


Contains OS-defined common directories, like the main user 
folder... 


Bookmarks 

Contains folders that you want to be able to access often 
without having to navigate to them in the File Browser. To 
the right of that list are buttons to perform basic 
management actions on your bookmarks, e.g. add/remove 
an entry, move it up or down in the list, etc. 


Recent 


Contains recently accessed folders. 


The x button to the right allows you to fully erase this list. 


You can control how many folders appear in this list with the 
Recent Files number field of the Save & Load tab in the 
Preferences. 


Operator Options Region 


The right region shows the options of the calling operator. 
Besides common actions listed below, many import/export 
add-ons will also expose their options there. 


Open, Save, Save As Blender File 
See Opening & Saving. 


Open, Replace, Save As Image 
See Supported Graphics Formats. 


Link/Append from Library 
See Linked libraries. 


For the common option: 


Relative Path 
See Relative Paths. 


Header Region 


The header only contains two menus, one with you standard 
editor View controls and the other to list a few Selecting 
operators for the sake of discoverability. Often it is hidden as 
most of the functionality is contained in the regions 
described previously. 


Navigating 


Entering a Directory 
A single LMB click on a directory enters it. 


Parent Directory P 
Takes you up one level of directory. 


File Drop 


You can also drag and drop a file or directory from your file 
manager into the Blender File Browser. This will move it to 
the directory of the dropped file, and the file will be 
selected. 


Selecting 


Select 
Both Lvs and rms clicks work. Holding shift will extend the 
items selection. 


(De)select All A 
Toggles selecting all files. 


Dragging 
Dragging with Ls starts a box selection. 


Note 


You can always select several entries in the File Browser, 
the last selected one is considered as the active one. If the 
calling operation expects a single path (like e.g. the main 
blend-file Open one), it will get that active item’s path, 
other selected ones will just be ignored. 


Arrow Keys 


It is also possible to select/deselect files by “walking” 
through them using the arrow keys: 


e Just using an arrow key, the next file in the chosen 
direction will be selected and all others deselected. 

e Holding down Shift while doing this does not deselect 
anything so it extends to the selection, plus it allows to 
deselect files by navigating into a block of already 
selected ones (minimum two files in sequence). 

e Holding down Shift-ctri further selects/deselects all files 
in between. 


If no file is selected, the arrow key navigation selects the 
first or last file in the directory, depending on the arrow 
direction. 


If you select a directory and hit Return, you will go into that 
directory (and highlighting ‘parent’ .. entry will bring you up 
one level). 


Editing 


Delete Files Delete, xX 
Delete the currently selected files or directories by 
moving them to the operating system’s “trash”. 


Note, on Linux deleting directories requires KDE or 
GNOME. 


Rename F2 


Change the name for the currently selected file or 
directory. 


Asset Browser 


This section describes the Asset Browser, which is the main 
interface for organizing and using assets. 


The Asset Browser was introduced in Blender 3.0, and will 


be improved and expanded over multiple upcoming 
releases. 


See also 


Asset Libraries 
For general information on Blender’s asset library 


system, including how to create and edit assets, and 
design choices. 


Asset Catalogs 
For organizing assets. 


Pose Library 
Build on top of the Asset Browser. 
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Asset Browser, showing materials in an asset library. 
Main Region 


The main region of the Asset Browser acts similar to the File 
Browser built into Blender. It shows the assets contained in 
the selected catalog. 


Click an asset to select and activate it. Box select by 
dragging LmMB or extend the selection with shift-LmB to select 
multiple assets. Every asset has a context menu. 


Source List Region 


The Source List region can be used for navigating and Using 
Assets. 


Library 


Shows the active asset library, and allows switching 
between asset libraries. The library “Current File” is 
special, and will always show the assets from the current 
blend-file, regardless of whether it is part of an asset 
library or not. 


Copy Asset Bundle to Library 


Shown when the Library selector is set to Current File, 
the current blend-file file is considered an Asset Bundle, 
and is not yet located inside any asset library. 


The Copy Asset Bundle operator makes it simple to copy 
the file into the asset library. The catalogs of the asset 
bundle will be merged into the asset library. 


Catalog 


Tree view that shows the catalogs of the active asset 
library. 


Catalogs can be renamed by double clicking on there 
name. Catalogs can also be nested inside others by 
dragging and dropping one catalog into another. 


Add-ons and features like the Pose Library can show custom 
panels here. 


Asset Details Region 


The Asset Details region on the right shows metadata of the 
active asset. Only metadata of assets contained in the 
current blend-file can be edited. 


Name 


The asset data-block name. This name is unique for the 
asset data type within the same blend-file. 


Source 
The full path of the blend-file that contains the asset. 


Open Blend File 
This button will start a new Blender instance and open 
the blend-file that contains the asset. In the 
background Blender will keep monitoring that new 
Blender instance; when it is quit, the Asset Browser 
will be refreshed to show any updated assets. 


Description 


Optional field for the asset description. Not used by 
Blender itself. 


Author 


Optional field for the asset author. Not used by Blender 
itself. 


Preview 


Shows the preview image of the asset. See Asset Previews. 


Load Custom Preview 


Opens a window with the File Browser to select an image 
for the asset preview. 


Generate Preview 
Generate/update a preview for the asset. 


Preview 
Menu of additional preview operators. 


Render Active Object 
Generates a preview by based on the 3D Viewport’s 
Active object. This is useful for node groups, 


particularly for geometry nodes, which cannot 
automatically generate their own preview. 


Tags 


Panel for viewing and editing asset tags. These do not have 
any meaning to Blender, and can be chosen freely. When 
using the search field to filter the assets, those assets 
whose tags (partially) match the search term will also be 
shown. 


Note 


Depending on the current mode of the object and the 
selected asset types, more panels may be shown. For 


example, see Pose Library. 


Using Assets 


As a general rule, an asset can be used by dragging it 
from the Asset Browser to the desired location. 
Objects and worlds can be dragged from the Asset Browser 
into the scene, Materials can be dragged onto the object 
that should use them. The use of pose assets is different, 
and is described in Pose Library. 


There are several things that can happen when an asset is 
used, depending on the Import Type configuration of the 
Asset Browser: 


Link 
Same as File » Link... 


The asset will be linked to the current blend-file, and thus 
be read-only. Later changes to the asset file will be 
reflected in all files that link it in. 


Append 
Same as File >» Append... 


All of the asset and all its dependencies will be appended 
to the current file. Dragging a material into the scene 
three times will result in three independent copies. 
Dragging an object into the scene three times will also 
result in three independent copies. 


“Dependencies” in this case means everything the asset 
refers to. For an object, this can be its mesh and 
materials, but also other objects used by modifiers, 
constraints, or drivers. 


Since the file now has its own copy of the asset, later 
changes to the asset file will not be reflected in the file 
it’S appended to. 


Append (Reuse Data) 
Specific to the Asset Browser. 


The first time an asset is used, it will be appended, 
including its dependencies, just like described previously. 
However, Blender will keep track of where it originated, 
and the next time the asset is used, as much data as 
possible will be reused. Dragging a material into the 
scene three times will only load it once, and just assign 
the same material three times. Dragging an object into 
the scene three times will create three copies of the 
object, but all copies will share their mesh data, 
materials, etc. 


Since the file now has its own copy of the asset, later 
changes to the asset file will not be reflected in the file 
it’S appended to. 


Instancing Collections 


Mimics the Instance Collections option when appending 
from the file browser 


Some asset types such as collections can be created as 
an instanced collection. This is done by enabling the 
Instance option after dragging collection assets into the 
3D Viewport. By enabling this option an empty object is 
added that uses an instance of the collection. If this 
option is disabled then the full collection hierarchy will be 
added to the scene. 


Collection Assets from the current file will always be 
instanced. 


Note that all regular Blender operations are available after 
the asset has been added to the current file. For example, 
you could choose to link an object to the scene; this will also 
link its mesh and its materials. Then you can make the 
object itself local (Object » Relations » Make Local... » 
Selected Objects), while keeping the mesh and materials 
linked to the asset files. This will result in a local, and thus 
editable, object, and keep the mesh and materials 
automatically up to date with any changes in the asset 
library. 


Asset Previews 


Preview images are typically automatically generated when 
you mark a data-block as asset. The auto-generated 
preview tries to capture the object from the front. However 


this only works if the Proview 
geometry is laid out so 
that it matches what 
Blender considers to 
be the front. That is, 
the geometry that 
should be the front 
needs to point down 
the -Y axis of the 
object. The rotation 
may have to be 
applied to get the 
expected result. 
Collection assets use the global -Y axis as the front (instead 
of the local one, as collections themselves don’t have a 
rotation). 


Preview panel in the Asset Browser. 


It’s also possible to load image files from drive, to replace 
the auto-generated previews. 


For previews of pose assets, see Controlling the Look of 
Preview Images. 


Asset Bundles 


Asset bundles are blend-files that do not reference any 
other file, and whose name ends in _bundle.blend. Any 
textures and other external files need to be packed into the 
current blend-file. 


Asset bundles can be copied to an asset library via the 
Asset Browser: 


e Open the asset bundle blend-file. 


Switch its Asset Browser to Current File (if it’s not set at 
that already). 

Click on Copy Bundle to Asset Library. 

Choose the asset library to copy it to. 

A File Browser will open, showing the files of the 
selected asset library. Choose the desired location of the 
blend-file, and click the Copy to Asset Library button. 
The blend-file will be saved at the chosen location, and 
any catalogs of the asset bundle will be merged into the 
target asset library. 


Note 


Both the word “asset” and the word “bundle” are 
commonly used, and not necessarily with the same 
meaning as described here. Not everything that’s 
presented as an “asset bundle” will have the Copy to Asset 
Library functionality available; for that, the bundle file 
needs to adhere to the definition above. 


Spreadsheet 


The Spreadsheet editor is used to inspect geometry 
attributes. 


The Spreadsheet editor. 


Header 


Object Evaluation State 
Display the data of an object at different states of its 
evaluation. 


Evaluated: Display data from the object with all 
modifiers applied. 
Original: Display data from the original object 


without any modifiers applied. 
Viewer Node: Display data from the active Viewer 
node of the active object. 


Breadcrumbs 
The breadcrumbs show three key parts of the path the 
evaluated object takes before showing the information in 
the Main Region. In the order from left to right, the first 
item displayed is the Active object. The next two items 
are displayed when the Viewer node evaluation state is 
chosen. The first of these next items is the name of the 
Geometry Nodes modifier, the last item shown is the 
name of the active Viewer node. 


Clicking the arrow between items hides the name of the 
active modifier. 


Toggle Pin 
Usually, the editor displays data from the active object. 
When an object is pinned, its data remains visible, even if 
another object becomes active. 


Selected Only 
This option is only available if the object is in Edit Mode. 
When checked, only data for the selected mesh elements 
Is Shown. 


Main Region 


The main view allows you to view the actual spreadsheet. 
Row indices and column names remain visible when 
scrolling down or to the side. 


Note 


Byte color attributes are displayed as scene linear floats. 
The actual byte values are displayed in a tooltip when 
hovering over the float values. 


Data Set Region 


With the Data Set region on the left you can choose which 
geometry component and geometry domain to view. For 
each attribute domain its size is displayed, for example the 
number of faces. 


Mesh 
Mesh component containing point, corner, face and edge 
data. 


Vertex: Display attributes that are stored per 
vertex. 

Edge: Display attributes that are stored per 
edge. 

Face: Display attributes that are stored per 
face. 

Face Corner: Display attributes that are stored per 


face corner. 


Curve 
Display curve data which are the attributes on splines 
and control points. 


Control Point: Display attributes that are stored per 
control point. 


Spline: Display attributes that are stored per 
Spline. 
Point Cloud 
Point cloud component containing only point data. 
Point: Display attributes that are stored per 
point. 


Volume Grids 


Display OpenVDB volume grid data, each grid will be 
represented with the Grid Name, the Data Type, and the 
Class. The class can be either of: Fog Volume, Level Set, 
or Unknown. 


Instances 
Display which objects and collections are instanced and 
their transforms. 


Sidebar 


The Sidebar contains row filters, which allow not including 
rows based on their value. The Add Row Filter button adds a 
new row filter. 


Enabled 
Each row filter can be enabled or disabled. Disabled row 
filters are grayed out, and aren’t used for filtering. 


Column 
Row filters hide rows based on the values of the selected 
column. The choice of name in the Column field 
determine which column is chosen. If the column is not 
currently available, the row filter will be grayed out. 


Operation 
For spreadsheet column types besides Boolean columns 
and name or “string” columns, it is possible to choose 
which operation to filter with. 


Equal To: Display the row when data values are 
within the provided threshold from the 
row filter’s value. 

Greater Than: Display the row when data values are 
greater than the row filter’s value. 


Less Than: Display the row when data values are 
less than the row filter’s value. 


Threshold 
The distance from the row filter’s value for the equality 
operation. 


Status Bar 


The status bar shows how many rows and columns there are 
and how many have been filtered out. 


Preferences 


Introduction 


Interface 
Themes 
Viewport 
Lights 
Editing 
Animation 


Save & Load 
File Paths 


Experimental 


Introduction 


Reference 


Menu: Edit >» Preferences... 
Shortcut: F4, P 


This chapter explains how to change Blender’s default 
configuration with the Preferences editor. 


The Blender Preferences contains settings to control how 
Blender behaves. At the left of the editor, the available 
options are grouped into sections. 


Display 


Themes Resolution Scale 


Viewport Line Width Default 
Lights 


Editing 
cen Tooltips + User Tooltips 
Animation 

Python Tooltips 


Add-ons 
Editors 


tft ¥ Region Overlap 


Navigation 


¥ Navigation Controls 


Keymap Color PickerType = Circl 


System 
Factor Display Type 
Save & Load 
Temporary Editors 
File Paths 
Status Bar 
Translation 


Language = English (English) 


Blender Preferences window. 


Managing Preferences 


Default preferences are managed from the = menu in the 
preferences window. 


The following items are available in this menu: 


Auto-Save Preferences 
By default changes to preferences are saved on exit, this 
allows changes to the keymap and Quick Favorites menu 
to be stored and used between Blender Sessions. 


When disabled, a Save Preferences button is shown to 
manually perform the operation. 


Revert to Saved Preferences 
Undoes any unsaved modifications, loading the 
previously saved state. 


Load Factory Preferences 
Completely undo all the modifications made to the 
preferences, resetting to the state used before making 
customizations. 


Note 


After running Load Factory Preferences, auto-save will 
be disabled for the current session. 


This allows you to switch back to the factory settings for 
testing or following tutorials for example, without the 
risk of accidentally auto-saving over the preferences 
you have manually configured. 


If you wish to save these as your preferences, run Save 
Preferences manually. 


Note 


This only resets the preferences and will not affect 
settings stored in the startup file. This includes app 
templates, area locations, and any Blender properties 
not part of the preferences. 


These must be reverted though File » Defaults. 


Tip 


It can be valuable to make a backup of your preferences in 
the event that you lose your configuration. 


See the directory layout section to see where your 
preferences are stored. 


Interface 


Interface configuration lets you change how UI elements are 
displayed and how they react. 
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Navigation 


¥ Navigation Controls 


Keymap 


System 
Factor Dis 
Save & Load 


Temporary Editors 
File Paths 
Status Bar 


Translation 


Language = English (English) 


Display 


Resolution Scale 
Adjusts the size of fonts and buttons relative to the 
automatically detected DPI. During typical usage, you 


may prefer to use zoom which is available in many parts 
of Blender interface. 


Line Width 


Scale of lines and points in the interface e.g. button 
outlines, edges and vertex points in the 3D Viewport. 


Thin, Default, Thick 


Splash Screen 
Display the Splash Screen when starting Blender. 


Developer Extras 
Show settings and menu items which are intended to 
help developers, this includes: 


e Operator Search 
e Sequencer Cache Settings 


Button Context Menu 
Online Python Reference 
To open the Python reference manual. 


Copy Python Command 
To copy the expression used when pressing the 
button. 


Edit Source 
To edit Python source code that defines the button. 


Edit Translation 
The option to edit UI translations (only available 
when the Manage UI translations add-on is also 
enabled). 


3D Viewport 
Show Indices 
The option to show mesh vertex/edge/face indices 
in the overlay popover. 


Preferences 


Experimental Tab 
Work in progress features can be enabled here 
which are currently being tested. 


Tooltips 
User Tooltips 
When enabled, a tooltip will appear when your mouse 
pointer is over a control. This tip explains the function 
of what is under the pointer, shows the associated 
hotkey (if any). 


Python Tooltips 
Displays a property’s Python information below the 
tooltip. 


Editors 


Region Overlap 
This makes regions overlap the viewport. It means that 
the Toolbar and Sidebar regions, will be displayed 
overlapping the main area. 


Navigation Controls 
Show navigation controls at top right of the area. This 
impacts the 3D Viewport as well as image spaces. 


Note 
If you are familiar with navigation key shortcuts, this 
can be disabled. 


Color Picker Type 
Choose which type of Color Space you prefer. It will show 
when clicking LMB on any color field. 


See the different color picker types at the Color picker 
page. 


Header Position 
The default header position when opening a new editor. 


Keep Existing 


Uses top for most editor types and the positions saved 
in the start-up file. 


Top/Bottom 


Always positions the header at the top or the bottom 
of the editor. 


Factor Display Type 


How factor value types are displayed in the user 
interface. 


Factor 


Values are displayed as float numbers between 0.0 
and 1.0. 


Percentage 


Values are expressed as a percentage between 0 and 
100. 


Temporary Editors 


When performing certain operations, Blender will open a 
new window. The behavior of these operations can be 
configured here. 


Render In 
When rendering, the user interface can do any of: 


Keep User Interface 


The user interface does not change and the render is 
computed in the background. 


Maximize Area 
A new Image editor is opened as a temporary window 
in full screen mode. 


Image Editor 
The area that is the largest on screen is replaced 
placed by a temporary Image editor. 


New Window 
A new Image editor is opened as a regularly sized 
temporary window. 


File Browser 
When opening files from the computer, the user interface 
can do any otf: 


Maximize Area 
A new File Browser editor is opened as a temporary 
window in full screen mode. 


New Window 
A new File Browser editor is opened as a regularly 
sized temporary window. 


Translation 


Language 
The language used for translating the user interface (Ul). 
The list is broken up into categories determining how 
complete the translations are. 


Affect 
Tooltips 


Translates the descriptions when hovering over UI 
elements. 


Interface 
Translates all labels in menus, buttons, and panels. 


New Data 
Translates the names of new data-blocks. 


Text Rendering 


Anti-Aliasing 
Enable interface text Anti-Aliasing. When disabled, texts 
are rendered using straight text rendering (filling only 
absolute pixels). 


Hinting 
Adjust font hinting, controls the spacing and crispness of 
text display. 


Interface Font 
Replacement for the default user interface font. 


Mono-space Font 
Replacement for the default mono-space interface font 
(used in the Text editor and Python Console). 


Menus 


Open on Mouse Over 


Select this to have the menu open by placing the mouse 
pointer over the entry instead of clicking on it. 


Top Level 
Time delay in 1/10 second before a menu opens (Open 
on Mouse Over needs to be enabled). 


Sub Level 
Same as above for sub menus (for example: File » Open 
Recent). 


Pie Menus 


Animation Timeout 
Length of animation when opening Pie Menus. 


Tap Key Timeout 
Keystrokes held longer than this will dismiss the menu on 
release (in 1/100ths of a second). 


Recenter Timeout 
The window system tries to keep the pie menu within the 
window borders. Pie menus will use the initial mouse 
position as center for this amount of time, measured in 
1/100ths of a second. This allows for fast dragged 
selections. 


Radius 
The size of the Pie Menu set with the distance (in pixels) 
of the menu items from the center of the pie menu. 


Threshold 
Distance from center before a selection can be made. 


Confirm Threshold 
Distance threshold after which selection is made (zero 
disables). 


Themes 


The Themes section allows you to customize interface 
appearance and colors. 


Interface Presets 


CS User Interface 


Viewport 4F Text Style 


Lights Bf Bone Color Sets 


ESIIOg fm Collection Colors 
i te a= Strip Colors 
Add-ons #® 3D Viewport 
Input Vv Graph Editor 
Navigation *o” Dope Sheet 


Keymap =|? Nonlinear Animation 


"FUv/image Editor 
System bu ser 


aa Video Sequencer 


Save & Load 

File Paths ff Text Editor 
&) Node Editor 
& Properties 
T= Outliner 
be Preferences 
§B info 


ge File Browser 


The colors for each editor can be set separately by simply 
selecting the editor you wish to change in the multi-choice 
list at the left, and adjusting colors as required. Notice that 
changes appear in real-time on your screen. In addition, 
details such as the dot size in the 3D Viewport or the Graph 
Editor can also be changed. 


Themes use Blender’s preset system to save a theme. This 
will save the theme to an XML file in the 


./scripts/presets/interface theme/ Subdirectory of one of the 
configuration directories. 


Blender comes bundled with a small selection of 
themes. 


This is an example of the theme Blender Light. 


Viewport 


Interface 
Themes Show Object Info 
¥ View Name 


Light: Playback FPS 
ights 


Editing 3izmo Size 75 px 


; ; 150 px 
Animation 


Add-ons 


Input 
Quality 
Navigation 
Viewport Anti-Aliasing 
Keymap 
Smooth Wires Overlay 
System ¥ Edit Mode 


Save &/COat Textures 


File Paths 
Limit Size 


Anisotropic Filter 
Alpha 


Image Display Method Automatic 


Selection 


Subdivision 


Blender Preferences Viewport section. 


Display 


Text Info Overlay 
Object Info 
Display the active Object name and frame number at 
the top left of the 3D Viewport. 


View Name 
Display the name and type of the current view in the 
top left corner of the 3D Viewport. For example: “User 


Perspective” or “Top Orthographic”. 


Playback Frame Rate (FPS) 
Show the frames per second screen refresh rate while 
an animation is played back. It appears in the top left 
of the 3D Viewport, displaying red if the frame rate set 
cannot be reached. 


Gizmo Size 
Diameter of the gizmo. 


HDRI Preview Size 
Diameter of the HDRI sphere overlay. 


3D Viewport Axis 
Interactive Navigation: 
Display the axis as an interactive 
gizmo. Click sets the viewport to 
display along this axis and dragging 
orbits the view. 


Simple Axis: Display simple, less intrusive axis in 
the viewport. 
Brightness 
How vivid the colors of the simple 
axis are. 
Off: Disables the viewport axis. 
Size 


Diameter of the 3D Viewport Axis widget. 


Quality 


Viewport Anti-Aliasing 
Control the Anti-Aliasing for higher quality rendering. 


Smooth Wires 
Overlay 
Display overlays with smooth wire, without this wires 
will be rendered aliased. To increase the visibility you 
can disable this and Edit Mode, since edges do not 
blend into other shaded regions. 


Edit Mode 
Display smooth wire in Edit Mode, without this wires 
will be rendered aliased. 


Textures 


Limit Size 
Limit the maximum resolution for pictures used in 
textured display to save memory. The limit options are 
specified in a square of pixels (e.g: the option 256 means 
a texture of 256x256 pixels). This is useful for game 
engineers, whereas the texture limit matches paging 
blocks of the textures in the target graphic card memory. 


Anisotropic Filtering 
Sets the level of anisotropic filtering. This improves the 
quality of textures that are rendered at the cost of 
performance. 


Clip Alpha 
Clip alpha below this threshold in the 3D Viewport. Note 
that, the default is set to a low value to prevent issues on 
some GPUs. 


Image Display Method 
Method to render images; the following options are 
Supported: 


Automatic: Automatically use GLSL which runs on 
the GPU for performance but falls back 
to the CPU for large images which 
might be slow when loaded with the 
GPU. 

2D Texture: Uses CPU for display transform and 
render images as a 2D texture. 

GLSL: Fastest method using GLSL for display 
transform and render images as a 2D 
texture. 


Selection 


GPU Depth Picking 
This option uses an alternative method of picking which 
uses depth information to select the front-most elements. 
It is only used for selecting with the cursor (not box 
select, lasso, circle select, etc.). 


Performance varies depending on your OpenGL hardware 
and drivers. 


Subdivision 


GPU Subdivision 
Under certain circumstances, the GPU will be used to 
subdivide a mesh with a Subdivision Surface modifier. 
This typically results in increased subdivision 
performance. 


heroes Studio Lights 


Themes No custom Studio Lights configured 


Viewport Editor 


CheJnuss MatCaps wb, Install... 


Editing 
e No custom MatCaps configured 


Animation 
HDRIs 
Add-ons 
No custom HDRIs configured 
Input 
Navigation 


Keymap 
System 
Save & Load 


File Paths 


Blender Preferences Lights section. 


Studio Lights 


Studio Lights are used to illuminate the 3D Viewport during 
Solid View and will not be rendered. Unlike lights in the 
scene, the lighting direction follows the viewport orientation. 


Editor 


There are up to four virtual light sources. 


The Light toggles allow you to enable or disable individual 
lights. At least one of the four lights must remain enabled 
for the 3D Viewport. The lights are equal, except for their 
direction and color. You can control the direction of the 
lights, as well as their diffuse and specular colors. 


Light 
Use Light 
Toggles the specific light. 


Diffuse 
This is the constant color of the light. 


Specular 
This is the highlight color of the light. 


Smooth 
Smooth the shading from this light. 


This has the effect of lighting to be less direct. 


Direction 
The direction of the light, (see Direction Buttons). 


The direction of the light will be the same as shown at 
the sphere surface. 


Ambient Color 
The color of unlit areas. 


MatCaps 


This panel manages MatCap image files which can used to 
light the view when MatCap shading is enabled. 


Two kinds of images are supported for MatCaps. Regular 
image files and multilayered OpenEXR files. When using 
multilayered OpenEXR files, the layer named “diffuse” will 
be used as a diffuse pass, the layer named “specular” will 
be used as a specular pass. Regular images will be handled 
as “diffuse” and will not support specular highlighting. 


The diffuse pass is multiplied with the base color of the 
objects and the specular pass is added on top. MatCaps, 
that only have a diffuse pass tend to look very metallic, with 
a separate specular pass it is possible to simulate a wider 
variety of materials. 


HDRIs 


This panel manages HDRI image files which can be used to 
light the view when Material Preview or Rendered shading is 
enabled. 


Editing 


These preferences control how several tools will interact 
with your input. 


Interface Objects 


Themes New Objects 
Viewport Link Materials To 


Lights Align To 


data 
Wo 
at Enter Edit Mode 
Instance Empty Size 1.000 


Animation 
Duplicate Data 
Add-ons 
¥ Action ¥ Lattice Particle 


Input ¥ Armature ¥ Light Point Cloud 
Navigation VY Camera ¥ Light Probe V Speaker 
¥ Curve Material ¥ Surface 

¥ Grease Pencil Y Mesh V Text 


Keymap 
System Hair  Metaball Volume 


Save & Load 
3D Cursor 
File Paths 


¥ Cursor Surface Project 
¥ Cursor Lock Adjust 


Annotations 


Default Color Ts 


Eraser Radius 25 px 


Weight Paint 


Objects 


New Objects 


Link Materials to 
To understand this option properly, you need to 
understand how Blender works with Objects. Almost 
everything in Blender is organized in a hierarchy of data- 


blocks. A data-block can be thought of as containers for 
certain pieces of information. For example, the Object 
data-block contains information about the Object’s 
location, rotation, and scale while the associated linked 
Object Data data-block contains information about the 
mesh. 


Example for a mesh. 
A material may be linked in two different ways: 


Object Data 
Any created material will be created as part of the 
Object Data data-block. 


Object 
Any created material will be created as part of the 
Object data-block. 


A material linked to Object Data (left) and Object 
(right). 


See also 
Read more about Blender’s Data System. 


Align to 


World 
New objects align with world coordinates. 


View 


New object align with view coordinates. 


3D Cursor 
New objects align to the 3D cursor’s orientation. 


Enter Edit Mode 
If selected, Edit Mode is automatically activated when 
you create a new object. 


Instance Empty Size 
The display size for empties when a new collection 
instance is created. 


Duplicate Data 


The Duplicate Data checkboxes define what data is copied 
with a duplicated object and what data remains linked. Any 
boxes that are checked will have their data copied along 
with the duplication of the object. Any boxes that are not 
checked will instead have their data linked from the source 
object that was duplicated. 


For example, if you have Mesh checked, then a full copy of 
the mesh data is created with the new object, and each 
mesh will behave independently of the duplicate. If you 
leave the mesh box unchecked then when you change the 
mesh of one object, the change will be mirrored in the 
duplicate object. 


The same rules apply to each of the checkboxes in the 
Duplicate Data list. 


3D Cursor 


Cursor Surface Project 


When placing the cursor by clicking, the cursor is 
projected onto the surface under the cursor. 


Cursor Lock Adjust 
When the viewport is locked to the cursor, moving the 
cursor avoids the view jumping based on the new offset. 


Annotations 


Default Color 
The default color for new Annotate layers. 


Eraser Radius 
The size of the eraser used with the Annotate Tool. 


See also 


Read more about Annotations. 


Custom Weight Paint Range 


Mesh skin weighting is used to control how much a bone 
deforms the mesh of a character. To visualize and paint 
these weights, Blender uses a color ramp (from blue to 
green, and from yellow to red). Enabling the checkbox will 
enable an alternate map using a ramp starting with an 
empty range. Now you can create your custom map using 
the common color ramp options. For detailed information 
see the Color ramps page. 


Grease Pencil 


Distance 
Manhattan 
The minimum number of pixels the mouse should 
have moved either horizontally or vertically before the 
movement is recorded. Decreasing this should work 
better for curvy lines. 


Euclidean 
The minimum distance that mouse has to travel 
before movement is recorded. 


See also 


Read more about Grease Pencil. 


Text Editor 


Auto Close Character Pairs 
Automatically insert the corresponding character to close 
an expression when typing characters such as quotes, 
brackets, braces, or parentheses. 


Miscellaneous 


Sculpt Overlay Color 
Defines a color to be used in the inner part of the 
brushes circle when in Sculpt Mode, and it is placed as an 
overlay to the brush, representing the focal point of the 
brush influence. The overlay color is visible only when 
the overlay visibility is selected (clicking at the eye to set 
its visibility), and the transparency of the overlay is 
controlled by the alpha slider located at the Too! tab » 
Display panel in the Sidebar. 


Node Auto-offset Margin 
Margin to use for offsetting nodes. 


Animation 


The Animation section lets you manage settings related to 
. This includes how editors look and also some 
different tools properties. 


Interface Timeline 


Themes Allow Negative Frames 
Viewport Minimum Grid Spacing 45 px 
P Minimal Info 

Lights 


Editing 


Add-ons 


Input Auto-Keyframing Show Warning 
Navigation Only Insert 


Keymap Enable in New 


System 
Save & Load 


File Paths 


Default Handles 4 Auto Clamped 


XYZ to RGB 


Channel Group Colors 


Blender Preferences Animation section. 


Timeline 


These settings control things in the 


Allow Negative Frame 


Playback and animations can occur during negative 
frame ranges. 


Minimum Grid Spacing 
The minimum number of pixels between grid lines. 


Timecode Style 
Format of timecodes displayed when not displaying 
timing in terms of frames. The format uses ‘+’ asa 
separator for sub-second frame numbers, with left and 
right truncation of the timecode as necessary. 


Zoom to Frame Type 
Defines what time range (around the cursor) will be 
displayed when the View Frame Numpado is performed. 


Keep Range 
The currently displayed time range is preserved. 


Seconds 
The number of seconds specified in the Zoom Seconds 


field will be shown around the cursor. 

Keyframes 
The number of animation keyframes defined in the 
Zoom Keyframes field will be shown around the 
cursor. 


Keyframes 


These settings control Keyframes which are the building 
blocks for animations. 


Visual Keying 


When an object is using constraints, the object property 
value does not actually change. Visual Keying will add 
keyframes to the object property, with a value based on 
the visual transformation from the constraint. 


Only Insert Needed 
This will only insert keyframes if the value of the property 
is different. 


Auto-Keyframing 


Show Warning 
Displays a warning at the top right of the 3D Viewport, 
when moving objects, if Auto Keyframe is on. 


Only Insert Available 
This will only add keyframes to channels of F-Curves 
that already exist. 


Enable in New Scenes 
Enables Auto Keyframe by default for new scenes. 


See also 
Learn more about Auto-Keyframing. 


F-Curves 


These settings control how F-Curves look and their default 
behavior. 


Unselected Opacity 
Controls the opacity of unselected F-Curves against the 
background of the Graph Editor. 


Default Smoothing Mode 


Controls the behavior of automatic curve handles for 
newly created F-Curves. 


Default Interpolation 
Controls the default Interpolation for newly created 
keyframes. 


Default Handles 
Controls the default Handle for newly created F-Curves. 


XYZ to RGB 
Color for X, Y, or Z animation curves (location, scale or 
rotation) is the same as the color for the X, Y, and Z axis. 


Show Group Colors 
Display groups and channels with colors matching their 
corresponding groups. 


Add-ons 


The Add-ons section lets you manage secondary scripts, 
called “Add-ons” that extends Blender’s functionality. In this 
section you can search, install, enable and disable Add-ons. 


Interface Testing wb, Install.. © Refresh 


Themes Enabled Add-ons Only A vi] 


Viewport 
Lights 
Editing 


Animation 


Input 
Navigation 
Keymap 
System 
Save & Load 


File Paths 


Blender Preferences Add-ons section. 
Finding Add-ons 


Searching 
Blender comes with some pre-installed Add-ons already, 
ready to be enabled. But you can also add your own, or 
any interesting ones you find on the web. 


Supported Level 
Blender’s add-ons are split into two groups depending on 
who writes/supports them: 


e Official: Add-ons that are written by Blender 
developers. 
e Community: Add-ons that are written by people in the 
Blender community. 
Enabled Add-ons Only 
Shows only enabled add-ons for the current Category. 


Category 
Add-ons are divided into categories by what areas of 
Blender they affect. 


Installing Add-ons 


There are hundreds of add-ons that are not distributed with 
Blender and are developed by others. To add them to the list 
of other add-ons, they must be installed into Blender. 


To install these, use the /nstal/... button and use the File 
Browser to select the .zip or .py add-on file. 


Now the add-on will be installed, however not automatically 
enabled. The search field will be set to the add-on’s name 
(to avoid having to look for it), Enable the add-on by 
checking the enable checkbox. 


Refresh 
Scans the Add-on Directory for new add-ons. 


Tip 
User-Defined Add-on Path 


You can also create a personal directory containing new 
add-ons and configure your files path in the File Paths 
section of the Preferences. To create a personal script 
directory: 


1. Create an empty directory in a location of your choice 
(e.g. my scripts). 

2. Add a subdirectory under my scripts called addons (it 
must have this name for Blender to recognize it). 

3. Open the File Paths section of the Preferences. 

4. Set the Scripts file path to point to your script directory 
(@.g. my_ scripts). 

5. Save the preferences and restart Blender for it to 
recognize the new add-on location. 


Now when you install add-ons you can select the Target 
Path when installing 3rd party scripts. Blender will copy 
newly installed add-ons under the directory selected in 
your Preferences. 


Enabling & Disabling Add-ons 


To enable or disable an add-on check or uncheck the box to 
the right of the add-ons shown in the figure below. 


> Render: Cycles Render Engine 


Enabling an add-on. 


The add-on functionality should be immediately available. 


Note 


Add-ons that activate or change multiple hotkeys have a 
special system of activation. For example, with the 3D 
Viewport Pie Menus add-on for each menu there is a 
selection box to activate the menu and its hotkey. 


Tip 


If the Add-on does not activate when enabled, check the 
Console window for any errors that may have occurred. 


Add-on Information 


You can click the arrow at the left of the add-on box to see 
more information, such as its location, a description and a 
link to the documentation. Here you can also find a button 
to report a bug specific of this add-on. 


Add-on Preferences 


Some add-ons may have their own preferences which can 
be found in the Preferences section of the add-on 
information box. 


Some add-ons use this section for example to 
enable/disable certain functions of the add-on. Sometimes 
these might even all default to off. So it is important to 
check if the enabled add-on has any particular preferences. 


Input 


In the Input preferences, you can customize how Blender 
reacts to the mouse and keyboard as well as define your 
own keymap. 


Interface Keyboard 


Themes Emulate Numpad 
Viewport Default to Advanced Numeric In.. 
Lights Mouse 
Earning Emulate 3 Button Mouse 
Animation 

¥ Continuous Grab 
Add-ons 

¥ Release Confirms 


Input Double Click Speed 


Navigation Mouse Drac eshold 


Keymap 
Drag Threshold 
System Motion Threshold 


Save & Load 


File Paths 


NDOF 


Keyboard 


Emulate Numpad 
The Numpad keys are used quite often in Blender and are 
not assigned to the same action as the regular number 
keys. If you have a keyboard without a Numpad (e.g. ona 
laptop), you can tell Blender to treat the standard 


number keys as Numpad keys by checking Emulate 
Numpad. 


Default to Advanced Numeric Input 
For transform mode, default to Advanced Mode, 
otherwise Simple Mode is used. 


Mouse 


Emulate 3 Button Mouse 
Blender can be configured to work with pointing devices 
which do not have an mss. The functionality of the three 
mouse buttons by holding Alt-LMB. 


Mouse/Keyboard combinations referenced in this manual 
can be expressed with the combinations shown in the 
table. For example: 


MMB drag becomes Alt-LMB drag for example. 


Warning 


This option prevents certain features from being 
accessed, since Alt-LMB is used for some operations. 


e Modifying multiple items values at once (objects, 
bones... etc). 

e Deselecting edge/face rings in Edit Mode. 

e Detaching node links. 

e Moving the Compositor background image. 


Some touchpads support three-finger tap for middle 
mouse button, which may be an alternative to using 
this option. 


Modifier (unsupported on Microsoft Windows) 


Alt 


Use the Alt key to emulate the middle mouse 
button. 


OSKey 
Use the 0Skey to emulate the middle mouse button. 


This has the advantage that it doesn’t conflict with 
existing Alt-MMB shortcuts, noted above. 


Continuous Grab 
This feature is used to prevent the problem where an 
action such as moving objects or panning a view, is 
limited by your screen bounds. 


This is done by warping the mouse within the view. 


Note 


Cursor warping is only supported by relative input 
devices (mouse, trackball, trackpad). 


Graphics tablets, however, typically use absolute 
positioning, this feature is disabled when a tablet is 
being used. 


This is detected for each action, so the presence of a 
tablet will not disable Continuous Grab for mouse cursor 
input. 


Release Confirms 


Dragging LMB on an object will move it. To confirm this 
(and other) transform, an LMB is necessary by default. 
When this option is activated, the release of LMB acts as 
confirmation of the transform. 


Mouse Drag Threshold 


The number of pixels that a User Interface element has 
to be moved before it is recognized by Blender, values 
below this will be detected as click events. 


Tablet Drag Threshold 
The drag threshold for tablet events. 


Drag Threshold 


The drag threshold for non mouse/tablet events 
(keyboard or NDOF for example). 


This affects Pie Menu on Drag keymap preference. 


Motion Threshold 
The number of pixels the cursor must be moved before 
the movement is registered. This is helpful for tablet 
pens that are a lot more difficult to keep still, then this 
could help to reduce stuttering of the cursor position. 


Note 


Unlike the click/drag distinction, this is used to detect 
small movements for example, picking selection cycles 
through elements near the cursor. Once the cursor 
moves past this threshold, selection stops cycling and 
picks the closest item. 


Touchpad 


Note 


This panel is only available on Windows or macOS. 


Multitouch Gestures 
Use multitouch gestures for navigation with touchpad, 
instead of scroll wheel emulation. 


Tablet 


Tablet API (Windows only) 
Select the native Windows Ink or older Wintab system for 
pressure sensitivity. Blender automatically selects the API 
for your operating system and tablet, however in case of 
problems this can be set manually. You may need to 
restart Blender for changes to take affect. 


Max Threshold 
Amount of pressure required to achieve full intensity. 


Softness 
Controls how the softness of the low pressure response 
onset using a gamma curve. 


NDOF 


These preferences control how an NDOF device interacts 
with the 3D Viewport. These preferences can also be 
accessed using the NDOFMenu button on the NDOF device to 
open a pop-up menu to adjust the settings directly from the 
3D Viewport. 


Pan Sensitivity 
The overall sensitivity for panning in the 3D Viewport. 


Orbit Sensitivity 
The overall sensitivity for orbiting in the 3D Viewport. 


Deadzone 
The threshold for the amount of movement needed from 
the device’s rest position for Blender to interrupt that 
movement. 


Navigation 
Navigation style for the viewport. 


Free: Uses the full 6-degrees of freedom. 
Orbit: Orbit about the view center. 
Rotation 


Rotation style for the viewport. 


Turntable: Rotates the view keeping the horizon 
horizontal. 

Trackball: Is less restrictive, allowing any 
orientation. 


Show Navigation Guide 
Display the pivot point and axis during rotation. 


Invert Zoom 
Zoom using opposite direction. 


Lock Camera Pan/Zoom 
Pan/zoom the camera view instead of leaving the camera 
view when orbiting. 


Swap Y and Z Axes 
Pan using up/down on the NDOF devices instead of 
forward/backwards. 


Invert Axis Pan 
Reverses the panning axis on the selected axes. 


Orbit 


Reverses the orbit axis on the selected axes. 


Fly/Walk 
Settings to control how the NDOF device is used while 
using Walk/Fly Navigation. 


Lock Horizon 
Keeps the horizontal axis level while flying. 


Helicopter Mode 
Moves the 3D Viewport up or down when moving the 
NDOF device up/down. 


Navigation 


Interface Orbit & Pan 
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Walk 


Gravity 


Blender Preferences navigation section. 


Orbit & Pan 


Orbit Method 


Choose you are preferred method of interactively rotating 
the 3D Viewport. 


Turntable 
Rotates the view keeping the horizon horizontal. 


This behaves like a potter’s wheel or record player 
where you have two axes of rotation available, and 
the world seems to have a better definition of what is 
“Up” and “Down” in it. 


The drawback to using the Turntable style is that you 
lose some flexibility when working with your objects. 
However, you gain the sense of “Up” and “Down” 
which can help if you are feeling disoriented. 


Trackball 
Is less restrictive, allowing any orientation. 


Orbit Sensitivity 
Adjusts the reactivity/speed of orbiting in the 3D 


Viewport. This setting works differently depending on 
what Orbit Method is used: 


e Turntable: Orbit Sensitivity controls the amount of 
rotation per-pixel to control how fast the 3D Viewport 
rotates. 

e Trackball: Orbit Sensitivity as a simple factor for how 
fast the 3D Viewport rotates. 


Orbit Around Selection 


The selection center becomes the rotation center of the 
viewport. When there is no selection the last selection 
will be used. 


This uses the selected object (bounding box center), in 
Object Mode and select elements in edit/pose modes. 


Note 


While this may seem like ideal behavior, it can be 
inconvenient for larger objects such as a terrain mesh, 
where the center is not necessarily a point of interest. 


Auto 
Perspective 
When enabled, the view switches to Perspective when 
orbiting the view, and to Orthographic when aligning 
to an axis (Top, Side, Front, Back, etc.). 


When disabled, this switching needs to be done 
manually. 


Auto Depth 
Use the depth under the mouse to improve view pan, 
rotate, zoom functionality. Useful in combination with 
Zoom To Mouse Position. 


Smooth View 
Time (in milliseconds) the animation takes when 
changing views (Top/Side/Front/Camera...). Reduce to 
zero to remove the animation. 


Rotation Angle 
Rotation step size in degrees, when Numpad4, Numpad6, 
Numpad8, Or Numpad2 are used to rotate the 3D Viewport. 


Zoom 


Zoom Method 
Choose your preferred style of zooming in and out, when 
using interactive zoom. 


Scale 
Scale zooming depends on where you first click in the 
view. To zoom out, move the cursor to the area center. 
To zoom in, move the cursor away from the area 
center. 


Continue 
The Continue zooming option allows you to control the 
speed (and not the value) of zooming by moving away 
from the initial cursor position. 


Moving up from the initial click point or to the right 
will zoom out, moving down or to the left will Zoom in. 
The further away you move, the faster the zoom 
movement will be. The directions can be altered by 
the Vertical and Horizontal radio buttons and the 
Invert Zoom Direction option. 


Dolly 


Dolly zooming works similarly to Continue zooming 
except that zoom speed is constant. 


Zoom Axis 
The axis of the mouse to use for zooming. 


Vertical 
Moving up zooms out and moving down zooms in. 


Horizontal 
Moving left zooms in and moving right zooms out. 


Zoom to Mouse Position 
When enabled, the mouse pointer position becomes the 
focus point of zooming instead of the 2D window center. 
Helpful to avoid panning if you are frequently zooming in 
and out. 


Tip 
This is useful in combination with Auto Depth to quickly 
zoom into the point under the cursor. 


Invert Zoom Direction 


Mouse 
Inverts the Zoom direction for Dolly and Continue 
zooming. 


Wheel 
Inverts the direction of the mouse wheel zoom. 


Fly & Walk 


View Navigation 
The default mode for interactive first person navigation. 


See Fly/Walk Navigation. 


Walk 


Reverse Mouse 
Inverts the mouse’s Y movement. 


Mouse Sensitivity 
Speed factor for when looking around, high values mean 
faster mouse movement. 


Teleport Duration 
Interval of time warp when teleporting in navigation 
mode. 


Walk Speed 
Base speed for walking and flying. 


Speed Factor 
The multiplication factor for the speed boost. 


Gravity 


Simulates the effect of gravity when walking. 


View Height 
The distance from the ground floor to the camera when 
walking. 


Jump Height 
The maximum height of a jump. 


Keymap 


The keymap edito 
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r lets you adjust your keymap via: 


Predefined keymaps which come with 
Blender and can be added to. 

Keymaps may define their own 
preferences to change the functionality or 


add additional key bindings. 


You may add/remove/edit individual 


keymap entries. 


Blender 
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Blender Preferences Keymap section. 


Preset Management 


Keymap Presets 
Select the keymap from a list of predefined keymaps. 


Import 
Importing opens a File Browser to select a .py file to add 
to the list of keymap presets. 


Export 
Saves the current keymap configuration as a preset 
others may use. 


All Keymaps 
When disabled, only the keymaps and categories that 
have been modified by the user will be exported. In 
addition, add-ons may register keymaps to their 
respective functions, however, these keymaps are not 
exported unless changed by the user. This exported 
file may be thought of as a “keymap delta” instead of 
a full keymap export. 


When enabled, the entire keymap is written. 
Filtering 


Filter Type 
Name 
Search the keymap item by the operator name it runs. 


Key Binding 
Search the keymap item by the key used to activate 
it. 


Hint 
You could for example search with Ctrl Shift c for 
keymap items that use all these keys. 


Search 
The text to search (leave blank to disable). 


Preferences 


Keymaps may define their own preferences, these are 
predefined adjustments to the keymap you can make 
without having to manually adjust individual keymap items 
which can cause problems with newer Blender Versions. 


See the default keymap preferences for options available in 
the default keymap. 


Editor 


The Keymap editor lets you change the default hotkeys. You 
can change keymaps for each of Blender’s editors. 


v Loop Select Mouse : Alt Left Mouse x 


mesh.loop select Left vy Click 
Any Shift Ctrl 


Extend Select x Toggle Select 


Keymap editor. 


Usage 


1. Select the keymap you want to change and click on the 
white arrows to open up the keymap tree. 

2. Select which Input will control the function. 

3. Change hotkeys as you want. Just click on the shortcut 
input and enter the new shortcut. 


Active 
Uncheck to disable this keymap item. 


Map Type 
Keyboard 
Single hotkey or key combination. 


Mouse 
Actions from mouse buttons, tablet or touchpad input. 


NDOF 
Movement from a 3D mouse (NDOF) device. 


Tweak 
Mouse click and drag (optionally map drag direction to 
different actions). 


Text Input 
Use this function by entering a text. 


Timer 
Used to control actions based on a time period. E.g. by 
default, Animation Step uses “Timer 0”, Smooth View 
uses “Timer 1”. 


Operator ID Name 
The identifier for the operator to call. 


Hint 


See bpy.ops for a list of operators (remove the bpy. prefix 
for the identifier). 


Event 
Type 


The key or button that activates this keymap item 
(depending on the map type). 


Value 


The action (such as press, release, click, drag, etc.), 
(depending on the map type). 


Modifier 
Additional keys to hold (such as Ctrl, Shift, Alt). 


Operator Properties 


Changes to the defaults properties this operator is 
activated with 


See also 
Keymap Customization for more information on keymap 


editing. 


Restoring 

If you want to restore the default settings for a keymap, just 
click on the Restore button at the top right of this keymap. 
Tip 

Instead of deleting the default keymap to create your 


custom one, you can just add a new Preset for both the 
mouse and keyboard. 


Known Limitations 


Blender Versions 


A problem with modifying your own keymap is newer 
Blender versions key change the way tools are accessed, 
breaking your customized keymap. 


While the keymap can be manually updated, the more 
customizations you make, the higher the chance of conflicts 
in newer Blender versions is. 


System 


The System section allows you to set graphics card options, 
memory limits & sound settings. 


If your hardware does not support some of the options 
described on this page, then they will either not be 
displayed or be corrected on startup. 
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Preferences System section. 


Cycles Render Device 


Changes the computing device the Cycles render engine 
uses to render images. Cycles can use either the CPU or 
certain GPUs to render images, for more information see the 
GPU Rendering page. 


None 
When set to None or when the only option is None: the 
CPU will be used as the computing device for Cycles. 


CUDA 
If the system has a compatible Nvidia CUDA device, it will 
be available as an option for rendering with Cycles. 


Optix 
If the system has a compatible Nvidia OptiX device, it will 
be available as an option for rendering with Cycles. 


HIP 
If the system has a compatible AMD HIP device, it will be 
available as an option for rendering with Cycles. 


oneAPI 
If the system has a compatible Intel oneAPI device, it will 
be available as an option for rendering with Cycles. 


Metal 
If the system has a compatible Apple Metal device, it will 
be available as an option for rendering with Cycles. 


Distribute Memory Across Devices 
Allocates resources across multiple GPUs rather than 
duplicating data, effectively freeing up space for larger 
scenes. Note that in order for this option to be available, 
the GPUs must be connected together with a high 
bandwidth communication protocol. Currently only 
NVLink on Nvidia GPUs is supported. 


MetalRT (Experimental) 
MetalRT for ray tracing uses less memory for scenes 
which use curves extensively, and can give better 
performance in specific cases. However this support is 
experimental and some scenes may render incorrectly. 


Operating System Settings 
Make this installation your default Blender. 


Note 


This panel of options is only available on Microsoft 
Windows. 


Make Default 
Make the currently in use Blender installation the default 
for generating thumbnails and the default for opening 
blend-files. 


Memory & Limits 


Undo Steps 
Number of Undo steps available. 


Undo Memory Limit 
Maximum memory usage in Mb (0 is unlimited). 


Global Undo 
This enables Blender to save actions done when you are 
not in Edit Mode. For example, duplicating objects, 
changing panel settings or switching between modes. 


Warning 


While disabling this option does save memory, it stops 
the Adjust Last Operation panel from functioning, also 
preventing tool options from being changed in some 

cases. For typical usage, its best to keep this enabled. 


See also 


Read more about Undo and Redo options. 


Console Scroll-back Lines 
The number of lines, buffered in memory of the console 
window. Useful for debugging purposes and command- 
line rendering. 


Texture Time Out 


Time since last access of a GL texture in seconds, after 
which it is freed. Set this to 0 to keep textures allocated. 


Garbage Collection Rate 
Number of seconds between each run of the GL 
texture garbage collector. 


VBO Time Out 
Time since last access of a GL vertex buffer object (VBO) 
in seconds after which it is freed (set to 0 to keep VBO 
allocated). 


Garbage Collection Rate 
Number of seconds between each run of the GL vertex 
buffer object garbage collector. 


Video Sequencer 


Memory Cache Limit 
Upper limit of the Video Sequencer and Movie Clip Editor 
memory cache (in megabytes). For an optimal Clip editor 
and Sequencer performance, high values are 
recommended. 


Disk Cache 
Writes cached strips to disk which can store a lot more 
than RAM. To use the Disk Cache, this option must be 
enabled, the Disk Cache Directory and Disk Cache Limit 
set, then save or reopen the existing blend-file. 


Directory 
The location on disk to store the cache. 


Cache Limit 
Upper limit of the Video Sequencer’s disk cache (in 
gigabytes), setting to zero disables disk cache. 


Compression 
The level of compression to compress image in the disk 
cache. This has a trade off between saving disk space 
and requiring more processing. The more compression 
used requires faster disk write/read speeds and more 
CPU usage. 


Proxy Setup 
When and how Proxies are created. 


Automatic: Build proxies for added movie and 
image strips in each preview size. 
Manual: Set up proxies manually. 
See also 


Sequencer Cache Properties 


Sound 


This panel contains the sound settings for live playback 
within Blender and are only available with a device other 
than None. To control these settings for exporting sound see 
the Encoding Panel and Audio Panel. 


Audio Device 


Sets the audio engine to use to process and output 


audio. 


None: 


CoreAudio: 


PulseAudio: 


WASAPI: 


Jack: 


OpenAL: 


No audio playback support (audio strips 
can still be loaded and rendered 
normally). 

On macOS, CoreAudio is the native 
audio API. This is the default setting for 
macOS users and should be preferred. 
PulseAudio is the most commonly used 
sound server on modern Linux 
distributions. If PulseAudio is available, 
this should be the preferred setting on 
Linux. 

On Windows, WASAPI is the native 
audio API introduced with Windows 
Vista. This is the default setting for 
Windows users and should be 
preferred. 

High quality professional audio engine 
that needs a properly configured server 
running on your system. Supports 
accurate synchronization with other 
professional audio applications using 
Jack. 


Available on all platforms in case the 
native engines do not work. The played 
back 3D audio might sound different 
than when rendered. 

SDL: Uses Simple Direct Media Layer API 
from libsdl.org which supports all 
platforms. Might be of lower quality 
and thus should only be used as 
backup. 


Channels 
Sets the audio channel count. 


Mixing Buffer 
Sets the number of samples used by the audio mixing 
buffer. Higher buffer sizes can cause latency issues, but if 
you hear clicks or other problems, try to increase the 
size. 


Sample Rate 
Sets the audio sampling rate. 


Sample Format 
Sets the audio sample format. 
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Preferences Save/Load section. 


Blend Files 


Save 
Save Prompt 
Asks for confirmation before closing or opening a new 
blend-file if the current file has unsaved changes. 


File Preview Types 
Select how blend-file preview are generated. These 
previews are used both in the and for 


previews shown in the operating system’s file browser. 


None: Do not generate any blend-file 
previews. 
Auto: If there is no camera in the 3D 


Viewport a preview using a screenshot 
of the active Workspace is generated. If 
a camera is in the scene, a preview of 
the viewport from the camera view is 
used. 

Screenshot: Generate a preview by taking a 
screenshot of the active Workspace. 

Camera View: Generate a preview of a Workbench 
render from the camera’s point of view. 


Default To 
Relative Paths 
Default value for Relative Paths when loading external 
files such as images, sounds, and linked libraries. It 
will be ignored if a path is already set. 


Compress File 
Default value for Compress file when saving blend- 
files. 


Load UI 
Default value for Load Ul when loading blend-files. 


Text Files 
Tabs as Spaces 
Entering Tab in the Text Editor adds the appropriate 
number of spaces instead of using characters. 


Save Versions 
Number of versions created (for backup) when saving 
newer versions of a file. 


This option keeps saved versions of your file in the same 
directory, using extensions: .blend1, .blend2, etc., with the 
number increasing to the number of versions you specify. 


Older files will be named with a higher number. E.g. with 
the default setting of 2, you will have three versions of 
your file: 


* blend: last saved. 

* blend1: second last saved. 

* blend2: third last saved. 
Recent Files 


Number of files displayed in File » Open Recent. 


Auto Save 


Enables Auto Save. Tells Blender to automatically save a 
backup copy of your work-in-progress files to the Temporary 
Directory. 


Timer 
This specifies the number of minutes to wait between 
each Auto Save. The default value of the Blender 
installation is 2 minutes. The minimum is 1, and the 
Maximum is 60 (Save every hour). 


Auto Run Python Scripts 


Python scripts (including driver expressions) are not 
executed by default for security reasons. You may be 
working on projects where you only load files from trusted 
sources, Making it more convenient to allow scripts to be 
executed automatically. 


Excluded Paths 


Blend-files in these folders will not automatically run 
Python scripts. This can be used to define where blend- 


files from untrusted sources are kept. 


See also 


Python Security. 


File Browser 


Show Locations 


Recent 
Hide the Recent panel of the File Browser which 


displays recently accessed folders. 


System 
Hide System Bookmarks in the File Browser. 


Defaults 
Filter Files 
By activating this, the file region in the File Browser 
will only show appropriate files (i.e. blend-files when 
loading a complete Blender setting). The selection of 
file types may be changed in the file region. 


Show Hidden Files/Data-Blocks 
Hide files which start with . in File Browsers and data 


IDs. 


Hint 
Data-blocks beginning with a . can be selected by 
typing in the . characters. When explicitly written, 
the setting to hide these data-blocks is ignored. 


File Paths 


The File section in Preferences allows you to configure auto- 
save preferences and set default file paths for blend-files, 
rendered images, and more. 


Locations for various external files can be set for the 
following options: 
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Name Path 


User Library /tmp/tmp7g1gx515/Blender/Assets 


Preferences File Paths section. 
Hint 


The default path // refers to the folder of the currently 
open blend-file (see for details). 


Data 


Fonts 
Default location to browse for text object font files. 


Textures 
Default location to browse for image textures. 


Scripts 
An additional location to search for Python scripts. 


By default Blender looks in several directories (platform 
dependent) for scripts. By setting a user script path in 
the preferences an additional directory is used. This can 
be used to store your own scripts and add-ons 
independently of the current Blender version. 


You will need to create specific subfolders in this path 
which match the structure of the scripts folder found in 
Blender’s installation directory. 


The following subdirectories will be used when present: 


startup/ 
Modules in this folder will be imported on startup. 


addons/ 
Add-ons located here will be listed in the add-ons 
preferences. 


modules/ 
Modules in this folder can be imported by other 
scripts. 


presets/ 
Presets in this folder will be added to existing presets. 


Note 


You have to restart Blender for all changes to the users 
scripts to take effect. 


Sounds 
Default location to browse for sound files. 


Temporary Files 
The location where temporary files are stored, leave 
blank to use the systems temporary directory (see 
Temporary Directory for details). 


Render 


Render Output 
Where rendered images/videos are saved. 


Render Cache 
The location where cached render images are stored. 


Applications 


Image Editor 
The path to an external program to use for image editing. 


Animation Player 
The program used for playing back rendered animations 
via View Animation. 


By default this is set to /nternal which uses Blender’s 
built-in animation player. 


This has the advantage that all image formats supported 
by Blender can be played back and no 3rd party 
application needs to be installed. 


Development 


Only visible when Developer Extras are enabled. 


118n Branches 
The path to the /branches directory of your local SVN 
translation copy, to allow translating from the UI. 


Asset Libraries 


Name and on-drive directory paths of asset libraries. To 
make Blender aware of an asset library, add it to this list. 
The name is for your reference only, and will appear in asset 
library selectors. The path should point to the location of the 
asset library. 


Y Asset Libraries 


Name Path 


User Library /home/sybren/Documents/Blender/Assets 


Simon's Materials /home/sybren/syncthi...ndles/simon-materials/ 


Name and Location of asset libraries in the 
Preferences. 


To create a new asset library, just create an empty directory 
and add it to the list. Any asset from any blend-file 
contained in that directory (or subdirectories thereof) will 
appear in the Asset Browser, 


Known Limitations 


Permissions on Windows 


Be sure that you have the right privileges for running the 
executable accessing the path defined. On Windows for 
instance, if the option “Run this program as an 
administrator” is enabled for the executable, it will lead to a 
failure to open the editor due to a limitation within the OS 
User Account Control. Running a program with elevated 
privileges is potentially dangerous! 


Experimental 


These preferences are reserved for features that are 
currently being worked on and are not yet complete. This 
category can be enabled by enabling 

Most experimental features are only available in 
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Blender Preferences Experimental section. 
Debugging 


Cycles Debug 
Show the Cycles rendering debug panel. 


Override Auto Resync 
Enables library overrides automatic resync detection and 
process on file load. Disable when dealing with older 
blend-files that need manual Resync (Enforce) handling. 


Proxy to Override Auto Conversion 
Enables conversion of proxies to library overrides on file 
load. Disable if you want to keep existing proxies, and 
deal with their conversion yourself. 
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Introduction 


Scenes are a way to organize your work. Each blend-file can 
contain multiple scenes, which share other data such as 
objects and materials. 


Scene management and library appending/linking are based 
on Blender’s Library and Data System, so it is a good idea to 
read that manual page first, if you are not familiar with the 
basics of that system. 


Controls 


Reference 


Menu: Topbar >» Scene 


You can select and create scenes with the Scene data-block 
menu in the Topbar. 
Scenes sv Scene (CG 

A list of available scenes. 

Scene data-block menu. 

Add 

New 

Creates an empty scene with default values. 


Copy Settings 
Creates an empty scene, but also copies the settings 
from the active scene into the new one. 


Linked Copy 


This option creates a new scene with the same 
settings and contents as the active scene. However, 
instead of copying the objects, the new scene 
contains links to the collections in the old scene. 
Therefore, changes to objects in the new scene will 
result in the same changes to the original scene, 
because the objects used are literally the same. The 
reverse is also true. 


Full Copy 
Using this option, nothing is shared. This option 
creates a fully independent scene with copies of the 
active scene’s contents. Every object in the original 
scene is duplicated, and a duplicate, private copy of 
its object-data is made as well. 


Note 


To choose between these options, it is useful to 
understand the difference between Object and Object 
Data. The choices for adding a scene, therefore, 
determine just how much of this information will be 
copied from the active scene to the new one, and how 
much will be shared (linked). 


Delete x 


You can delete the current scene by clicking the X next to 
the name in the Jopbar. 


See also 
Linking to a Scene 


You can link any object from one scene to another. 


Scene Properties 


Scene 


Reference 


Panel: Properties » Scene > Scene 


Camera 
Used to select which camera is used as the active 
camera. You can also set the active camera in the 3D 
Viewport with Ctrl-Numpado. 


Background Scene 


Allows you to use a scene as a background, this is 
typically useful when you want to focus on animating the 
foreground for example, without background elements 
getting in the way. 


This scene can have its own animation, physics 
simulations, etc, but you will have to select it from the 
Scene data-block menu, if you want to edit any of its 
contents. 


Background Scenes can themselves have a Background 
Scene (they’re recursively included). So you can always 
make additions to existing scenes by using them as a 
background to a newly created scene where your 
additions are made. 


Tip 


This can also be used in combination with Linking to a 
Scene, where one blend-file contains the environment, 
which can be reused in many places. 


Active Clip 
Selects a Movie Clip that can be used by Motion Tracking 
Constraints or a camera’s Background Images. 


Units 


Reference 


Panel: Properties >» Scene » Units 


Unit System 
The unit system to use for user interface controls. 


None: Use units that have with no relation to 
the real world, practically this is the 
same as Metric just without unit 


names. 

Metric: Use the metric unit system in this 
scene. 

Imperial: Use the imperial unit system in this 
scene. 


Unit Scale 
Scale factor to use when converting between internal 
units and values displayed in the user interface. This can 
be changed when modeling at microscopic or 
astronomical scales. 


Note 


This only influences the values displayed in the user 
interface and not how things behave internally. For 


example, physics simulations don’t take the unit scale 
into account. 


Separate Units 


When using Metric or Imperial, display properties as 


multiple values. For example, 2.285m will become 2m 
28.5cm. 


Rotation 
Unit to use for displaying/editing rotation values. 


Degrees: Use degrees for angles in the user 
interface. 
Radians: Use radians for angles in the user 
interface. 
Length 


Unit that will be used to display length values. 


Adaptive: The unit used for a specific value 
depends on the magnitude of the 
value. For example, some values might 
be displayed as 23cm while others are 
displayed as 10km. 

Meters/Centimeters/Feet: 

A fixed unit that will be used for all 
lengths in the user interface. 


Mass 

See Length. 
Time 

See Length. 


Temperature 


See Length. 
Imperial Length Units 
Full Name Short Name(s) Scale of a Meter 
thou mil 0.0000254 
inch "in 0.0254 
foot, feet ee 0.3048 
yard yd 0.9144 
chain ch 20.1168 
furlong fur 201.168 
mile mi, m 1609.344 
Metric Length Units 
Full Name Short Name(s) Scale of a Meter 
micrometer um 0.000001 


millimeter mm 0.001 


Full Name 
centimeter 
decimeter 
meter 
dekameter 
hectometer 


kilometer 


Gravity 


Reference 


Panel: 


Short Name(s) 


cm 


dm 


dam 


hm 


km 


Scale of a Meter 


0.01 


0.1 


1.0 


10.0 


100.0 


1000.0 


Properties >» Scene > Gravity 


Options to control global gravity used for physics effects. 


See the Physics chapter for more information. 


Keying Sets 


Reference 


Panel: Properties >» Scene > Keying Sets 


See Keying Sets. 
Audio 


Reference 


Panel: Properties » Scene >» Audio 


Options to control global audio settings. To control how 
sounds is played back from within Blender, see the audio 
settings in the Preferences. 


Volume 
Volume for the scene. 


Distance Model 
Changes how the sound attenuation is calculated based 
on the distance. Most physically correct is the /nverse 
model, but it’s also possible to choose a linear and an 
exponential falloff. The clamped modes limit the volume 
to be lower than 100% (1.0), that means if the distance is 
smaller than the reference distance, the volume is 
always 100%. For an exact description of each option see 
the OpenAL documentation. 


Doppler Speed 
Speed of the sound for the Doppler effect calculations. 
The typical value is 343.3 m/s in air, in water for example 
this value is around 1560 m/s. 


Doppler Factor 
Controls how strong the Doppler effect is. You can 
exaggerate or attenuate the change of pitch, but 


physically correct is a factor of 1.0. 


Update Animation Cache 
Updates the audio animation cache. This is useful if you 
start noticing artifact in the audio. 


Rigid Body World 


Reference 


Panel: Properties » Scene » Rigid Body World 


The Rigid Body World is a group of rigid body objects, which 
holds settings that apply to all rigid bodies in this 
simulation. 


See Rigid Body World for more information. 
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Instancing 
Visibility 
Viewport Display 
Line Art 


Introduction 


The geometry of a scene is constructed from one or more 
objects. These objects can range from lights to illuminate 
your scene, basic 2D and 3D shapes to fill it with models, 
armatures to animate those models, to cameras to take 
pictures or make video of it all. 


Each Blender object type (mesh, light, curve, camera, etc.) 
is Composed from two parts: an Object and Object Data 
(sometimes abbreviated to “ObData”): 


Object 


Holds information about the position, rotation and size of 
a particular element. 


Object Data 
Holds everything else. For example: 


Meshes: Store geometry, material list, vertex 
groups, etc. 
Cameras: Store focal length, depth of field, 


sensor size, etc. 


Each object has a link to its associated object-data, anda 
single object-data may be shared by many objects. 


Object Types 


Reference 

Mode: Object Mode 
Menu: Add 
Shortcut: Shift-A 


New objects can be created with the Add menu in the 3D 
Viewport’s header. 


Mesh 
Objects composed of vertices, edges and polygonal faces 
and can be edited extensively with Blender’s mesh 
editing tools. See Mesh Primitives. 


Curve 
Mathematically defined objects which can be 
manipulated with control handles or control points 
(instead of vertices), to edit their length and curvature. 
See Curves Primitives. 


Surface 
Mathematically defined patches that are manipulated 
with control points. These are useful for simple rounded 
forms and organic landscapes. See Surfaces Primitives. 


Metaball 
Objects formed by a mathematical function (with no 
vertices or control points) defining the 3D volume in 
which the object exists. Meta objects have a liquid-like 
quality where when two or more metaballs are brought 
together, they merge by smoothly rounding out the 


connection, appearing as one unified object. See Meta 
Primitives. 
Text 


Create a two-dimensional representation of a text. 


Volume 
Container for OpenVDB files that is generated by other 
software or Blender’s Fluid Simulator. 


Grease Pencil 


Objects created by drawing strokes. See Grease Pencil 
Primitives 


Armature 


Used for rigging 3D models to make them poseable and 
animatable. 


Lattice 
Non-renderable wireframes commonly used for the 
deformation of other objects with help of the Lattice 
Modifier. 


Empty 
Null objects that are simple visual transform nodes that 
do not render. They are useful for controlling the position 
or movement of other objects. 


Image 
Empty objects that display images in the 3D Viewport. 
These images can be used to aid artists in modeling or 
animating. 


Light 
Empty objects that emit light and are used for lighting 
the scene in renders. 


Light Probe 
Used by the Eevee render engine to record lighting 
information for indirect lighting. 


Camera 
This is the virtual camera that is used to determine what 
appears in the render. 


Speaker 
Empty objects that bring a source of sound to the scene. 


Force Field 
Empty objects that give simulations external forces, 
creating movement, and are represented in the 3D 
Viewport as small control objects. 


Collection Instance 
Lets you select from a list of existing collections. Once 
selected, an empty object will be created, with an 
instance of the selected collection (collection instancing 
active). 


Common Options 


You can change the options of the object in the Adjust Last 
Operation panel just after creating it: 


Type 
You can change the type of some objects after their 
creation with a selector. 


Radius/Size 
Sets the starting size. 


Align 


Rotates the new object so that it is aligned in one of the 
following manners: 


World 
Aligns the object to the global space axes, i.e. the 
object’s front faces the negative Y axis (default). 


View 
Aligns the object to the view space axes, i.e. the 
object’s front faces the viewport’s point of view. 


3D Cursor 
Aligns the object to match the rotation of the 3D 


Cursor. 


Location 
Objects are placed, by default, at the position of the 3D 
Cursor. These values let you place the object in an other 
position. 


Rotation 
Values let you rotate the object so that default rotation is 
overridden. 


Object Origin 


Each object has an origin point. The location of this point 
determines where the object is located in 3D space. When 
an object is selected, a small circle appears, denoting the 
Origin point. The location of the origin point is important 
when translating, rotating or scaling an object. See Pivot 
Points for more. 


The color of the origin changes based on the selection state 
of the object. 


Yellow: Object is active. 

Orange: Object is selected, but not active. 
White: Object is not linked and not selected. 
Turquoise: Object is linked. 


Light Turquoise: 
Object is selected, linked, but not active. 


Note 


Colors are themeable and might appear different. The 
colors described here are from the default Dark Theme. 


Set Origin 


Reference 


Mode: Object Mode 
Menu: Object > Set Origin 


The object origin and geometry can be moved relative to 
each other and to the 3D cursor. 


Type 
Geometry to Origin 
Moves the model to the origin and this way the origin 
of the object will also be at the center of the object. 


Origin to Geometry 
Moves the origin to the center of the object. 


Origin to 3D Cursor 
Moves the origin of the model to the position of the 3D 
cursor. 


Origin to Center of Mass 
Moves the origin to the calculated center of mass of 
model (assuming the mesh has a uniform density). 


Center 
Median Point Center, Bounding Box Center 


Tip 


To transform an object’s origin directly, enable Affect Only 
Origins in the Tool Settings Options. 


Selecting 


Selection determines which elements will be the target of 
our actions. Selections work on the current scene visible 
objects. Blender has advanced selection methods. Both in 
Object Mode and in Edit Mode. 


Selections and the Active 
Object 


Blender distinguishes between two different states of 
selection: 


Active object in yellow, selected object in orange, 
and unselected object in black. 


In Object Mode the last (de)selected item is called the 
“Active Object” and is outlined in yellow (the others are 


orange). There is at most one active object at any time. 


Many actions in Blender use the active object as a reference 
(for example linking operations). If you already have a 
selection and need to make a different object the active 
one, simply reselect it with Shift-LmB. 


All other selected objects are just selected. You can select 
any number of objects. In order to change a property or to 
perform an operation on all selected objects (bones, and 
sequencer strips) hold Alt, while confirming. 


Select Menu 


All 

Reference 

Mode: All Modes 
Menu: Select > All 
Shortcut: A 


Select all selectable objects. 


None 

Reference 

Mode: All Modes 
Menu: Select >» None 
Shortcut: Alt-A 


Deselect all objects, but the active object stays the same. 


Invert 


Reference 

Mode: All Modes 
Menu: Select > Invert 
Shortcut: Ctrl-I 


Toggle the selection state of all visible objects. 


Box Select 


Reference 

Mode: All Modes 

Menu: Select >» Box Select 
Shortcut: B 


Interactive box selection. 


Circle Select 


Reference 

Mode: All Modes 

Menu: Select > Circle Select 
Shortcut: C 


Interactive circle selection. 


Lasso Select 


Reference 


Mode: All modes 
Menu: Select > Lasso Select 
Shortcut: Ctrl-Alt-LMB 


See Select Lasso. 


Select All by Type 


Reference 
Mode: Object Mode 
Menu: Select > Select All by Type 


With this tool, it becomes possible to select objects of a 
certain type in one go. For a description of all object types 
see Object Types. 


Select Active Camera 


Reference 
Mode: Object Mode 
Menu: Select >» Select Active Camera 


Selects the active camera, this is especially handy in 
complex scene. 


Select Mirror 


Reference 


Mode: All Modes 
Menu: Select >» Select Mirror 


Select the Mirror objects of the selected object, based on 
their names, e.g. “Sword.L’ and “sword.R”. 


Select Random 


Reference 
Mode: Object Mode 
Menu: Select » Select Random 


Randomly selects unselected objects based on percentage 
probability. The percentage can be modified in the Adjust 
Last Operation panel. It is important to note that the 
percentage is the likelihood of an unselected object being 
selected and not the percentage amount of objects that will 
be selected. 


Select More/Less 


Reference 

Mode: Object Mode 

Menu: Select » More/Less 

Shortcut: Ctrl-NumpadPlus, Ctrl-NumpadMinus 


Their purpose, based on the hierarchical. 


More 
Expand the selection to the immediate parent and 
children of the selected objects. 


Less 
Contrast the selection, deselect objects at the boundaries 
of parent/child relationships. 


Parent 
Deselects the currently selected objects and selects their 
immediate parents. 


Child 
Deselects the currently selected objects and selects their 
immediate children. 


Extend Parent 
Extends the selection to the immediate parents of the 
currently selected objects. 


Extend Child 
Extends the selection to the immediate children of the 
currently selected objects. 


Select Grouped 


Reference 

Mode: Object Mode 

Menu: Select > Select Grouped 
Shortcut: Shift-G 


There are two ways to organize the objects in relation to one 
another. The first one is parenting, and the second is simple 
grouping. These relationships to an artist’s advantage by 
selecting members of respective families or groups. Select 
Grouped uses the active object as a basis to select all 
others. 


Children 
Selects all hierarchical descendants of the active object. 


Immediate Children 
Selects all direct children of the active object. 


Parent 
Selects the parent of this object if it has one. 


Siblings 
Select objects that have the same parent as the active 
object. This can also be used to select all root level 
objects (objects with no parents). 


Type 
Select objects that are the same type as the active one. 


Collection 
Select all objects that are in the same collection as the 
active one. If the active object belongs to more than one 
collection, a list will pop up so that you can choose which 
collection to select. 


Object Hooks 
Every hook that belongs to the active object. 


Pass 
Select objects assigned to the same Render Pass. 


Color 
Select objects with same Object Color. 


Keying Set 
Select objects included in the active Keying Set. 


Light Type 
Select matching light types. 


Select Linked 


Reference 


Mode: Object Mode 
Menu: Select >» Select Linked 
Shortcut: Shift-L 


Selects all objects which share a common data-block with 
the active object. Select Linked uses the active object as a 
basis to select all others. 


Object Data 
Selects every object that is linked to the same Object 
Data, i.e. the data-block that specifies the type (mesh, 
curve, etc.) and the build (constitutive elements like 
vertices, control vertices, and where they are in space) of 
the object. 


Material 
Selects every object that is linked to the same material 
data-block. 


Instanced Collection 
Select every object that is linked to the instanced 
collection. 


Texture 
Selects every object that is linked to the same texture 
data-block. 


Particle System 
Selects all objects that use the same Particle System. 


Library 
Selects all objects that are in the same Library. 


Library (Object Data) 
Selects all objects that are in the same Library and 
limited to Object Data. 


Select Pattern 


Reference 
Mode: Object Mode 
Menu: Select > Select Pattern... 


Selects all objects whose name matches a given pattern. 
Supported wild-cards: * matches everything, ? matches any 
single character, [abc] matches characters in “abc”, and 
[!'abc] match any character not in “abc”. As an example 
*house* matches any name that contains “house”, while 
floor* matches any name starting with “floor”. 


Case Sensitive 
The matching can be chosen to be case sensitive or not. 


Extend 
When Extend checkbox is checked the selection is 
extended instead of generating a new one. 


Editing 
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Introduction 


Transformations refer to a number of operations that can be 
performed on a selected Object or Mesh that alters its 
position or characteristics. 


Each object can be moved, rotated and scaled in Object 
Mode. However, not all of these transformations have an 
effect on all objects. For example, scaling a camera has no 
effect on the render dimensions. 


Basic transformations include: 


e Move 
e Rotate 
e Scale 


These three transforms are the three big ones. However, 
more advanced transformations can be found in the 
Advanced Transformations section. 


For making other changes to the geometry of editable 
objects, you should use Edit Mode. 


Once you have added a basic object, you remain in Object 
Mode. You can switch between Object Mode and Edit Mode 
by pressing Tab. The object’s wireframe should now appear 
orange. This means that the object is now selected and 
active. 


Transform Control 


Transform controls can be used to modify and control the 
effects of the available transformations. 


e Numeric Input 

o Simple Mode 

o Advanced Mode 
e Axis Locking 

o Usage 

o Axis Locking Types 
e Precision 

o Usage 

o Snapping 

o Precision 


Numeric Input 


Using the mouse for transformations is convenient, but if 
you require more precise control, you can also enter 
numeric values. After pressing the shortcut type a number 
to indicate the magnitude of the transformation. Then 
confirm or cancel. E.g. pressing S 2, Return will double the 
scale of an object. 


Move G 
By default and with no other key presses, the translation 
will occur along the X axis. 


Rotation R 
The rotation is in clockwise direction for positive values. 


Scale s 
Scaling works in almost identical fashion to translation. 
The primary difference is that by default, scaling applies 
equally to all three axes. 


You can see the numbers you enter in the 3D Viewport 
footer. 


Dx: [pi * 2|] = 6m 28cm Dy: NONE Dz: NONE (6.283m) 


User Perspective 
(1) Collection | Cube 


Numeric input displayed in the footer. 


Tip 


Numeric input can also be inputted in the Properties 
region. 


Simple Mode 


Blender has two “modes” a simple and an advanced one. 
Simple mode only accepts simple numbers. You can use 
basic text editing except selection. 


Decimals Period 
Decimals can be entered by pressing Period. 


Negate Minus 
Negate the whole value by pressing Minus. 


Inverse Slash 
Hitting Slash during number entry switches the number 
being entered to its reciprocal, e.g. 2 / results in 0.5 
(1/2); 20 / results in 0.05 (1/20). 


Reset Backspace 
Hitting Backspace after having deleted all leading chars will 
first reset the edited value to initial state, and on second 
press, the whole number editing will be canceled, going 
back to usual transform with mouse. 


Next/Previous Component Tab, Ctrl-Tab 
To enter numeric values for multiple axes, use Tab or Ctrl- 
Tab. E.g. To move an object, one unit on all three axes 
press: G 1 and Tab 1 and Tab 1. 


Non-number Inputs 
You can also combine numeric input with Axis Locking to 
limit movement to a particular axis or tool specific 


shortcuts. 


Advanced Mode 


In advanced mode you can additionally enter expressions 
and units. 


Use = or NumpadAsterisk to enable advanced mode, and Ctrl-= 
Or Ctrl-NumpadAsterisk to switch back to simple mode. 


It features: 


e Units (cm, ", deg, etc.). See unit system. 

e Basic operations from Python (+, *, /, **, etc.). 

e Math constants and functions (pi, sin, sqrt, etc.). See 
Python’s math module. 


You can still use the negate and inverse shortcuts (Minus, 
Slash), aS well aS non-number inputs, but you have to hold 
Ctri to activate them. 


Axis Locking 


This option limits the transformation to the specified axis. 


Transformations (translation/scale/rotation) in Object Mode 
and Edit Mode (as well as extrusions in Edit Mode) can be 
locked to a particular axis relative to the current transform 
orientation. By locking a transformation to a particular axis 
you are restricting transformations to a single dimension. 


Axis locking. 


Usage 


A locked axis will display in a brighter color than an unlocked axis. For example 
in the image to the right, the Z axis is shown in light blue as movement is 
constrained to this axis. This example, can be achieved in two ways: 


Hotkey 


The axis of movement can be changed at any time during transformation by 
typing xX, Y, Z. 


Pointing 


Axis constraint in action. 


Holding mms after starting a transformation lets you select an axis to constrain to. 
A visual option to constrain the translation will be available, showing the three 
axes in the 3D Viewport space. A dotted white line is used as a pointer. The axis 
of choice to confirm the operation will depend on the highlighted axis about 
which the mms is released. 


When you already moved the mouse in the desired direction, pressing mms will 
lock to the axis which was pointed at. 


Axis Locking Types 


Axis Locking 


Reference 
Mode: Object and Edit Modes (move, rotate, scale, extrude) 
Shortcut: X, Y, Z Or MMB after moving the mouse in the desired direction. 


Axis locking limits the transformation to a single axis (or forbids transformations 
along two axes). An object, face, vertex or other selectable item will only be able 
to move, scale or rotate in a single dimension. 


Plane Locking 


Reference 
Mode: Object and Edit Modes (move, scale) 
Shortcut: Shift-X, Shift-Y, Shift-Z or Shift-MMB after moving the mouse in 


the desired direction. 


Plane locking locks the transformation to two axes (or 
forbids transformations along one axis), thus creating a 
plane in which the element can be moved or scaled freely. 
Plane locking only affects translation and scaling. 


Note that for rotation, both axis and plane locking have 
the same effect because a rotation is always constrained 
around one axis. Trackball type rotations R R cannot be 
locked at all. Plane locking. 


Axis Locking Modes 


A single key press constrains movement to the current transform orientation 
selection. A second key press of the same key constrains movement to the 
corresponding Global axis (except if the transform orientation is set to Global, in 
which case the Local! orientation is used). A third key press of the same key 
removes constraints. 


The orientation can be set in the Transform Orientation selector of the 3D 
Viewport header. 


For example, if the current transform orientation is set to Normal, pressing G to 
start translation, followed by z will lock translation in the Z direction relative to 
the Normal orientation, pressing Z again will lock translation to the Z axis relative 
to the Global orientation. Pressing Z again will remove all constraints. The current 
mode will be displayed in the left-hand side of the 3D Viewport header. 


Axis locking modes. 


Z axis Z axis 
' locking in locking in 
oo Z axis Global Normal 
locking in locking in orientation orientation 
Global Local with with 
eSGrgnat, orientation. vertex vertex 
selection. selection. 


As can be seen in the Axis locking modes image, the direction of the transform 
also takes into account the selection. 


Note that using a locked axis does not prevent you from using the keyboard to 
enter numeric transformation values. 


Precision 


Reference 
Mode: Object and Edit Modes 
Shortcut: Ctrl and/or Shift 


Holding ctrl during a transform operation (Such as move, 
rotate or scale) will toggle Transform Snapping. When using 
Increment Snap this allows the transformation to be 
performed in discrete amounts. 


Holding Shift during a transform operation will transform the 
object at 1/10th the speed, allowing much finer control. 


The magnitude of the transformation can be viewed in the 
3D Viewport header. Releasing ctrl or Shift during the 
transformation will cause the movement to revert back to its 
normal mode of operation. 


Note 


The snapping behaviors described on this page only apply 
when Increment Snap is selected. 


Tip 
It is possible to enable both snapping and precision mode, 
simply hold ctrt and Shift. This has the following effects: 


Move 


Changes in 0.1 unit increments, regardless of zoom 
level. 


Rotation 
Changes in 1 unit increments. 


Scale 
Changes in 0.01 unit increments. 


Usage 


With Hotkeys 


Press G, R ors and then hold either ctrl, Shift or Shift-Ctrl. 


With the Transform Gizmo 


Select the gizmo handle then while moving the mouse hold 
Ctrl, Shift Or Shift-Ctrl to activate precision control or 


Snapping. 
See also 


Read more about the Transform Gizmo. 


Tip 
Combining with Other Controls 


All of the precision controls detailed on the page can be 
combined with the Axis Locking controls and used with the 
different Pivot Points. 


Snapping 


Move 


Snapping while moving objects 
changes the object location in 1 unit 
increments. While in an aligned view, 
The increment amount is changed 
based on the zoom level. For 
example, at a base zoom level objects 
are moved in increments of 1 unit (i.e. 
between the two light gray lines). 
Zooming in enough to see the next 
set of gray lines will snap in 
increments of 1/10 of a unit. Zooming 
in further until will snap in increments 
of 1/100 of a unit and so on until the 
zoom limit is reached. Zooming out 
will have the opposite effect and 
cause movement to happen by 
increments of 10, 100 units, etc. 


Rotation 


One unit (default 
zoom level). 


Holding ctri will cause rotations of 5 degrees. 


Scale 


Holding ctrl will cause size changes in increments of 0.1 


units. 


Note 


Snapping Modes 


Note that when you are Snapping To something other than 
Increment, holding ctri will cause the selection to snap to 


that nearest element. 


Read more about snapping. 


Precision 


Holding Shift during transformations allows for very fine 
control that does not rely on fixed increments. Rather, large 
movements of the mouse across the screen only result in 
Small transformations of the selection. 


In rotation mode the selected element will be rotate in 0.01 
degree increments. 


Move 


Reference 

Mode: Object Mode, Edit Mode, and Pose Mode 

Menu: Object/Mesh/Curve/Surface » Transform 
>» Move 

Shortcut: G 


In Object Mode, the move option lets you move objects. 
Translation means changing location of objects. It also lets 
you move any elements that make up the object within the 
3D space of the active 3D Viewport. 


Pressing G activates “Move” transformation mode. The 
selected object or element then moves freely according to 
the mouse pointer’s location and camera. To confirm the 
action, press LMB. While moving items, the amount of change 


along the X, Y, and Z axis is displayed in the header of the 
3D Viewport. 


~, 


Dx: 0.2886m Dy: 0.7307m Dz: 0.06269m (0.7881m) 


Translation Display. 
Tip 
Moving an object in Object Mode changes the object’s 


origin. Moving the object’s vertices/edges/faces in Edit 
Mode does not change the object’s origin. 


See also 


Using a combination of shortcuts gives you more control 
over your transformation. See Transform Control. 


Options 


Move x, Y, Z 
The amount to move the selection on the respected axis. 


Orientation 
Aligns the transformation axes to a specified orientation 
constraint. See Transform Orientations for more 
information. 


Proportional Editing 
The extruded face will affect nearby geometry. See 
Proportional Editing for a full reference. 


Rotate 


Reference 

Mode: Object and Edit Modes 

Menu: Object/Mesh/Curve/Surface » Transform 
> Rotate 

Shortcut: R 


Rotation is also Known as a spin, twist, orbit, pivot, revolve, 
or roll and involves changing the orientation of elements 
(vertices, edges, faces, objects, etc.) around one or more 
axes or the Pivot Point. 


The angle of rotation is displayed in the header of the 3D 
Viewport. 


Rot: 69.95 


Rotation values. 


See also 


Using a combination of shortcuts gives you more control 
over your transformation. See Transform Control. 


Options 


Angle 
The amount of rotation. 


Axis 
Used to constraint the transformation to one or more 
axes. 


Orientation 
Aligns the transformation axes to a specified orientation 
constraint. See Transform Orientations for more 
information. 


Proportional Editing 
The extruded face will affect nearby geometry. See 
Proportional Editing for a full reference. 


Trackball Rotation 


Reference 
Mode: Object and Edit Modes 
Shortcut: RR 


A free rotation mode. Press R R to enable Trackball rotation. 


Scale 


Reference 

Mode: Object and Edit Modes 

Menu: Object/Mesh/Curve/Surface » Transform 
> Scale 

Shortcut: S 


Scaling means changing proportions of objects. Pressing s 
will enter the Scale transformation mode where the selected 
element is scaled inward or outward according to the mouse 
pointer’s location. The element’s scale will increase as the 
mouse pointer is moved away from the Pivot Point and 
decrease as the pointer is moved towards it. If the mouse 
pointer crosses from the original side of the Pivot Point to 
the opposite side, the scale will continue in the negative 
direction and flip the element. 


Basic scale usage. From left to right, the panels 
show: the original object, a scaled down object, a 
scaled up object and a scale-flipped object. 


The amount of scaling will be displayed in the header of the 
3D Viewport. 


Scale X:-1.4882 ¥-1.4882 Z:-1.4882 


Scale values. 


See also 


Using a combination of shortcuts gives you more control 
over your transformation. See Transform Control. 


Options 


Scale X, Y, Z 
The amount to resize the selection on the respected axis. 


Orientation 
Aligns the transformation axes to a specified orientation 
constraint. See Transform Orientations for more 
information. 


Proportional Editing 
The extruded face will affect nearby geometry. See 
Proportional Editing for a full reference. 


Move/Scale Texture Space 


Reference 


Mode: 


Object Mode and Edit Mode 
Menu: 


Object > Transform >» Move/Scale Texture 
Space 


The Move/Scale Texture Space tool transforms the Texture 
Space of the object, instead of the object or element itself. 


Align to Transform 


Orientation 

Reference 

Mode: Object Mode and Edit Mode 

Menu: Object > Transform » Align to Transform 
Orientation 


Aligns (rotates) the selected objects so that their local 
orientation matches the active transform orientation in the 
Transform orientation panel or the Orientation selection in 
the Transform Adjust Last Operation panels. 


Randomize 


Reference 
Mode: Object Mode and Edit Mode 
Menu: Object > Transform » Randomize 


Transform 


This tool randomizes the move, rotate, 
and scale values to an object or 
multiple objects. When applied on 
multiple objects, each object gets its 
own seed value, and will get different 
transform results from the rest. 


Random Seed 
The random seed is an offset to the 
randomized transformation. A 
different seed will produce a new 


Randomize 
result. transform 
Transform Delta options. 


Randomize Delta Transform values 
instead of regular transform. 


Randomize Location 
Randomize Location values. 


Location 


The maximum distances the objects can move along 
each axis. 


Randomize Rotation 
Randomize rotation values. 


Rotation 
The maximum angle the objects can rotate on each axis. 


Randomize Scale 
Randomize scale values. 


Scale Even 
Use the same scale for each axis. 


Scale 
The maximum scale randomization over each axis. 


Align Objects 


Reference 
Mode: Object Mode 
Menu: Object > Transform >» Align Objects 


The Align tool is used to align multiple selected objects so 
they line up on a specified axis. 


Options 


High Quality 
Uses more precise math to better determine the 
locations for the objects. In case of positive or negative 
bounding box alignment, if one or more of the selected 
objects have any rotation transformations (or delta 
rotation transformations), it is recommended to check 
High Quality so that their bounding box is calculated with 
precision for all three global axes. 


Align Mode 
The Align Mode control will define what part of the 
objects will be aligned: 


Centers 
The objects centers. 


Positive Sides/Negative Sides 
The positive or negative sides (on the global axes) of 
their respective bounding boxes. 


Relative To 


The Relative To control will let us choose to align the 
objects to: 


Active 
The active object. 


Selection 
The median point of the selection. 


3D Cursor 
The current position of the 3D Cursor. 


Scene Origin 
The global origin. 


Align X, Y, Z 
Chooses which axis to align the selected objects on. 


Mirror 


Reference 

Mode: Object and Edit Modes 
Menu: Object/Mesh >» Mirror 
Shortcut: Ctrl-M 


Mirroring an object or mesh selection will create a reversed 
version of the selection. The position of the mirrored version 
of the selection is determined by the Pivot Point. A common 
use of mirroring is to model half an object, duplicate it and 
then use the mirror transform to create a reversed version 
to complete the model. 


Note 


Mirrored duplicates can also be created with a Mirror 
Modifier. 


Mirroring a selection. 


Usage 


To mirror a selection along a particular global axis, press: 
Ctri-M, followed by x, Y or z. The image Mirroring_a Selection 
shows the results of this action after a mesh element has 
been duplicated. 


In mesh mode, you can mirror the selection on the currently 
selected Transform Orientations by pressing the appropriate 
axis key a second time. For example, if the Transform 
Orientation is set to Normal, pressing: ctri-M, followed by x 
and then x again will mirror the selection along the X axis of 
the Normal Orientation. 


Orientation Van Global 


nstraint Ax 


vy xX 


Proportional Editing 


Mirror Adjust Last Operation panel. 


You can alternatively hold the mms to interactively mirror the 
object by moving the mouse in the direction of the mirror 
axis. 


Clear 


Reference 

Mode: Object Mode 

Menu: Object > Clear >» Location / Scale / 
Rotation / Origin 

Shortcut: Alt-G, Alt-S, Alt-R 


Clearing transforms resets the transform values. The objects 
location and rotation values are set to 0, and the scale to 1. 


Clear Location Alt-G 
Clear (reset) the location of the selection. This will move 
the selection back to the coordinates (0, O, 0). 


Clear Scale Alt-s 
Clear (reset) the scale of the selection. This will change 
the scale to (1, 1, 1). 


Clear Rotation Alt-R 
Clear (reset) the rotation of the selection. This will set the 
rotation of the selection to 0 degrees in each plane. 


Clear Origin 
Clears (resets) the offset of the child objects origin from 
the Parent. This will cause child objects to move to the 
origin of the parent. The relationship between the parent 
and child is not affected, you can confirm the relationship 
is still intact by using the Outliner to verify that the child 
object is still parented. 


Options 


Clear Delta 
Clear the delta transform in addition to clearing the 
primary transforms. (Appears in the Adjust Last 
Operation panel.) 


Apply 


These operations lets you apply several transformations to 
the selected objects. The object transformation coordinates 
are transferred to the object data. If the objects have 
hierarchical descendants, it also applies those 
transformations to their children. 


Transforms 
Reference 
Mode: Object Mode 
Menu: Object » Apply » Location / Rotation / 
Scale / Rotation & Scale 
Shortcut: Ctrl-A 


Applying transform values essentially resets the values of 
object’s location, rotation or scale, while visually keeping 
the object data in-place. The object origin point is moved to 
the global origin, the rotation is cleared and scale values are 
set to 1. 


For simple cases you won't notice any difference the 3D 
Viewport or rendered output, yet modifiers and constraints 
may depend on object transformation. 


Warning 


Armature Objects 


While applying transformations to armatures is supported, 
this does not apply to their pose location, animation 
curves or constraints. This tool should be used before 
rigging and animation. 


When applying transforms to an object that shares Object 
Data between multiple objects, the object must first be 
made a Single User which can be performed by confirming 
the pop-up message. 


When running Apply Transform, the Adjust Last Operation 
panel lets you choose the combination of transformations to 
apply. 


Options 


Location 
Apply (set) the location of the selection. This will make 
Blender consider the current location to be equivalent to 
0 in each plane i.e. the selection will not move, the 
current location will be considered to be the “default 
location”. The object origin will be set to actual (0, 0, 0) 
(where the colored axis lines intersect in each view). 


Rotation 
Apply (set) the rotation of the selection. This will make 
Blender consider the current rotation to be equivalent to 
O degrees in each plane i.e. the selection will not rotated, 
the current rotation will be considered to be the “default 
rotation”. 


Scale 
Apply (set) the scale of the selection. This will make 
Blender consider the current scale to be equivalent to 0 


in each plane i.e. the selection will not scaled, the current 
scale will be considered to be the “default scale”. 


Rotation and Scale 
Apply (set) the rotation and scale of the selection. Do the 
above two applications simultaneously. 


Apply Properties 
Modify properties such as curve vertex radius, font size 
and bone envelope according to the applied 
transformation. (Found in the Adjust Last Operation 
panel) 


Transforms to Deltas 


Reference 

Mode: Object Mode 

Menu: Object » Apply » Location / Rotation / 
Scale to Deltas 

Shortcut: Ctrl-A 


Converts primary object transformations to delta 
transforms, any existing delta transforms will be included as 
well. 


e Location to Deltas 
e Rotation to Deltas 
e Scale to Deltas 


All Transforms to Deltas 
Converts all primary transformations to delta transforms. 


Animated Transform to Deltas 


Converts the primary transformation animations (of the 
translation, scale, and, rotation values) to delta 
transforms. 


Options 


Reset Values 
Clear primary transform values after transferring to 
deltas. 


Visual Transform 


Reference 

Mode: Object Mode 

Menu: Object » Apply » Visual Transform 
Shortcut: Ctrl-A 


Apply (set) the result of a constraint and apply this back to 
the object’s location, rotation and scale. 


Visual Geometry as Mesh 


Reference 

Mode: Object Mode 

Menu: Object >» Apply » Visual Geometry to 
Mesh 

Shortcut: Ctrl-A 


Apply the visual state of all selected objects (modifiers, 
Shape keys, hooks, etc.) to object data. This is a way to 


freeze all object data into static meshes, as well as converts 
non-mesh types to mesh. 


For details, see the Convert mesh. 


Make Instances Real 


Reference 
Mode: Object Mode 
Menu: Object >» Apply >» Make Instances Real 


Make Instances Real creates a new object for each instance 


generated by the selected ones, and removes any direct 
instancing from those. 


In the end, each instance becomes a real object. 
Warning 


This applies to both direct (from verts or faces...) and 
indirect (from particle system...) instancing. In case you 
have tens of thousands of instances (from particles for 
example), this can significantly slow down Blender, which 


does not always deal well with that many objects ina 
scene. 


Options 


By default, new objects will be added to the same collection 
as the one containing their instancer, without keeping any 


hierarchy relationships. This behavior can be altered with 
the following options. 


Parent 


If Keep Hierarchy is not set, parents all the generated 
objects to the former instancer. 


Otherwise, parents all the generated objects which are 
not already parented to their respective instancer, or its 
matching new copy (this is important in case of recursive 
instancing, see the note below). 


Keep Hierarchy 


Preserves internal hierarchies (i.e. parent relationships) 
in the newly generated objects. 


Tip 

Usually, to get a new hierarchy as close as possible from 
the instancing one, you'll want to enable both of these 
options. 

Note 

Preserving relationships in recursive instancing cases 
(instancers instancing other instancer objects, etc.) is only 


Supported to some extent currently. 


Simple cases (like an empty instancing a collection 
containing instances of some other collections) will usually 
work, but more complex cases will fail to fully reproduce 
the whole instancing hierarchy. 


Parent Inverse 


Reference 


Mode: Object Mode 
Menu: Object > Apply > Parent Inverse 


Applies the object’s Parent Inverse transform to the object 
data. 


Snap 


Reference 

Mode: Object, Edit, and Pose Mode 
Menu: Object/Object type > Snap 
Shortcut: Shift-S 


The Snap menu (also available from the 3D header in both 
Object Mode and Edit Mode Object >» Snap and Mesh » 
Snap). This menu provides a number of options to move the 
cursor or your selection to a defined point (the cursor, 
selection or the grid). 


Selection to Grid 
Snaps the currently selected object(s) to the nearest grid 
point. 


Selection to Cursor 
Moves each one of the currently selected object(s) to the 
cursor location. 


Selection to Cursor (Offset) 
Places the selection at the position of the 3D cursor. If 
there are multiple objects selected, they are not moved 
individually at the cursor position; instead, they are 
centered around the 3D cursor, maintaining their relative 
distances. 


Selection to Active 
Moves the selection to the origin of the active object. 


Cursor to Selected 


Places the cursor to the center of the current selection, 
unless see below. 


Cursor to World Origin 
Places the cursor to the origin of the world (location 0, O, 
0). 


Cursor to Grid 
Places the cursor to the nearest grid point. 


Cursor to Active 
Places the cursor to the origin of the active (last 
selected) object. 


The Cursor to Selected option is also affected by the current 
Pivot Point. For example: 


e With the Bounding Box Center pivot point active, the 
Cursor to Selected option will snap the 3D cursor to the 
center of the bounding box surrounding the objects’ 
Origins. 

e When the Median Point pivot point is selected, Cursor to 
Selected will snap the 3D cursor to the median of the 
object origins. 


Duplicate 


Reference 

Mode: Edit and Object Modes 
Menu: Object >» Duplicate Objects 
Shortcut: Shift-D 


This will create a visually-identical copy of the selected 
object(s). The copy is created at the same position as the 
original object and you are automatically placed in move 
mode. See the examples below. 


This copy is a new object, which shares data-blocks with the 
original object (by default, all the materials, textures, and F- 
Curves), but which has copied others, like the mesh, for 
example. That is why this form of duplication is sometimes 
called “shallow link”, because not all data-blocks are shared; 
some of them are “hard copied”! 


Tip 


You can choose which types of data-block will be linked or 
copied when duplicating in the Preferences. 


Examples 


The Cube object was duplicated. 


The object Cube was duplicated, using Shift-D. Both these 
cubes have separate meshes with unique names: Cube and 
Cube. 001. 


e The original left cube is being edited, the duplicated 

right cube remains unchanged. The mesh data has been 

copied, not linked. 

Likewise, if one cube is edited in Object Mode, the other 

cube remains unchanged. The new object’s transform 

properties or data-block is a copy, not linked. 

e When the cube was duplicated, it inherited the material 
of the original cube. The material properties were linked, 
not copied. 


See above if you want separate copies of the data-blocks 
normally linked. 


Duplicate Linked 


Reference 

Mode: Object Mode 

Menu: Object » Duplicate Linked 
Shortcut: Alt-D 


You also have the choice of creating a Linked Duplicate 
rather than a Duplicate; this is called a deep link. This will 
create a new object with all of its data linked to the original 
object. If you modify one of the linked objects in Edit Mode, 
all linked copies are modified. Transform properties (object 
data-blocks) still remain copies, not links, so you still can 
rotate, scale, and move freely without affecting the other 
copies. Reference the Examples for the discussions below. 


If the original object was animated, the duplicate will link to 
the same Action. This means that, even though each object 
has separate transform properties, they will be set to the 
Same values by the animation system. If this is not desired, 
make the action a single-user copy in the Action or NLA 
Editor. 


Linked 
In the Duplicate Objects Adjust Last Operation panel the 
Linked checkbox is checked unlike with Duplicate. 


Hint 
If you want to make changes to an object in the new linked 


duplicate independently of the original object, you will 
have to manually make the object a “single-user” copy by 


LMB the number in the Object Data panel of the Properties. 
(See Data-Block Menu.) 


See also 


Make Single User for unlinking data-blocks. 


Examples 


The Cube object was linked duplicated. 


The object Cube was linked duplicated, using Alt-D. Though 

both these cubes are separate objects with unique names: 
Cube and Cube.001, the single mesh named Cube, is shared by 
both. 


e AS a mesh is edited in Edit Mode in one object, the same 
occurs in the other cube as well. The mesh data are 
links, not copies. 

e In contrast, if one of these two cubes is rotated or 
scaled in Object Mode, the other remains unchanged. 
The transform properties are copied, not linked. 


e As in the previous example, the newly created cube has 
inherited the material of the original cube. The material 
properties are linked, not copied. 


A common table has a top and four legs. Model one leg, and 
then make linked duplicates three times for each of the 
remaining legs. If you later make a change to the mesh, all 
the legs will still match. Linked duplicates also apply to a set 
of drinking glasses, wheels on a car... anywhere there is 
repetition or symmetry. 


See also 
Linked Library Duplication 
Linked Libraries are also a form of duplication. Any object 


or data-block in other blend-files can be reused in the 
current file. 


Hint 


If you want transform properties (i.e. object data-blocks) to 
be “linked”, see the page on parenting. 


Join 


Reference 

Mode: Object Mode 
Menu: Object > Join 
Shortcut: Ctrl-J 


Join merges all selected objects into the last selected Active 
object. All object data is linked to the active object (which 
must be selected). All objects must be of the same type: 
mesh, curve, surface or armature. If several curves are 
joined, each one will keep its subtype (NURBS or Bézier). 


Note 


Object data has many attributes which may be handled 
when joining. 


Materials, vertex groups, UV and Vertex layers will be 
merged. 


Modifiers, constraints, groups and parent relationships are 
ignored when joining and will not be applied to the active 
object. 


Asset 


Operations for managing the Asset status of an object. 


Mark as Asset 


See Creating_an Asset. 


Clear Asset 


See Removing Assets. 


Clear Asset (Set Fake User) 


See Removing Assets. 


Parenting Objects 


When modeling a complex object, such as a watch, you may 
choose to model the different parts as separate objects. To 
make all the parts move as one (“the watch”), you can 
designate one object as the parent of all the other parts. 
These other parts become its children, and any translation, 
rotation, or scale of the parent will also affects its children. 


Contrary to most biological lifeforms, each object or bone in 
Blender has at most one parent. If an object already has a 
parent object and you give it another parent then Blender 
will remove the previous parent relationship. When the plural 
“parents” is used in this chapter, it references the hierarchy 
of parents, so the parent, the grandparent, great 
grandparent, and so on, of an object. 


Make Parent 


Reference 

Mode: Object Mode 
Menu: Object > Parent 
Shortcut: Ctrl-P 


To parent objects, select at least two objects (select the child 
objects first, and select the parent object last), and press 
Ctri-P. The Set Parent To menu will pop up allowing you to 
select from one of several possible different parenting types. 
Selecting one of the entries in Set Parent To confirms, and 
the child/children to parent relationship is created. The 
selected objects will have their ‘parent’ set to the active 
object, and as a result will be ‘siblings’. 


The Set Parent To pop-up menu is context-sensitive, which 
means the number of entries it displays can change 
depending on what objects are selected when the ctrl-P 
shortcut is used. 


Moving, rotating or scaling the parent will also usually 
transform the child/children. Yet transforming the 
child/children of the parent will not affect the parent. In other 
words, the direction of influence is from parent to child and 
not child to parent. 


Tip 


You can “move” a child object back to its parent by clearing 
its Origin. 


Type 
Blender supports many different types of parenting, listed 
below. Besides parenting the selected objects, some types 
add a Modifier or Constraint to the child objects, with the 
parent as the target object or activates a parent property 
i.e. Follow Path. 


Object 
Armature Deform 
e Bone 
e Curve Deform 
e Follow Path 
e Path Constraint 
e Lattice Deform 
e Vertex 
e Vertex (Triangle) 
Keep Transform 
The object’s current world transform (so its absolute 
location, rotation and scale in the world) is computed. The 


new parent is set, and then the Parent Inverse matrix is 
computed such that after setting the new parent the 
object is still at its previous world transform. 


Hint 
Use the Outliner 


There is another way to see the parent-child relationship in 
groups and that is to use the Outliner view of the Outliner 


editor. 


Parent Inverse 


Blender can assign a parent without moving the child object. 
This is achieved via a hidden matrix called the Parent Inverse 
matrix, which sits between the transform of the parent and 


the child. 


When objects are parented with ctri-P, Parent Inverse matrix 
is updated. Depending on the choice in the Set Parent menu, 
the object’s local location, rotation, and scale are also 
updated. For more details, see Object Parent. 


The Parent Inverse matrix can be cleared by using Clear 
Parent Inverse. 


Note 


When setting the parent via the Object Properties panel, 
the Parent Inverse matrix is always reset. This can cause an 
unexpected jump in the object’s position. To avoid this, use 
Ctri-P to set the new parent. 


Object Parent 


Object Parent is the most general form of parenting that 
Blender supports. It will take selected objects and make the 
active object the parent object of all the selected objects. 
Each child object will inherit the transformations of the 
parent. The parent object can be of any type. 


If the object has a pre-existing parent, that is cleared first. 
This moves the object to its own location, rotation and scale, 
without its parent’s influence. 


There are three operators that allow you to set an object 
parent. They differ in the way they compute the Parent 
Inverse matrix and the local Transform of the object. 


Example: Object Parent (Keep Transform) 


Object Parent with Keep Transform will keep any previous 
transformations applied to them from the previous parent 
object. 


Assume that we have a scene consisting of three objects, 
those being two empty objects named “EmptyA” and 
“EmptyB”, and a Monkey object. Fig. Scene with no 
parenting. shows the three objects with no parenting 
relationships active on them. 


Scene with no parenting. 


If you select the Monkey object by LmsB click and then Shift-LMB 
click “EmptyA” object and press ctri-P and finally select 
Object from the Set Parent To pop-up menu. This will result in 
“EmptyA” object being the parent object of the Monkey 
object. With only “EmptyA” selected rotating/scaling/moving 
it will result in the Monkey object being altered respectively. 


Scale the “EmptyA” object, so that the Monkey becomes 
smaller and moves to the left a little. 


The monkey is the child object of “EmptyA”. 


If you select only the Monkey object by Lms click and then 
Shift-LMB click “EmptyB” object and press ctrl-P and select 
Object from the Set Parent To pop-up menu. This will result in 
“EmptyB” object being the parent object of the Monkey 


object. Notice that when you change the parent of the 
Monkey the scale of the Monkey changed. 
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The monkey is the child object of “EmptyB”. 


This happens because the Monkey object never had its scale 
altered directly, the change came about because it was the 
child of “EmptyA” which had its scale altered. Changing the 
Monkey’s parent to “EmptyB” resulted in those indirect 
changes in scale being removed, because “EmptyB” has not 
had its scale altered. 


This is often the required behavior, but it is also sometimes 
useful that if you change your parent object that the child 
object keep any previous transformations it got from the old 
parent object; If instead when changing the parent object of 
the Monkey from “EmptyA” to “EmptyB” we had chosen 
parenting type Object and enable Keep Transform, the 
Monkey would keep its scale information it obtained from the 
old parent “EmptyA” when it is assigned to the new parent 
“EmptyB”. 


The Object parent with Keep Transform. 


If you want to follow along with the above description here is 
the blend-file: 
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Bone Parent 


Bone parenting allows you to make a certain bone in an 
armature the parent object of another object. This means 
that when transforming an armature the child object will only 
move if the specific bone is the child object of moves. 


Three pictures of armatures with four bones. 


In Fig. Three pictures of armatures with four bones. with the 
2nd bone being the bone parent of the child object cube. The 


cube Is only transformed if the 1st or 2nd bones are. Notice 
altering the 3rd and 4th bones has no effect on the cube. 


To use bone parenting, you must first select all the child 
objects you wish to parent to a specific armature bone, then 
Shift-LMB select the armature object and switch it into Pose 
Mode and then select the specific bone you wish to be the 
parent bone by LB selecting it. Once done press Ctrl-P and 
select bone from the Set Parent To pop-up menu. 


Now transforming that bone in Pose Mode will result in the 
child objects also transforming. 


Relative Parenting 


Bone relative parenting is an option you can toggle for each 
bone. This works in the same way as bone parenting with 
one difference. 


With bone parenting if you have parented a bone to some 
child objects and you select that bone and switch it into Edit 
Mode and then move that bone; When you switch back into 
Pose Mode on that bone, the child object which is parented 
to that bone will snap back to the location of the bone in 
Pose Mode. 


Single armature bone which has a child object cube 
parented to it using bone parenting. 


In Fig. Single armature bone which has a child object cube 
parented to it using bone parenting. the 1st picture shows 
the position of the cube and armature before the bone is 
moved in Edit Mode. 2nd picture shows the position of the 
cube and armature after the bone was selected in Edit Mode, 
moved and switched back into Pose Mode. Notice that the 
child object moves to the new location of the pose bone. 


Bone relative parenting works differently; If you move a 
parent bone in Edit Mode, when you switch back to Pose 
Mode, the child objects will not move to the new location of 
the Pose Bone. 


Single bone with bone relative parent to a cube. 


In Fig. Single bone with bone relative parent to a cube. the 
lst picture shows the position of the cube and armature 
before the bone is moved in Edit Mode. 2nd picture shows 
the position of the cube and armature after the bone was 
selected in Edit Mode, moved and switched back into Pose 
Mode. Notice that the child object does not move to the new 
location of the pose bone. 


Note 


When using ctri-P to set parents, choosing “Bone” or “Bone 
Relative” will respectively clear and set the bone’s “Relative 
Parenting” option. Since “Relative Parenting” is an option 
that is set per bone, this influences all child objects of that 
bone at once. 


Vertex Parent 


For objects of type curve, surface, mesh and lattice, there is 
the possibility to use one of its vertices or points as the 
parent of other objects. You can parent an object to a single 
vertex or a group of three vertices as well; that way the 
child/children will move when the parent mesh is deformed. 


Vertex Parent from Edit Mode 


In Object Mode, select the child/children and then the parent 
object. Tab into Edit Mode and on the parent object select 
either one vertex that defines a single point, or select three 
vertices that define an area (the three vertices do not have 
to form a complete face; they can be any three vertices of 
the parent object), and then press Ctri-P and confirm. 


At this point, if a single vertex was selected, a 
relationship/parenting line will be drawn from the vertex to 
the child/children. If three vertices were selected then a 
relationship/parenting line is drawn from the averaged center 
of the three points (of the parent object) to the child/children. 
Now, as the parent mesh deforms and the chosen parent 
vertex/vertices move, the child/children will move as well. 


Vertex Parent from Object Mode 


Vertex parenting can be performed from Object Mode, this is 
done like regular object parenting, press Ctri-P in Object 
Mode and select Vertex or Vertex (Triangle). 


The nearest vertices will be used from each object which is 
typically what you would want. 


Vertex Parent example. 


The small 

cubes can Reshaping Scaling 
each be the object the 
automatically in Edit parent 
parented toa Mode then icosphere 
triad of means in Object 
nearby each of Mode 
vertices on the cubes means 
the icosphere follows the child 
using the their cubes are 
“Vertex vertex also 
(Triangle)” in parent scaled as 
the set separately. expected. 
parent 

context 


menu. 


The parent context menu item means users can rapidly set 
up a large number of vertex parent relationships, and avoid 
the tedious effort of establishing each parent-child vertex 
relationship separately. 

Note 


It is in fact a sort of “reversed” hook. 


Make Parent without Inverse 


Reference 
Mode: Object Mode 
Menu: Object » Parent » Make Parent without 


Inverse 


This sets the parent, and then resets the Parent Inverse 
matrix and the object’s local location. As a result, the object 


will move to the location of the parent, but keep its rotation 
and scale. 


Keep Transform 
The object’s current world transform (so its absolute 
location, rotation and scale in the world) is computed. The 
new parent is set, and then the Parent Inverse matrix is 
computed such that after setting the new parent the 
object is still at its previous world transform. 


Clear Parent 


Reference 


Mode: Object Mode 
Menu: Object > Parent 
Shortcut: Alt-P 


You can remove a parent-child relationship via Alt-P. 


Clear Parent 
If the parent in the group is selected, nothing is done. If a 
child or children are selected, they are disassociated from 
the parent, or freed, and they return to their original 
location, rotation, and size. 


Clear and Keep Transformation 
Frees the children from the parent, and keeps the 
location, rotation, and size given to them by the parent. 


See Non-Uniform Scale which may apply here. 


Clear Parent Inverse 
Instead of removing the hierarchical parent-child 
relationship, this clears the Parent Inverse matrix from the 
selected objects. With an empty matrix, the location, 
rotation and scale properties of the children are 
interpreted in the coordinate space of the parent. 


Known Limitations 


Non-Uniform Scale 


A parent with non-uniform scale and rotation in relation to its 
child may cause a shear effect. 


While this is supported by parenting, the shear will be lost 
when the parent is cleared since it can’t be represented by 
location, scale and rotation. 


If Clear and Keep Transformation moves the object, non- 
uniform scale is the most likely cause. 


Relations 


e Make Single User 


Make Single User 


Reference 
Mode: Object Mode 
Menu: Object > Relations » Make Single User 


Makes the selected or all object data-blocks single users, 
that is, not shared (linked) between other objects in the 
blend-file. 


Additionally, it can also make single-user copies of its 
dependencies, like meshes, curves, materials, animations... 


Type 
These actions work on the selected objects, or on all the 
objects of the scene. 


All, Selected Objects 


Data-blocks 
Lets you, in addition to the menu predefined selection, 
choose the type of data-blocks individually. 


Object: Make single user objects. 

Object Data: Make single user object data. 

Materials: Make materials local to each data- 
block. 


Object Animation: 
Make the animation of Object 
Properties data local to each object. 
Object Data Animation: 
Make object data (mesh, curve etc.) 
animation data local to each object. 


See also 


Making Single User 


Link/Transfer Data 


Reference 

Mode: Object Mode 

Menu: Object > Link/Transfer Data 
Shortcut: Ctri-L 


Link Objects to Scene 
Link Data 
Link Object Data 
Link Materials 
Link Animation Data 
Link Collections 
Link Instance Collection 
Link Fonts to Text 
Copy Modifiers 
Copy Grease Pencil Effects 
Copy UV Maps 
Transfer Mesh Data 

o Vertex Mapping 

o Further Options 
Transfer Mesh Data Layout 
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Link Objects to Scene 


Reference 
Mode: Object Mode 
Menu: Object > Link/Transfer Data » Link 


Objects to Scene 


Links the selected objects into a different scene than the 
current one. The Link Objects to Scene in the Adjust Last 
Operation panel lets you choose between scenes. 


This makes the same object exist in more than one scene at 
once, including its position and animation data. The object’s 
origin will change its color to reflect that. 


Link Data 


Reference 
Mode: Object Mode 
Menu: Object > Link/Transfer Data... 


Links objects between scenes or data-blocks of the active 
object to all selected objects. In some case (i.e. Object Data, 
Modifier) the target objects must be of the same type as the 
active one or capable of receiving the data. If targets 
already have data linked to them, it will be unlinked first. 


Type 
Data-block type to link. 


Link Object Data 

Link Materials 

Link Animation Data 

Link Collections 

Link Instance Collection 
Link Fonts to Text 

Copy Modifiers 

Copy Grease Pencil Effects 


See also 


Making Single User for unlinking data-blocks. 


Link Object Data 


Replace assigned Object Data. 


Link Materials 


Replace assigned Materials. 


Link Animation Data 


Replace assigned Animation Data. 


Link Collections 


Replace assigned Collections. 


Link Instance Collection 


Replace assigned Collection Instance. 


Link Fonts to Text 


Replace Text object Fonts. 


Copy Modifiers 


Replace Modifiers. 


Copy Grease Pencil Effects 


Replace Grease Pencil Effects. 


Copy UV Maps 


Reference 
Mode: Object Mode 
Menu: Object > Link/Transfer Data » Copy UV 


Maps 


The active UV map of the selected objects will be replaced 
by a copy of the active UV map of the active object. If the 
selected object doesn’t have any UV maps, it is created. 
Objects must be of type mesh and must have a matching 
topology. 


Transfer Mesh Data 


Reference 
Mode: Object Mode 
Menu: Object > Link/Transfer Data > Transfer 


Mesh Data 


The Data Transfer tool transfers several types of data from 
one mesh to another. Data types include vertex groups, UV 
maps, Color Attributes, custom normals... Transfer works by 
generating a mapping between source mesh’s elements 
(vertices, edges, etc.) and destination ones, either on a one- 
to-one basis, or mapping several source elements to a 
single destination one by interpolated mapping. 


Transfers data layer(s) from active to selected meshes. 


Freeze Operator 


Prevent changes to settings to re-run the operator. This is 
useful if you are editing several settings at once with 
heavy geometry. 


Data Type 
Which data to transfer. 


x Dat jae Dat mer Dat F t 


Vertex Group(s) Sharp Custom Normals Smooth 


Bevel Weight UV Seam VCol Freestyle Mark 


Subsurf Crease UVs 
Bevel Weight 


Freestyle Mark 


Data types. 


Create Data 
Add data layers on destination meshes if needed. 


Vertex Mapping 
Method used to map source vertices to destination ones. 
Because the options change depending on the Data Type 
options are explained in Vertex Mapping below. 


Vertex Mapping 


Topology 


The simplest option, expects both meshes to have identical 
number of elements, and match them by order (indices). 
Useful e.g. between meshes that were identical copies, and 
got deformed differently. 


One-To-One Mappings 


Those always select only one source element for each 
destination one, often based on shortest distance. 


Vertices 
Nearest Vertex 


Uses source’s nearest vertex. 


Nearest Edge Vertex 
Uses source’s nearest vertex of source’s nearest edge. 


Nearest Face Vertex 
Uses source’s nearest vertex of source’s nearest face. 


Edges 
Nearest Vertices 
Uses source’s edge which vertices are nearest from 
destination edge’s vertices. 


Nearest Edge 
Uses source’s nearest edge (using edge’s midpoints). 


Nearest Face Edge 
Uses source’s nearest edge of source’s nearest face 
(using edge’s midpoints). 


Face Corners 
A face corner is not a real element by itself, it’s some 
kind of split vertex attached to a specific face. Hence 
both vertex (location) and face (normal, ...) aspects are 
used to match them together. 


Nearest Corner and Best Matching Normal 
Uses source’s corner having the most similar split 
normal with destination one, from those sharing the 
nearest source’s vertex. 


Nearest Corner and Best Matching Face Normal 
Uses source’s corner having the most similar face 
normal with destination one, from those sharing the 
nearest source’s vertex. 


Nearest Corner of Nearest Face 


Uses source’s nearest corner of source’s nearest face. 


Faces 


Nearest Face 
Uses source’s nearest face. 


Best Normal-Matching: 
Uses source’s face which normal is most similar with 
destination one. 


Interpolated Mappings 


Those use several source elements for each destination one, 
interpolating their data during the transfer. 


Vertices 
Nearest Edge Interpolated 
Uses nearest point on nearest source’s edge, 
interpolates data from both source edge’s vertices. 


Nearest Face Interpolated 
Uses nearest point on nearest source’s face, 
interpolates data from all that source face’s vertices. 


Projected Face Interpolated 
Uses point of face on source hit by projection of 
destination vertex along its own normal, interpolates 
data from all that source face’s vertices. 


Edges 
Projected Edge Interpolated 
This is a Sampling process. Several rays are cast from 
along the destination’s edge (interpolating both 
edge’s vertex normals), and if enough of them hit a 
source’s edge, all hit source edges’ data are 
interpolated into destination one. 


Face Corners 


A face corner is not a real element by itself, it’s some 
kind of split vertex attached to a specific face. Hence 
both vertex (location) and face (normal, ...) aspects are 
used to match them together. 


Nearest Face Interpolated 
Uses nearest point of nearest source’s face, 
interpolates data from all that source face’s corners. 


Projected Face Interpolated 
Uses point of face on source hit by projection of 
destination corner along its own normal, interpolates 
data from all that source face’s corners. 


Faces 
Projected Face Interpolated 
This is a Sampling process. Several rays are cast from 
the whole destination’s face (along its own normal), 
and if enough of them hit a source’s face, all hit 
source faces’ data are interpolated into destination 
one. 


Further Options 


Auto Transform 


Automatically computes the transformation to get the 
best possible match between source and destination 
meshes. 


This allows to match and transfer data between two 

meshes with similar shape, but transformed differently. 
Note that you'll get best results with exact copies of the 
Same mesh. Otherwise, you'll likely get better results if 


you “visually” make them match in 3D space (and use 
Object Transform) instead. 


Object Transform 
Evaluate source and destination meshes in global space. 


Only Neighbor Geometry 
Source elements must be closer than given distance from 
destination one. 


Max Distance 
Maximum allowed distance between source and 
destination element (for non-topology mappings). 


Ray Radius 
The starting ray radius to use when Ray Casting against 
vertices or edges. When transferring data between 
meshes Blender performs a series of ray casts to 
generate mappings. Blender starts with a ray with the 
radius defined here, if that does not detect a hit then the 
radius is progressively increased until a positive hit ora 
limit is reached. 


This property acts as an accuracy/performance control; 
using a lower ray radius will be more accurate however, 
might take longer if Blender has to progressively increase 
the limit. Lower values will work better for dense meshes 
with lots of detail while larger values are probably better 
suited for simple meshes. 


Mix Mode 
How to affect destination elements with source values. 


All 
Replaces everything in destination (note that Mix 
Factor is still used). 


Above Threshold 
Only replaces destination value if it is above given 
threshold Mix Factor. How that threshold is interpreted 
depends on data type, note that for Boolean values 
this option fakes a logical AND. 


Below Threshold 
Only replaces destination value if it is below given 
threshold Mix Factor. How that threshold is interpreted 
depends on data type, note that for Boolean values 
this option fakes a logical OR. 


Mix, Add, Subtract, Multiply 
Apply that operation, using mix factor to control how 
much of source or destination value to use. Only 
available for a few types (vertex groups, Color 
Attributes). 


Mix Factor 
How much of the transferred data gets mixed into 
existing one (not supported by all data types). 


Transfer Mesh Data Layout 


Reference 
Mode: Object Mode 
Menu: Object > Link/Transfer Data >» Transfer 


Mesh Data Layout 


Transfers layout of data layer(s) from active to selected 
meshes. 


Data Type 
Which data to transfer. 


ertex Dat Edge Dat Fact mer Dat Face Dat 


Vertex Group(s) Sharp Custom Normals Smooth 


Bevel Weight UV Seam VCol Freestyle Mark 


Subsurf Crease UVs 
Bevel Weight 


Freestyle Mark 


Data types. 


Exact Match 


Also Delete some data layers from destination if 
necessary, so that it matches the source exactly. 


Source Layers Selection 
Which layers to transfer, in case of multi-layer types. 


Active Layer 
Only transfer the active data layer. 


All Layers 
Transfer all data layers. 


Destination Layers Matching 
How to match source and destination layers. 


By Name 
Match target data layers to affect by name. 


By Order 
Match target data layers to affect by order (indices). 


See also 


Data Transfer Modifier 


Shading 
Shade Smooth 


Reference 
Mode: Object Mode 
Menu: Object » Shade Smooth 


The easiest way is to set an entire object as smooth or 
faceted by selecting a mesh object, and in Object Mode, 
select Shade Smooth in the Object menu. This forces the 
assignment of the “smoothing” attribute to each face in the 
mesh, including when you add or delete geometry. 


Notice that the outline of the object is still strongly faceted. 
Activating the smoothing features does not actually modify 
the object’s geometry; it changes the way the shading is 
calculated across the surfaces (normals will be 
interpolated), giving the illusion of a smooth surface. 


Select the Shade Flat item in the Object menu to revert the 
Shading back (normals will be constant) to that shown in the 
first image below. 


Example mesh flat (left) and smooth-shaded (right). 
Sample blend-file. 


Shade Auto Smooth 


Reference 
Mode: Object Mode 
Menu: Object » Shade Smooth 


Automatically applies smooth shading to faces with a 
defined shallow angle and all other faces are sharp. This 
method works great for objects with both sharp and smooth 
areas. 


Selecting the Shade Flat will revert the shading back to flat; 
additionally, pressing Shade Smooth will disable all flat 
normals, making the entire object appear smooth again. 


When this operator is used it enables the Auto Smooth 
property. See Advanced Smooth Shading_& Sharp Edges for 
more details. 


Shade Flat 


Reference 


Mode: Object Mode 
Menu: Object > Shade Flat 


As seen in the previous sections, polygons are central to 
Blender. Most objects are represented by polygons and truly 
curved objects are often approximated by polygon meshes. 
When rendering images, you may notice that these 
polygons appear as a series of small, flat faces. Sometimes 
this is a desirable effect for hard surfaces, but for organic 
surfaces you usually want your objects to look smooth. 


Rigid Body 


Calculate Mass 


Reference 

Editor: 3D Viewport 

Mode: Object Mode 

Menu: Object >» Rigid Body > Calculate Mass 


Calculate mass values for rigid body objects based on their 
volume and density. The volume is calculated automatically, 
the density needs to be given based on the object you want 
to simulate. 


Material Preset 
A list of preset density values for real-world materials, if a 
material is not given you can research the density and 
use the Custom preset to input the density manually. 


Density 
When the Custom Material Preset is selected, this is the 
input density, in kg/m3, to use. 


Convert 


Curve 

Reference 

Mode: Object Mode 

Menu: Object >» Convert >» Curve 


Converts the selected mesh, or text object to a curve object. 
For mesh objects, only edges belonging to no faces will be 
taken into account. The resulting curve will be a poly curve 
type, but can be converted to have smooth segments as 
described in Set Spline Type. 


Mesh 


Reference 
Mode: Object Mode 
Menu: Object >» Convert >» Mesh 


Converts the selected curve, metaball, surface, or text 
object to a mesh object. The actual defined resolution of 
these objects will be taken into account for the conversion. 
Note that it also keeps the faces and volumes created by 
closed and extruded curves. 


Grease Pencil 


Reference 


Mode: Object Mode 
Menu: Object >» Convert » Grease Pencil 


Converts the selected curve, mesh or text object to a 
Grease Pencil object with strokes matching the curve, mesh, 
or text; basic materials are also added. When multiple 
curves, meshes, or texts are selected, they are all converted 
into the same Grease Pencil object. 


Options 


Keep Original 
Duplicates the original object before converting it. 


Thickness 
Strokes thickness. 


Threshold Angle 
Threshold value that determines the strokes end. 


Stroke Offset 
Sets offset to separate strokes from filled strokes. 


Only Seam Edges 
Convert only edges marked as seam. 


Export Faces 
Convert faces as filled strokes. 


Trace Image to Grease Pencil 


Reference 


Mode: Object Mode 
Menu: Object >» Convert > Trace Image to 
Grease Pencil 


See Trace Image to Grease Pencil. 


Show/Hide 


Reference 


Mode: All Modes 
Menu: Object » Show/Hide 


Show Hidden Objects Alt-H 
Reveals all hidden objects. 


Hide Selected H 
Hides all selected objects. 


Hide Unselected Shift-H 
Hides all unselected objects of the scene. 


Clean Up 
Clean Vertex Group Weights 


Reference 
Mode: Object Mode 
Menu: Object >» Clean Up » Clean Vertex Group 


Weights 


Clean Vertex Group Weights unassigns vertices from Vertex 
Groups whose weights are below the Limit. Removes 
weights below a given threshold. This tool is useful for 
clearing your weight groups of very low (or zero) weights. 


In the example shown, a cutoff value of 0.2 is used (see 
operator options below) so all blue parts are cleaned out. 


Note, the images use the Show Zero weights Active option 
so that unreferenced Weights are shown in Black. 


Clean example. 


Subset 
Restrict the tool to a subset. See above The Subset 
Option for how subsets are defined. 


Limit 
This is the minimum weight value that will be kept in the 
group. Weights below this value will be removed from the 
group. 


Keep Single 
Ensure that the Clean Vertex Group Weights tool will not 
create completely unreferenced vertices (which are 
vertices that are not assigned to any vertex group), so 
each vertex will keep at least one weight, even if it is 
below the limit value! 


Limit Total Vertex Groups 


Reference 
Mode: Object Mode 
Menu: Object >» Clean Up » Limit Total Vertex 


Groups 


Reduce the number of weight groups per vertex to the 
specified Limit. The tool removes lowest weights first until 
the limit is reached. 


Hint 


The tool can only work reasonably when more than one 
weight group is selected. 


Subset 


Restrict the tool to a subset. See above The Subset 
Option for how subsets are defined. 


Limit 
Maximum number of weights allowed on each vertex. 


Remove Unused Material Slots 


Reference 

Mode: Object Mode 

Menu: Object » Clean Up » Remove Unused 
Material Slots 


Removes unused material slots. 


Delete 


Reference 

Mode: Object Mode 
Menu: Object > Delete 
Shortcut: X Or Delete 


Delete the selected objects from the current scene. 


Delete Globally 


Reference 

Mode: Object Mode 

Menu: Object >» Delete Globally 
Shortcut: 


Shift-X Or Shift-Delete 


Delete the selected objects from all scenes, and any other 
possible usages (like e.g. from a shading node). 
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Transform 


Reference 

Mode: Object Mode 

Panel: Properties >» Object Properties > 
Transform 

Panel: 3D Viewport >» Sidebar >» Transform 


The Transform panel in the Sidebar region allows you to 
view and manually/numerically control the position, rotation, 
and other properties of an object, in Object Mode. Each 
object stores its position, orientation, and scale values. 
These may need to be manipulated numerically, reset, or 
applied. In Edit Mode. It mainly allows you to enter precise 
coordinates for a vertex, or median position for a group of 
vertices (including an edge/face). As each type of object has 
a different set of options in its Transform panel in Edit Mode, 
see their respective descriptions in the Modeling chapter. 


Use this panel to either edit or display the object’s 
transform properties such as position, rotation and/or 
scaling. These fields change the object’s origin and then 
affect the aspect of all its vertices and faces. 


¥ Transform 


Location 


XYZ Euler 


Scale 


Transform Properties. 


Location 
The object’s origin location in local coordinates. 


Rotation 


The object’s local orientation, relative to the global axes 
and its own origin. 


Rotation Mode 


Method for calculating rotations, additional information 
can be found in the manual’s appendix. 


Euler: The gizmo handles are aligned to the 
Euler axis, allowing you to see the 
discreet XYZ axis underlying the Euler 


rotation, as well as possible Gimbal 
Lock. 


Axis Angle: The X, Y, and Z coordinates define a 
point relative to the object origin. This 
point and the origin define an axis 
around the W value defines the 
rotation. 

Quaternion: X, Y, Z and W correspond to the 
Quaternion components. 


Scale 
The object’s relative scale along the local axis (e.g. the 
Scale X value represents the scale along the local X axis). 
Each object (cube, sphere, etc.), when created, has a 
scale of one unit in each local direction. To make the 
object bigger or smaller, you scale it in the desired axis. 


Dimensions 
The size of the object’s bounding box (aligned with the 
local axes - think of a cardboard box just big enough to 
hold the object). 


Transform Properties Locking 
When the toggle is locked, the corresponding 
transformation value can not be changed in any 
interactive operation. But the value can still be changed 
using non-interactive operations, like editing the 
corresponding number field or using Python. 


For example, if you locked the Location X property then 
you cannot use the 3D gizmo to move the object along 
the global X axis. But you can still move it using the 
Location X number field. Consider the locking feature as 
a rigid constraint only changeable from the panel. 


To lock a property, click the padlock icon next to the 
button. The button is unlocked if the icon shows an open 


padlock, and it is locked if the icon appears as a closed 
padlock. 


Delta Transforms 


Reference 
Mode: Object Mode 
Panel: Properties » Object Properties > 


Transform > Delta Transforms 


Delta Transforms are simply transformations that are 
applied on top of the transforms described above. Delta 
Transforms are particularly useful in animations. For 
example, you can animate an object with the primary 
transforms then move them around with Delta Transforms. 


Relations 


Reference 

Mode: Object Mode 

Panel: Properties >» Object Properties > 
Relations 

Parent 


The object to which the selected object is parented to. 


Parent Type 


The type of parenting used. See parenting for information 
on the different types. 


Camera Parent Lock 
When the camera is locked to the view, the root parent is 
transformed rather than the camera. This is useful for 
camera rigs where you don’t want to animate the camera 
directly. 


Tracking Axis 
Axis that points in the “forward” direction. Applies to 
Instance Vertices when Align to Vertex Normal is 
enabled. 


Up Axis 
Axis that points in the “upward” direction. Applies to 
Instance Vertices when Align to Vertex Normal is 
enabled. 


Pass Index 


Defines the index the object will have in the Object Index 
render pass. See passes and !D mask for more 


information. 


Note 
Volume Objects are not supported. 
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Introduction 


In Blender, objects are not directly part of the scenes. 
Instead, they all get stored in a main database (basically the 
blend-file). 


(s] Main Database 


The blend-file and its stored data. 


From there they are referenced into as many Scenes as you 
would like to see them. 


When they are stored in a scene, they are part of a so-called 
scene collection. So ultimately all the scene objects belong 
to this special collection. 


‘= Scene Collection 


The scene collection. 


Collections 


While the scene collection contains all the Scene’s objects, 
the user can also make their own collections to better 
organize these objects. 


It works like a Venn diagram, where all the objects are part 
of the scene collection, but can also be part of multiple 
collections. 


Collections Object belongs to: 


Scene Collection 


G @ Scene Collection 


Sp © Scene Collection 
“> Collection 1 


“> Collection 2 
® Collection 3 


® Scene Collection 
©) Collection 2 
® Collection 3 


@ ® Scene Collection 
® Collection 3 


Venn diagram. 


The result is a clear and flexible way to arrange objects 
together on the Scene level. 


Scene Collection 


‘= Collection 1 


SS 


‘m= Collection 2 


Scene organization. 


Naming and Nesting 
Collections can be named and sorted hierarchically. Just like 
folders can have subfolders in any operating system, 


collections can have nested collections too. 


‘= House 


‘= Bedroom 


Nested collections. 


For example: a house collection can contain a bedroom 
collection, which in turn contains a furniture collection 
referencing a bed, a cabinet and other objects. 


Color Tagging 


Collections can have a color group assigned to them; 
helping organize and group different collections. This color 
tag is displayed as part of the collection icon in the Outliner 
and various other menus. The available colors are defined 
by Blender’s interface Theme. 


To assign a color to a collection, use the Set Color Tag tool in 
the Outliner. 


Collections 


There can be many objects in a scene: A typical stage scene 
consists of furniture, props, lights, and backdrops. Blender 
helps you keep everything organized by allowing you to 
group like objects together. Objects can be grouped 
together without any kind of transformation relationship 
(unlike parenting). Collections are used to just logically 
organize your scene, or to facilitate one-step appending or 
linking between files or across scenes. 


Collections Tab 
Reference 


Menu: Properties >» Collection Properties 


Collection properties tab allows convenient access to 
properties for the active collection. 


=] Collection 


¥ Restrictions 


¥ Selectable 
Disable in Renders 
Holdout 


Indirect Only 
¥ Instancing 


Instance Offset X 


¥ Line Art 


Usage 


Collection properties. 


Restrictions 


Selectable 
Toggles the ability to select the objects from the 3D 
Viewport. This is useful for if you have placed something 
in the scene and do not want to accidentally select it 
when working on something else. 


Disable in Renders 
Enables/disables visibility of the collection in renders. 


Holdout 
Objects inside this collection will generate a 
holdout/mask in the active view layer. 


Indirect Only 
Objects inside this collection will only contribute to the 
final image indirectly through shadows and reflections. 


Instancing 


Instance Offset X, Y Z 
Applies a spatial offset of the instanced collections from 
the original object’s origin. 


Line Art 


Usage 
How the collection is loaded into line art. Child objects of 
the collection can override this setting if they wish in 
Object Properties. 


Include: Generate feature lines for this 
collection. 
Occlusion Only: 
Objects in the collection will only cause 
occlusion to existing feature lines and 
their geometry stay invisible. 
Exclude: Objects in this collection will not be 
loaded into line art at all. 
Intersection Only: 
Objects in the collection will only 
produce intersection lines in the scene 
and their own geometry stay invisible. 
No Intersection: 
Include this collection but do not 
generate intersection lines. 
Force Intersection: 
Generate intersection lines even with 
objects that disabled intersection. 


Collection Mask 
Use custom intersection mask for faces in this collection. 
Intersection masks can be used by the Line Art modifier 
to filter lines. See Collection Masks for more information. 


Mask 
Intersections generated by this collection will have this 
mask value. 


Intersection Priority 
Assigns an intersection priority value for this collection. 
The intersection line will be included into the object with 
the higher intersection priority value. 


Custom Properties 


Create and manage your own properties to store data in the 
collection’s data block. See the Custom Properties page for 
more information. 


Collections Menu 


Reference 

Mode: Object Mode 

Menu: Object >» Collection 
Shortcut: M, Shift-M, Ctr1l-G, etc. 


Move to Collection 
Move selected objects to an existing or new collection. 


Link to Collection Shift-m 
Add selected objects to a collection, while keeping them 
in their current collection. This way objects can appear in 


multiple collections. A new collection can be created in 
the pop-up. 


Create New Collection Ctri-G 
Creates a new collection and adds the selected object(s) 
to it. The name of the new collection can be specified in 
the Create New Collection Adjust Last Operation panel. 
This collection is not linked to the active scene. 


Remove from Collection Cctri-Alt-G 
Remove the selected objects from a collection. If the 
object belongs to more than one collection, a pop-up lets 
you select the collection and an option to remove it from 
all collections. 


Remove from All Collections Shift-Ctrl-Alt-G 
Remove the selected objects from all collections. 


Add Selected to Active Collection Shift-Cctri-G 
Adds the selected objects to the collections to which the 
active object belongs. 


Remove Selected from Active Collection Shift-Alt-G 
Causes the selected objects to be removed from the 
collections to which the active object belongs. 


Collections Panel 


Reference 


Mode: Object Mode 
Panel: Object tab >» Collections 


¥ Collections 


Add to Collection 


Collection 


Collections panel. 


All collections that an object has been assigned to are listed 
in the Properties Object tab > Collections panel. 


Add to Collection 
Adds the selected object to a collection. A pop-up lets 
you specify the collection to add to. 


New + 
Creates a new collection and adds the selected object to 
it. 


Name 
To rename a collection, simply click in the collections 
name field. 


Remove xX 
To remove an object from a collection, find the name of 
the collection from which you wish to remove the object, 
and click the x button to the right of the collection name. 


Specials 
Unlink Collection, Select Collection, Set Offset from 
Cursor 


Offset 


Applies a spatial offset of the instanced collections from 
the original object’s origin. 


See also 
Appending or Linking Collections 


To append a collection from another blend-file, consult this 
page. In summary, File > Link/Append Link Select a blend- 
file and then the collection. 


Tip 
Selecting Collections 


Collections can be selected, see Select Grouped for more 
information. 


Instancing 


Note 


Geometry nodes provides a more flexible way to instance 
objects, with the Instance on Points Node. 


Vertices 
This creates an instance of all children of this object on 
each vertex (for mesh objects only). 


Faces 
This creates an instance of all children of this object on 
each face (for mesh objects only). 


Collection 
This creates an instance of the collection with the 
transformation of the object. Collection instancers can be 
animated using actions, or can get a Proxy. 
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o Collections and Dynamic Linking 
o Making_an Instanced Collection Real 


Vertices 


Reference 
Mode: Object Mode 
Panel: Properties » Object Properties > 


Instancing 


Instance Vertices allows you to replicate child objects at the 
location of every vertex of the parent object. 


Note 


The relative Object Origin position of the parent and child 
objects determines offset instanced geometry from parent 
vertex. 


Align to Vertex Normal 


Rotates all instanced objects according to the 
corresponding vertex normals of the parent mesh. 


To change the axis of direction of the instanced objects, 
select the child object and change the Tracking Axis. 


There are actually two approaches to modeling using 
instanced vertices. They can be used as an arranging tool, 
allowing you to model geometrical arrangements of objects 
(e.g. the columns of a Greek temple, the trees in a garden, 
the desks in a classroom). The object can be of any object 
type which Blender supports. The second approach is to use 
them to model an object starting from a single part of it 


(e.g. the spikes in a club, the thorns of a sea-urchin, the tiles 
in a wall, the petals in a flower). 


Note 
Download Example Blend-File 


You can download a file with the examples described on 
this page. In this blend, the first example, a monkey 
parented to a circle is on layer 1; while a tentacle parented 
to an icosphere is on layer 2. 


Usage 
Instanced Vertices as an Arranging Tool 


All you need is a base object (e.g. the tree or the column) 
and a pattern mesh with its vertices following the pattern 
you have in mind. In this section, we will use a simple scene 
for the following part. We will be using a monkey head 
located at the origin of the coordinate system as our base 
object and a circle at the same location as our parent mesh. 


A monkey head and Instanced monkeys 
a circle. on Vertices. 


First, in Object Mode, select the base object and Shift-LMB to 
add the circle to the selection (order is very important here), 
and ctri-P or Object >» Parent >» Object to parent the base 
object to the circle. Now, the circle is the parent of the 
monkey; if you move the circle, the monkey will follow it. 


With only the circle selected, enable Instancing Vertices; a 
monkey head should be placed at every vertex of the circle. 


The original monkey head at the center and the parent 
mesh are still shown in the 3D Viewport but neither will be 
rendered. If the placement and rotation of your monkey 
head are odd, you might need to clear its rotation Alt-R, 
scale Alt-S, location Alt-G, and origin Object >» Clear » Origin. 


Rearranging 


If you now select the base object and modify it in either 
Object or Edit Mode, all changes will also affect the shape of 
all instanced objects. You can also select the parent mesh to 
modify the arrangement of the instances; adding vertices 
will also add more base objects. 


Note that the base objects will inherit changes made to the 
parent mesh in Object Mode, but not in Edit Mode. So 
scaling the circle up in Object Mode will enlarge the monkey 
head, while scaling the circle up in Edit Mode will only 
increase the distance between the base objects. 


Orientation 


The orientation of the base objects can be controlled by 
enabling Align to Vertex Normal in the Instancing panel. This 
will rotate all base objects according to the vertex normals 
of the parent mesh. 


To change the orientation of the instanced objects, select 
the base object and change the Tracking Axis. 


Output of various orientations. 


Orientation enabled, 


orientation +Y. Negative ¥. 


Positive X. Positive Z, up X. 


Note 


The axes of an object can be made visible in the Properties 
>» Object Properties » Viewport Display panel. To display 
the vertex normals of the parent mesh, enter Edit Mode 
and enable this visualization in the Display & Shading » 
Viewport Overlays >» Normals where you can also resize the 
displayed normals as necessary. 


Instanced Vertices as a Modeling Tool 


Very interesting models can be made using Instancing 
Vertices and a standard primitive. In this example, a simple 
tentacle was made by extruding a cube a couple of times. 
The tentacle object was then parented to an icosphere. With 
Align to Vertex Normal enabled for the parent mesh (the 
icosphere), the orientation of the base object (the tentacle) 
was adapted to the vertex normals of the parent mesh (in 
this case the tentacle was rotated -90° about the X axis in 
Edit Mode). 


Align to 

A simple Tentacles Vertex 

instanced Normal 
tentacle 

onto the enabled to 
set to arent align 
smooth. P g 

mesh. instanced 

geometry. 


As in the previous example, the shape and proportions of 
the arrangement can now be tweaked. 


To turn all instanced geometry into real objects, select the 
icosphere and Make Instances Real. To make the icosphere 


and the tentacle a single object, make sure they are all 
selected and go to Object > Join, Ctri-J. 


See also 


Other duplication methods are listed here. 


Faces 


Reference 
Mode: Object Mode 
Panel: Properties » Object Properties > 


Instancing 


Instancing Faces is the capability to replicate an object on 
each face of a parent object. One of the best ways to 
explain this is through an example illustration. 


Scale 


Scales each instance according to the size of its 
corresponding face. 


Inherit Scale 
Scale the instance faces objects. 


Make Instance Face tool converts linked objects (that share 
mesh data) into instanced faces. This tool creates the 
parent object (instancer) with faces where the objects were, 


then it uses /Instancing Faces to put instances at the location 


of every created face. 


You can go back from Instancing Faces to multiple linked 
objects using Make Instances Real. 


See also 
Example blend-file 


Download the blend-file used for the examples on this 
page here. 


Basic Usage 


In this example we will use a UV sphere with an extruded 
“north pole” as our base object and a cube as our parent 
mesh. To parent the sphere to the cube, in Object Mode, first 
LMB select the sphere, then Shift-LMB select the cube (order is 
very important here), and finally ctri-P to parent. 


A cube anda Instancing Faces 
sphere. applied to the cube. 


Next, in the Properties > Object Properties > Instancing, 
select Faces. The sphere is instanced, one for each face of 
the cube. 


Note 
Inherited properties 


The location, orientation, and scale of the instanced 
child(ren) matches that of the faces of the parent. So, if 
several objects are parented to the cube, they will all be 
instanced once for each face on the cube. If the cube is 
subdivided, every child will be instanced for each face on 
the cube. 


Both the parent object and original are displayed as editable 
“templates” in 3D Viewport, but neither is rendered. 


Scale 


Top face of cube 


Scale enabled. scaled down. 


By enabling Scale for the parent object, the scale of the 
child objects will be adapted to the size of each face in the 
parent object. 


Thus, by rescaling the face of the parent object, the size of 
the instanced object will change accordingly. 


Limitations/Considerations 


The positioning of the instanced geometry relative to the 
face is dependent upon the position of the child objects 
relative to the instancer’s origin. This can lead to some 
visual artifacts in the 3D Viewport as the geometry of the 
Original objects overlaps or intersects with the instanced 
geometry. One workaround is to move the origin of the 
instancer mesh off of the plane of the faces. 


If the geometry of the children is not symmetrical then the 
orientation of the face (as determined by the order of its 
vertices) could matter. As of 2.70 Blender does not have 
tools which allow you to adjust the ordering of the vertices 
on a face. 


However, there is a workflow that lets you control for this. 
Make a single square and enable the /nstancing Faces so 
you can see the instanced geometry in the 3D Viewport. If 
the orientation is not what you want, rotate the face until it 
is how you want. Typically you want to do the rotation in Edit 
Mode, not Object Mode, but this is not a hard rule. 


Once you have the orientation correct, Duplicate the face 
and move the duplicate where you want it. Repeat this 
process until you have enough faces. Since it is common for 
these faces to butt up against one another, your geometry 
will have lots of duplicate vertices. Use the Merge by 
Distance button in the Tools panel. 


Demo Video 


A short video illustrating this workflow 


Collection 


Reference 
Mode: Object Mode 
Panel: Properties » Object Properties > 


Instancing » Collection 


Instance Collections allows you to create an instance of a 
collection for each instance of another object. Collections 
may contain animations, objects with physics simulations 
and even other nested collections. 


Basic Usage 


Create a Collection: 
e Create a new collection (this can be done via the 
Outliner). 
e Link the objects that need to be instanced as part of 
the newly created collection. 
Create a new Collection Instance: 
e Add > Collection Instance 


At this point, an instance of the collection and an empty 
object will appear. You can duplicate the empty, and the 
Instance Collections settings will be preserved for each 
empty. This way, you can get multiple copies of linked data 
very easily. 


Collections and Dynamic Linking 


See Appending_and Linking to understand how to 
dynamically link data from another blend-file into the 
current file. You can dynamically link collections from one 
blend-file to another. When you do so, the linked collection 
does not appear anywhere in your scene until you create an 
object controlling where the collection instance appears. 


Making an Instanced Collection 
Real 


If you want to make further edits on an instanced collection 
select the Instance Collection. Then call Make Instances Real 
to convert the collection into regular objects that can be 
transformed and animated normally. 


Note 


Note that if the instanced collection was linked from an 
external file, the Object Data (mesh, materials, textures, 
transforms) will also still be linked from the original 
collection. However, the various object’s parent-child 
relationships do not carry over. 


Visibility 


Reference 
Mode: Object Mode 
Panel: Properties » Object Properties » Visibility 


The Visibility panel controls how objects are interacted with 
in the viewport and in the final render. These visibility 
options can also be set in the Outliner. 


Selectable 
The object is able to be selected in the 3D Viewport. 


Show In 
Viewports 
The object will be displayed in the 3D Viewport. 


Renders 


The object is able to be in the final render, note that it 
will still be visible in rendered shading view. 


See also 


Cycles has additional Visibility properties and also Grease 
Pencil objects have additional Visibility properties. 


Mask 
Holdout 
Render objects as a holdout or matte, creating a hole 


in the image with zero Alpha, to fill out in compositing 
with real footage or another render. 


Viewport Display 


Reference 
Mode: Object Mode 
Panel: Properties >» Object Properties >» Viewport 


Display 


The Viewport Display panel is used to enable extra display 
options for the 3D Viewport. 


Y¥ Viewport Display 


Name . Axis 
Wireframe . All Edges 
Texture Space . Shadow 

In Front 
Display As Textured 


v . 


Bounds 


Viewport Display panel. 


Show 
Name 
Displays the name of the object in the 3D Viewport. 


Axis 
Displays an object similar to an empty that shows the 
object’s axis. 


Wireframe 


Displays an object’s wireframe on top of the solid 
display. 


All Edges 
Displays all edges for mesh objects. 


Texture Space 
Displays the objects Texture Space. 


Shadow 
Allows the object to cast shadows in the viewport. 


In Front 
Makes the object display in front of others. 
(Unsupported for instanced objects.) 


Display As 
The shading mode to display in the 3D Viewport; this can 
be useful if you have a high-poly object that is slowing 
down the viewport. 


Color 
Allows to specify the object’s color when using the 
Workbench renderer. 


Bounds 
Displays a bounding shape around an object. This can be 
helpful if you have high-poly objects that slow down the 
viewport. The shape of the object’s bounds can be 
calculated with different primitive shapes that might be 
closer to what the original object looks like. 


Line Art 


Reference 
Mode: Object Mode 
Panel: Properties » Object Properties > Line Art 


The Line Art panel is used to enable extra display options for 
customizing line art rendering for a specific object. 


¥ Line Art 


Usage _ Inherit 


Override Crease #7 


Line Art panel. 


Usage 
How the object is loaded into line art. This property 
overrides the parent collection’s Line Art usage. 


Inherit: No special loading strategy for line art. 
Loading of the object is controlled by 
parent collection’s line art settings. 

Include: Force include the object into line art 
calculation even if its parent collection 
specifies otherwise. 

Intersection Only: 

The object will only produce 
intersection lines in the scene and its 
own geometry stays invisible. 

Occlusion Only: 


The object will only cause occlusion to 
existing feature lines and its geometry 
stays invisible. 

Exclude: The object will not be loaded into line 
art at all. 

No Intersection: 
The object will not generate 
intersection lines on itself or with other 
objects in scene. 

Force Intersection: 
Generate intersection lines even with 
objects that disabled intersection. 


Override Crease 


Allows the object to have a different crease value than 
the global one set in the line art modifier. 


Crease 
Override crease value for the object. 


Intersection Priority 
Assigns an intersection priority value for this object. The 


intersection line will be included into the object with the 
higher intersection priority value. 


Tools 


e Toolbar 
e Tool Settings 
o Options 


Types 


e Scale Cage 


Toolbar 


Tweak 
Select or move. 


Select Box 
Select objects by dragging a box. All objects that 
intersect the box will be selected. 


Select Circle 
Select objects by dragging a circle. All objects that 
intersect the path of the circle will be selected. 


Select Lasso 
Select objects by drawing a lasso. 


Cursor 
Change the location of the 3D Cursor. 


Move 
Translation tool. 


Rotate 
Rotation tool. 


Scale 
Scale tool. 


Scale Cage 
Change the scale of an object by controlling its cage. 


Transform 
Tool to adjust the objects translation, rotations and scale. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Measure 
Measure distances in the scene. 


Add Cube 
Interactively add a cube mesh object. 


Add Cone 
Interactively add a cone mesh object. 


Add Cylinder 
Interactively add a cylinder mesh object. 


Add UV Sphere 
Interactively add a UV sphere mesh object. 


Add Icosphere 
Interactively add an icosphere mesh object. 


Tool Settings 
Options 


Reference 


Mode: Object Mode and Pose Mode 
Header: Sidebar > Tool » Options 


Transform 


Affect Only 
Origins Ctrl-Period 
Directly transforms the object’s origin. This only works 
for objects with data which can be transformed; i.e. it 
will not work on object lights. 


When enabled, the object axes are displayed. 


Take care using this option since it transforms the 
object-data which may cause linked duplicates to be 
moved unintentionally. 


Hint 

Changing the object location and the object-data 
may impact modifiers, constraints and keyframe 
animation. 


If you are only temporarily setting the pivot point, 
use the 3D cursor instead. 


Locations 
Changes the position of the object’s origin relative to 
another point during transformation. In other words, 
the pivot point and the origin cannot share the same 
location. This will not affect the object local 
transforms, just its position in world space. 


In the examples below, a comparison of the scaling 
and rotation of objects, when Location is enabled 
(middle) and disabled (right). 


Rotation example. 


Scaling example. 


Parents 


Transforms Parent Objects while leaving their children 
objects unaffected. 


Scale Cage 


Reference 
Mode: Object and Edit Modes 
Tool: Toolbar > Scale » Scale Cage 


The Scale Cage tool is a bounding box around the object(s) 
which scales objects from a particular point or axis. The tool 
works by selecting a scale point and dragging inwards or 
outwards to adjust the scale accordingly. The origin for the 
scale will be from the point on the cube directly opposite 
from the point selected. Selecting points on the faces of the 
cube scales along one axis, selecting points on the edges of 
the cube scales along two axes, and selecting points on the 
vertices of the cube scales along all three axes. 


Scale Cage tool. 


Tool Settings 


Orientation 
Aligns the transformation axes to a specified orientation 
constraint. See Transform Orientations for more 
information. 


Options 


Scale X, Y, Z 
The amount to resize the selection on their respected 
axis. 


Orientation 
Aligns the transformation axes to a specified orientation 
constraint. See Transform Orientations for more 
information. 


Proportional Editing 
The extruded face will affect nearby geometry. See 
Proportional Editing for a full reference. 


View Layers 


e Introduction 
o Outliner 


Introduction 


The visibility controls are part of view layers, designed to 
help organizing what you want to see or work on. 


‘= Collection 3 ‘= Collection 1 


ca Collection 2 


‘m= Collection 2 


View layers and collections. 


View layers reference to collections, and allow to set their 
visibility, selectability and other options. A view layer can 
have any collection enabled, and multiple view layers can 
use the same or different collections. 


See also 


Each view layer can be rendered separately as individual 
Render Layers to help composite your scene. 


Outliner 


You can edit the view /ayer collections in the Outliner. 


Scene Collection 


[ oe | pn 
L=] Consonants 


Cl Numbers 


ca 
L=] Primes 


View layer and collections in the Outliner. 
There you can enable and disable collections, hide them 
temporarily, globally, among other options. 


See also 


Read more about Collections in the Outliner. 
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Introduction 


The creation of a 3D scene needs at least three key 
components: Models, materials and lights. In this part, the 
first of these is covered, that being modeling. Modeling is 
simply the art and science of creating a surface that either 
mimics the shape of a real-world object or expresses your 
imagination of abstract objects. 


Modes 


Depending on the type of object you are trying to model, 
there are different types of modeling modes. Since modes 
are not specific to modeling they are covered in different 
parts of the manual. 


Switching between modes while modeling is common. Some 
tools may be available in more than one mode while others 
may be unique to a particular mode. 


Edit Mode 


Edit Mode is the main mode where modeling takes place. 
Edit Mode is used to edit the following types of objects: 


e Meshes 

e Curves 

e Surfaces 

e Metaballs 

e Text objects 
e Lattice 


You can only modify the mesh of the objects you are editing. 
To modify other objects you can leave Edit Mode, select 


another object and enter Edit Mode, or use Multi-Object 
Editing. 


Meshes 
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Introduction 


Mesh Modeling typically begins with a Mesh Primitive shape 
(e.g. circle, cube, cylinder...). From there you might begin 
editing to create a larger, more complex shape. 


Modeling Modes 


The 3D Viewport has three principal modes that allow for 
the creation, editing and manipulation of the mesh models. 
Each of the three modes has a variety of tools. Some tools 
may be found in one or more of the modes. 


Modes that used for modeling: 


Object Mode 
Supports basic operations such as object creation, joining 
objects, managing shape keys, UV/color layers. 


Edit Mode 
Used for the majority of mesh editing operations. 


Sculpt Mode 
Instead of dealing with individual mesh elements, 
Supports sculpting with brushes (not covered in this 
chapter). 


Structure 


With meshes, everything is built from three basic structures: 
vertices, edges and faces. 


Vertex 


Example of mesh structure. 


Vertices 


The most elementary part of a mesh is the vertex (vertices 
plural) which is a single point or position in 3D space. 
Vertices are represented in the 3D Viewport in Edit Mode as 
Small dots. The vertices of an object are stored as an array 
of coordinates. 


Tip 


Do not mistake the object origin for a vertex. It may look 
similar, but it is bigger and cannot be selected. 


The vertex is labeled as “A”; the object’s origin dot 
is labeled as “B”. 


Edges 


An edge always connects two vertices by a straight line. The 
edges are the “wires” you see when you look at a mesh in 
wireframe view. They are usually invisible on the rendered 
image. They are used to construct faces. 


Faces 


Faces are used to build the actual surface of the object. 
They are what you see when you render the mesh. If this 
area does not contain a face, it will simply be transparent or 
nonexistent in the rendered image. 


A face is defined as the area between either three 
(triangles), four (quadrangles) or more (n-gons) vertices, 


with an edge on every side. The faces are often abbreviated 
to tris, quads & n-gons. 


Triangles are always flat and therefore easy to calculate. On 
the other hand, quadrangles “deform well” and are 
therefore preferred for animation and subdivision modeling. 


See also 


e Why should triangles be avoided for character 
animation? 

e When should N-gons be used, and when shouldn't 
tney? 


Normals 


In geometry, a normal is a direction or line that is 
perpendicular to something, typically a triangle or surface 
but can also be relative to a line, a tangent line for a point 
on a curve, or a tangent plane for a point on a surface. 


A visualization of the face normals of a torus. 


In the figure above, each blue line represents the normal for 
a face on the torus. The lines are each perpendicular to the 

face on which they lie. The visualization can be activated, in 
Edit Mode, in the Mesh Display Viewport Overlays panel. 


Properties 


Reference 


Panel: Properties » Object Data » Normals 


¥ Normals 


Auto Smooth 


Normals panel. 


Auto Smooth 
Edges where an angle between the faces is smaller than 
specified in the Angle field will be smoothed, when 
shading of these parts of the mesh is set to smooth. This 
is an easier way to combine smooth and sharp edges. 


Example mesh with Auto Smooth enabled. 
Advanced Smooth Shading & Sharp Edges 


By default in Blender, with basic normal computing 
behavior, a sharp edge is always defined as an edge being 
either non-manifold, or having at least one of its faces 
defined as flat. 


Enabling the Auto Smooth setting adds an extra parameter 
to define a sharp edge, the Angle threshold between two 
neighbor faces, above which the edge will always be 
considered as sharp. 


Auto Smooth also enables Custom Split Normals handling, 
which can be either defined (and edited) as a mesh data 
layer, or generated on the fly by modifiers. In any case, 
when a mesh gets custom normals, they always supersede 
the default ones computed by Auto Smooth. 


Sharp edges may still be used by the custom normals 
modifiers to compute their normals, depending on their 
settings. 


Custom Split Normals 


Custom Split Normals is a way to tweak/fake shading by 
pointing normals towards other directions than the default, 
auto-computed ones. It is mostly used in game 
development, where it helps counterbalance some issues 
generated by low-poly objects (the most common examples 
are low-poly trees, bushes, grass, etc. and the ‘rounded’ 
corners). 


Blender supports custom normals on a ‘smooth fan’ base, 
defined as a set of neighbor face corners sharing the same 


vertex and ‘linked’ by smooth edges. This means you can 
have normals per face corners, per a set of neighbor face 
corners, or per vertex. 


Enabling Custom Split Normals 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Normals » Split 


Enables custom split normals. Also, any of the custom 
normal editing tools (see below) will, as a convenience, 
enable custom normals if they are not already enabled. 


Note 


This has the side effect of enabling Auto Smooth, as that is 
necessary to use custom normals. Once you have custom 
normals, the angle threshold of the Auto Smooth behavior 
is disabled - all non-sharp-tagged edges will be considered 
as smooth, disregarding the angle between their faces. 


Editing Custom Split Normals 


Reference 

Mode: Edit Mode 
Menu: Mesh » Normals 
Shortcut: AlLt-N 


There are a number of tools for editing custom split normals. 
The custom normal mesh edit tools can affect all normals 


(the default), or only selected ones. To select a custom 
normal associated with a particular vertex and face: 


e Make the element selection mode both Vertex and Face 
(use Shift-LMB to enable the second one). 

e Select one or more vertices, then select a face. This can 
be repeated to select more vertices and a different face 
and so on. It is easiest to see the effect of these tools if 
you turn on the Edit Mode Overlays option Display 
vertex-per-face normals as lines. 


See also 


Editing Normals. 


Importing Custom Split Normals 


irregular geometry when tessellating their objects into 
meshes (very thin and long triangles, etc.). Auto-computed 
normals on such geometry often gives bad artifacts, so it is 
important to be able to import and use the normals as 
generated by the CAD tool itself. 


Note 


Currently, only the FBX Importer and Alembic Importer are 
capable of importing custom normals. 


Topology 


Loops 


Edge and face loops. 


Edge and face loops are sets of faces or edges that form 
continuous “loops” as shown in Fig. Edge and face loops.. 


In the image above, loops that do not end in poles are cyclic 
(1 and 3). They start and end at the same vertex and divide 
the model into two partitions. Loops can be a quick and 
powerful tool to work with specific, continuous regions of a 
mesh and are a prerequisite for organic character 
animation. For a detailed description of how to work with 
loops in Blender, see: Select Edge Loops. 


Note 


Note that loops (2 and 4) do not go around the whole 
model. Loops stop at so-called poles because there is no 
unique way to continue a loop from a pole. Poles are 
vertices that are connected to either three, five, or more 
edges. Accordingly, vertices connected to exactly one, two 
or four edges are not poles. 


Edge Loops 


Loops (1 and 2) in Fig. Edge and face loops. are edge loops. 
They connect vertices so that each one on the loop has 


exactly two neighbors that are not on the loop and placed 
on both sides of the loop (except the start and end vertex in 
case of poles). 


Edge loops are an important concept especially in organic 
(subsurface) modeling and character animation. When used 
correctly, they allow you to build models with relatively few 
vertices that look very natural when used as subdivision 
surfaces and deform very well in animation. 


Take Fig. Edge and face loops. in organic modeling as an 
example: the edge loops follow the natural contours and 
deformation lines of the skin and the underlying muscles. 
The loops are denser in areas that deform more when the 
character moves, for example at the shoulders or knees. 


Further details on working with edge loops can be found in 
Select Edge Loops. 


Face Loops 


These are a logical extension of edge loops in that they 
consist of the faces between two edge loops, as shown in 
loops (3 and 4) in Fig. Edge and face loops.. Note that for 
non-circular loops (4) the faces containing the poles are not 
included in a face loop. 


Further details on working with face loops can be found in 
Face Loop Selection. 


Poles 
See N-poles & E-poles. 


Non-Manifold 


See Non-manifold. 


Primitives 


Reference 

Mode: Object Mode and Edit Mode 
Menu: Add >» Mesh 

Shortcut: Shift-A 


A common object type used in a 3D scene is a mesh. 
Blender comes with a number of “primitive” mesh shapes 
that you can start modeling from. You can also add 
primitives in Edit Mode at the 3D cursor. 
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Blender’s standard primitives. 


Note 


Planar Primitives 


You can make a planar mesh three-dimensional by moving 
one or more of the vertices out of its plane (applies to 
Plane, Circle and Grid). A simple circle is often used as a 
starting point to create even the most complex of meshes. 


Common Options 


These options can be specified in the Adjust Last Operation 
panel, which appears when the object is created. Options 
included in more than one primitive are: 


Generate UVs 
Generates a default UV unwrapping of new geometry. 
This will be defined in the first UV layer (which will get 
added if needed). 


Radius/Size, Align to View, Location, Rotation 
See Common Object Options. 


Plane 


The standard plane is a single quad face, which is composed 
of four vertices, four edges, and one face. It is like a piece of 
paper lying on a table; it is not a three-dimensional object 
because it is flat and has no thickness. Objects that can be 
created with planes include floors, tabletops, or mirrors. 


Cube 


A standard cube contains eight vertices, twelve edges, and 
six faces, and is a three-dimensional object. Objects that 
can be created out of cubes include dice, boxes, or crates. 


Circle 


Vertices 
The number of vertices that define the circle or polygon. 


Fill Type 
Set how the circle will be filled. 


Triangle Fan 
Fill with triangular faces which share a vertex in the 


middle. 


N-gon 
Fill with a single N-gon. 


Nothing 
Do not fill. Creates only the outer ring of vertices. 


UV Sphere 


A standard UV sphere is made out of quad faces anda 
triangle fan at the top and bottom. It can be used for 


texturing. 


Segments 
Number of vertical segments. Like the Earth’s meridians, 


going pole to pole. 

Rings 
Number of horizontal segments. These are like the 
Earth’s parallels. 


Note 


Rings are face loops and not edge loops, which would 
be one less. 


Icosphere 


An icosphere is a polyhedral sohere made up of triangles. 
Icospheres are normally used to achieve a more isotropical 
layout of vertices than a UV sphere, in other words, they are 
uniform in every direction. 


Subdivisions 
How many recursions are used to define the sphere. At 
level 1 the icosphere is an icosahedron, a solid with 20 
equilateral triangular faces. Each increase in the number 
of subdivisions splits each triangular face into four 
triangles. 


Note 


Subdividing an icosphere raises the vertex count very 
quickly even with few iterations (10 times creates 
5,242,880 triangles), Adding such a dense mesh is a sure 
way to cause the program to crash. 


Cylinder 


Objects that can be created out of cylinders include handles 
or rods. 


Vertices 
The number of vertical edges between the circles used to 
define the cylinder or prism. 


Depth 
Sets the starting height of the cylinder. 


Cap Fill Type 
Similar to circle (see above). When set to none, the 
created object will be a tube. Objects that can be created 
out of tubes include pipes or drinking glasses (the basic 
difference between a cylinder and a tube is that the 
former has closed ends). 


Cone 


Objects that can be created out of cones include spikes or 
pointed hats. 


Vertices 
The number of vertical edges between the circles or tip, 
used to define the cone or pyramid. 


Radius 1 
Sets the radius of the circular base of the cone. 


Radius 2 
Sets the radius of the tip of the cone. Which will create a 
frustum (a pyramid or cone with the top cut off). A value 
of O will produce a standard cone shape. 


Depth 
Sets the starting height of the cone. 


Base Fill Type 
Similar to circle (see above). 


Torus 


A doughnut-shaped primitive created by rotating a circle 
around an axis. The overall dimensions can be defined by 
two methods. 


Operator Presets 


Torus preset settings for reuse. These presets are stored 
as scripts in the proper presets directory. 


Major Segments 


Number of segments for the main ring of the torus. If you 
think of a torus as a “spin” operation around an axis, this 
is how many steps are in the spin. 


Minor Segments 


Number of segments for the minor ring of the torus. This 
is the number of vertices of each circular segment. 


Dimensions Mode 
Change the way the torus is defined. 


Major/Minor, Exterior/Interior 


Major Radius 
Radius from the origin to the center of the cross 
sections. 


Minor Radius 
Radius of the torus’ cross section. 


Exterior Radius 
If viewed along the major axis, this is the radius from 
the center to the outer edge. 


Interior Radius 
If viewed along the major axis, this is the radius of the 
hole in the center. 


Grid 


A regular quadratic grid which is a subdivided plane. 
Example objects that can be created out of grids include 
landscapes and organic surfaces. 


X Subdivisions 
The number of spans in the X axis. 


Y Subdivisions 
The number of spans in the Y axis. 


Monkey 


This adds a stylized monkey head to use as a test mesh, use 
Subdivision Surface for a refined shape. 


This is intended as a test mesh, similar to: 


e Utah Teapot 
e Stanford Bunny. 


Hint 
History 


This is a gift from old NaN to the community and is seen as 
a programmer's joke or “Easter Egg”. It creates a 
monkey’s head once you press the Monkey button. The 
Monkey’s name is “Suzanne” and is Blender’s mascot. 


Note 


Add-ons 


In addition to the basic geometric primitives, Blender has a 
number of script generated meshes to offer as pre- 
installed add-ons. These are available when enabled in the 
Preferences (select the Category Add Mesh, then check 
any desired items). 


Tools 


e Toolbar 
e Tool Settings 
o Options 


Types 


Extrude Region 
Extrude Manifold 
Extrude to Cursor 
Loop Cut 

Poly Build 

Spin 


Toolbar 


Mesh Edit Mode tools: 


select 
Select or move. 


Select Box 
Select geometry by dragging a box. 


Select Circle 
Select geometry by dragging a circle. 


Select Lasso 
Select geometry by drawing a lasso. 


Cursor 
Change the location of the 3D Cursor. 


Move 
Translation tool. 


Rotate 
Rotation tool. 


Scale 
Scale tool. 


Scale Cage 
Change the scale of an object by controlling its cage. 


Transform 
Tool to adjust the objects translation, rotations and scale. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Measure 
Measure distances in the scene. 


Add Cube 
Interactively add a cube mesh object. 


Add Cone 
Interactively add a cone mesh object. 


Add Cylinder 
Interactively add a cylinder mesh object. 


Add UV Sphere 
Interactively add a UV sphere mesh object. 


Add Icosphere 
Interactively add an icosphere mesh object. 


Extrude Region 
Extrude the selected region together freely or along an 
axis. 


Extrude Manifold 
Extrudes region and dissolves overlapping geometry. 


Extrude Along Normals 
Extrude Region along their local normal. 


Extrude Individual 
Extrude each individual element along their local 
normal. 


Extrude To Cursor 
Extrude selected vertices, edges or faces towards the 
mouse cursor. 


Inset Faces 
Inset selected faces. 


Bevel 
Create a bevel from the selected elements. 


Loop Cut 
Create a loop cut along the mesh. 


Offset Edge Loop Cut 
Add two edge loops on either side of selected loops. 


Knife 
Create a knife cut in the mesh. Press enter to confirm the 
cut. 


Bisect 
Bisect the mesh. 


Poly Build 
Create geometry by adding vertices one by one. 
Create new geometry by extruding and rotating. 
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pin Duplicate 


Create new geometry by duplicating and rotating. 


Smooth 
Flatten angles of selected vertices. 


Randomize 
Randomize selected vertices. 


Edge Slide 
Slide edge along a face. 


Vertex Slide 
Slide vertex along an edge. 


Shrink/Flatten 
Shrink selected vertices along their normals. 


Push/Pull 


Push or pull (scale) selected elements. 


Shear 
Shear selected elements. 


To Sphere 
Move vertices outwards in a spherical shape around 
object center. 


Rip Region 
Rip Polygons and move the result. 


Rip Edge 
Extend vertices and move the result. 


Tool Settings 


Options 

Reference 

Mode: Edit Mode 

Panel: Sidebar > Tool tab > Options panel 
Transform 


Correct Face Attributes 


Adjust geometry attributes like UVs and Color Attributes 
while transforming. 


Keep Connected 


Merge attributes connected to the same vertex while 
using Correct Face Attributes. 


Tip 


Keeping UVs connected is useful for organic modeling, 
but not for architectural modeling. 


UVs 


Live Unwrap 


Automatically recalculates the UV unwrapping every time 
an edge has its seam property changed. Note, this is 
different than the Live Unwrap option in the UV Editor. 


Mirror 


Mirror allows you to transform vertices symmetrically 
according to the chosen axis. When you transform an 
element (vertex, edge or face), if there is its exact axis- 
mirrored counterpart (in local space), it will be transformed 
accordingly, through a symmetry along the chosen axis. 


Note 


The conditions for Mirror to work are quite strict, which can 
make it difficult to use. To have an exact mirrored version 
of a (half) mesh, it’s easier and simpler to use the Mirror 
Modifier. 


Topology Mirror 


Note 


For Topology Mirror to work, at least one of the three Mirror 
Axis must be enabled. 


When using any of the three Mirror Axis options to work on a 
mirrored Mesh Geometry, the vertices that are mirrored 
must be perfectly placed. If they are not exactly positioned 
in their mirror locations then the Mirror Axis will not treat 
those vertices as mirrored. 


Topology Mirror tries to address this problem by determining 
which vertices are mirrored vertices not only by using their 
positions but also by looking at how those vertices are 
related to others in the Mesh Geometry. It looks at the 
overall topology to determine if particular vertices will be 


treated as mirrored. The effect of this is that mirrored 
vertices can be non-symmetrical and yet still be treated as 
mirrored. 


Note 


The Topology Mirror functionality will work more reliably on 
mesh geometry which is more detailed. If you use very 
simple geometry, for example a Cube or UV Sphere, the 
Topology Mirror option will often not work. 


Example 


For an example of how to use Topology Mirror open up a 
new Blender scene, then delete the default cube and add a 
Monkey object to the 3D Viewport. 


1. Press Tab to put the Monkey object into Edit Mode. 

2. With all the Mirror Axis options disabled move one of the 
Monkey object’s vertices slightly. 

3. Then Turn the X Axis Mirror on but leave Topology Mirror 
disabled. 

4. If you now move that vertex again, the X Axis Mirror will 
not work and the mirrored vertices will not be altered. 

5. If you then enable Topology Mirror and move the same 
vertices again, then X Axis Mirror should still mirror the 
other vertex, even though they are not perfectly 
positioned. 


Auto Merge Vertices 


Reference 


Mode: Edit Mode 


Menu: Sidebar > Tool » Options » Auto Merge 
Vertices 


When enabled, as soon as a vertex moves closer to another 
one than the Threshold setting, they are automatically 
merged. This option affects interactive operations only 
(tweaks made in the Adjust Last Operation panel are 
considered interactive too). If the exact spot where a vertex 
is moved contains more than one vertex, then the merge 
will be performed between the moved vertex and one of 
those. 


Split Edges & Faces 
Detects the intersection of each transformed edge, 
creating a new vertex in place and sectioning the edge 
and the face if any. 


Threshold 
Defines the maximum distance between vertices that are 
merged. 


Extrude Region 


Reference 

Mode: Edit Mode 

Tool: Toolbar >» Extrude Region 
Shortcut: E 


Extrusion tools duplicate vertices, while keeping the new 
geometry connected with the original vertices. Vertices are 
turned into edges and edges will form faces. 


Single vertex Single edge 
extruded. extruded. 


This tool is of paramount importance for creating new 
geometry. It allows you to create parallelepipeds from 
rectangles and cylinders from circles, as well as easily 
creating such things as tree limbs. 


The axis on which vertices and edges are extruded along 
can be set interactively. Faces are extruded by default along 


their averaged normal. The extrusion can be limited to a 
Single axis by specifying an axis; see Axis Locking. 


The extrude tools differentiate in how the new geometry is 
connected in itself. 


Only the border loop gets extruded. The inner region of the 
selection gets moved unchanged with the extrusion. 


Selected During Set to Z 
face. extrude. axis. 
Details 


Although the process is quite intuitive, the principles behind 
Extrude are fairly elaborate as discussed below: 


e First, the algorithm determines the outside edge loop of 
the extrude; that is, which among the selected edges 
will be changed into faces. By default (see below), the 
algorithm considers edges belonging to two or more 
selected faces as internal, and hence not part of the 
loop. 

e The edges in the edge loop are then changed into faces. 
e If the edges in the edge loop belong to only one face in 
the complete mesh, then all of the selected faces are 
duplicated and linked to the newly created faces. For 


example, rectangles will result in parallelepipeds during 
this stage. 

In other cases, the selected faces are linked to the 
newly created faces but not duplicated. This prevents 
undesired faces from being retained “inside” the 
resulting mesh. This distinction is extremely important 
since it ensures the construction of consistently 
coherent, closed volumes at all times when using 
Extrude. 

When extruding completely closed volumes (like e.g. a 
cube with all its six faces), extrusion results merely ina 
duplication, as the volume is duplicated, without any 
link to the original one. 

Edges not belonging to selected faces, which form an 
“open” edge loop, are duplicated and a new face is 
created between the new edge and the original one. 
Single selected vertices which do not belong to selected 
edges are duplicated and a new edge is created 
between the two. 


Extrude Manifold 


Reference 

Mode: Edit Mode 

Tool: Toolbar » Extrude Manifold 

Menu: Mesh » Extrude >» Extrude Manifold 
Shortcut: AlLt-E 


This tool is very similar to Extrude Faces but enables 
Dissolve Orthogonal Edges by default. This causes the tool 
to automatically split and remove adjacent faces when 
extruding inwards. 


Example 


Extrude Manifold Example. 


Extrude to Cursor 


Reference 
Mode: Edit Mode 
Shortcut: Ctrl-RMB 


Interactively places new vertices with ctrl-RMB at the mouse 
cursor position. 


The most basic element, a vertex, can be added with a Ctrt- 
RMB click when no other vertices are selected. Because the 
Camera space (computer screen) is two-dimensional, 
Blender cannot determine all three vertex coordinates from 
a single mouse click, so the new vertex is placed at the 
depth of the 3D cursor. 


To create interconnected vertices, you can add a vertex and 
continuously make subsequent Ctrl-RMB operations with the 
last vertex selected. This will link the last selected vertex 
with the vertex created at the mouse position with an edge 
(see Fig. Adding vertices one by one.), and will continuously 
create and connect new vertices if you continue repeating 
this operation. 


Adding vertices one by one. 


Creating Faces 


Quad from an Edge with source automatically 
rotated. 


If you have two vertices selected and already connected 
with an edge, Ctrl-RMB click will create a planar face, also 
known as a quad. Blender will follow your mouse cursor and 
will use the planar view from your viewport to create those 
quads. 


For Ctrl-RMB, Blender will automatically rotate the last 
selected Edge (the source) for the subsequent operations if 
you have at least one face created, dividing the angles 
created between the newly created edge and the last two 
edges, creating a smooth angle between them. Blender will 
calculate this angle using the last positive and negative 
position of the last X and Y coordinates and the last 
connected unselected edge. If this angle exceeds a negative 
limit (following a quadrant rule) between the recently 
created edge and the last two, Blender will wrap the faces. 
But if you do not want Blender to rotate and smooth edges 
automatically when extruding from Ctri-RMB, you Can also 
inhibit Blender from rotating sources using the shortcut 


Shift-Ctrl-RMB. In this case, Blender will not rotate the source 
dividing the angle between those edges when creating a 
face. 


If you have three or more vertices selected, and Ctrl-RMB 
click, you will also create planar faces, but along the 
vertices selected, following the direction of the cursor. This 
operation is similar to an extrude operation. 


Tip 


When adding objects with ctrl-RMB, the extrusions of the 
selected elements, being vertices, edges and faces with 
the Ctrl-RMB, are viewport dependent. This means, once 
you change your viewport, for example, from top to left, 
bottom or right, the extrusion direction will also follow your 
viewport and align the extrusions with your planar view. 


Loop Cut 


Reference 

Mode: Edit Mode 

Tool: Toolbar >» Loop Cut 
Shortcut: Ctrl-R 


The Loop Cut tool is a modal tool version of the Loop Cut 
and Slide operator. This tool splits a loop of faces by 
inserting new edge loops intersecting the chosen edge. 


Usage 


The tool is interactive and has two steps: 
1. Pre-Visualizing the Cut 


After the tool is activated, move the cursor over a 
desired edge. The cut to be made is marked with a 
magenta colored line as you move the mouse over the 
various edges. The to be created edge loop stops at the 
poles (tris and n-gons) where the existing face loop 
terminates. 


2. Perform the Cut 


Once the desired location of the new edge loop is found, 
the edge loop can be created via LMB. 


Mesh Preview of Interactive 


before edge loop placement 

inserting location. of edge 

edge loop. loop 
between 
adjacent 
loops. 


Tool Settings 


Number of Cuts 
Increases and decreases the number of cuts to create. 
These cuts are uniformly distributed in the original face 
loop, and you will not be able to control their positions. 


Correct UVs 
Corrects the corresponding UV coordinates, if these exist, 
to avoid image distortions. 


Options 


After the modal tool is run the Loop Cut and Slide Options 
are available in the Adjust Last Operation panel. 


Poly Build 


Reference 
Mode: Edit Mode 
Tool: Toolbar » Poly Build 


The Poly Build tool uses many built operators in an 
interactive way to add, delete, or move geometry. This is 
extremely useful for retopology. 


Tool Settings 


Create Quads 
Automatically split edges in triangles to maintain the 
quad topology. 


Controls 


Add Geometry Ctrl-LMB 
Vertices or faces can be created by moving the cursor 
close to an element and using the hotkey to add a vertex 
or face. The tool first tries to create a face, however, if 
not enough geometry exists to create a face it will try to 
extrude a vertex to the cursor. When creating a face, the 
face can be previewed by holding Ctrl. 


Delete Mesh Elements Shift-LMB 
Vertices, edges, and faces will be deleted by hovering 
over the element and using the hotkey. Elements with 
two or more connected elements will be Dissolved. The 


element you are trying to delete will be highlighted in red 
while holding ctrl. 


Moving Vertices LMB 
Vertices can be moved by hovering over the vertex and 
using to hotkey to grab and move the vertex to the 
desired location. The vertex you are trying to move will 
be highlighted in blue while hovering over it. 


Extruding Edges LMB 
Edges can be extruded by moving the cursor close to an 
edge and using the hotkey to extrude the edge to the 
desired location. The edge you are trying to extrude will 
be highlighted in blue while hovering over it. 


Tip 


It is useful to enable vertex snapping and use Merge by 
Distance while tweaking vertices to combine them. 


Spin 


Reference 
Mode: Edit Mode 
Tool: Toolbar >» Spin 


The Spin tool extrudes (or duplicates it if the selection is 
manifold) the selected elements, rotating around a specific 
point and axis. 


Use the tool to create the sort of objects that you would 
produce on a lathe (this tool is often called “lathe” tool or 
“sweep” tool in the literature, for this reason). In fact, it 
does a sort of circular extrusion of your selected elements, 
centered on the 3D cursor, and around the axis 
perpendicular to the working view... 


e The point of view will determine around which axis the 
extrusion spins... 

e The position of the 3D cursor will be the center of the 
rotation. 


Tool Settings 


Steps 
Specifies how many copies will be extruded along the 
“sweep”. 


Axis 
Specifies the axis to use as the pivot of the spin 
operation. 


Options 


Steps 
Specifies how many copies will be extruded along the 
“sweep”. 


Use Duplicates 
When enabled, will keep the original selected elements 
as separated islands in the mesh (i.e. unlinked to the 
result of the spin extrusion). 


Angle 
Specifies the angle “swept” by this tool, in degrees (e.g. 
set it to 180 for half a turn). 


Auto Merge 
Automatically merges the first a last duplicates, if they 
make a full revolution which results in overlapping 
geometry. 


Flip Normals 
Reverses the Normal’s direction for any resulting 
geometry. 


Center X, Y, Z 
Specifies the center of the spin. By default it uses the 
cursor position. 


Axis X, Y, Z 
Specify the spin axis as a vector. By default it uses the 
view axis (viewport). 


Example 


Glass profile. 


First, create a mesh representing the profile of your object. 
If you are modeling a hollow object, it is a good idea to 
thicken the outline. Fig. Glass profile. shows the profile for a 
wine glass we will model as a demonstration. 


We will be rotating the object around the cursor in the top 
view, so switch to the top view with Numpad7. 


Glass profile, top view in Edit Mode, just before 
spinning. 


Place the cursor along the center of the profile by entering 
Edit Mode and selecting one of the vertices along the 
center, and snapping the 3D cursor to that location with 
Mesh » Snap » Cursor to Selection. (Fig. Glass profile, top 
glass profile from top view, with the cursor correctly 
positioned. 


Select all the vertices with A and select the Spin tool from 
the Toolbar and use the Gizmo to spin the vertices. Fig. Soun 
profile. shows the result of a successful spin. 


Angle 


Spun profile. 


Spun profile using an Spun profile using an 
angle of 360. angle of 120. 


Duplicate 


Result of spin Result of Duplicate 
operation. enabled. 


Merge Duplicates 


Duplicate vertices. 


The spin operation leaves duplicate vertices along the 
profile. You can select all vertices at the seam with Box 
select B (Shown in Fig. Duplicate vertices.) and perform a 
Merge by Distance operation. 


Notice the selected vertex count before and after the Merge 
by Distance operation Vertex count after removing doubles. If 
all goes well, the final vertex count (38 in this example) 
should match the number of the original profile noted in 
Mesh data >» Vertex and face numbers. If not, some vertices 
were missed and you will need to weld them manually. Or, 
worse, too many vertices will have been merged. 


Note 
Merging Two Vertices into One 


To merge (weld) two vertices together, select both of them 
by Shift-LmB clicking on them. Press s to start scaling and 
hold down ctrt while scaling to scale the points down to 0 
units in the X, Y and Z axis. LMB to complete the scaling 
operation and click Mesh >» Merge » By Distance to merge 
the vertices. Alternatively, you can use Context Menu » 
Merge Vertices (or M). Then, in the new pop-up menu, 
choose to merge By Distance. 


Recalculate Normals 


All that remains now is to recalculate the normals to the 
outside by selecting all vertices, pressing Alt-N and 
validating Recalculate Normals Outside in the pop-up menu. 


Selecting 


Introduction 

o Selection Modes 

o X-Ray 

o Select Menu 

o Known Issues 
Select Random 
Checker Deselect 
Select Sharp Edges 
Select Similar 

o Face Regions 


Select All by Trait 
o Non-Manifold 


o Loose Geometry 
o Interior Faces 


o Faces by Sides 
o Ungrouped Vertices 
e Select More/Less 
o Select Next/Previous Active 
Select Loops 
Select Edge Loops 
Select Face Loops 
Select Edge Rings 
Select Loop Inner-Region 
Select Boundary Loop 
e Select Linked 
o Linked 
o Shortest Path 
o Linked Flat Faces 
Side of Active 
Select Mirror 
o Example 


o Oo 0 0 0 


Introduction 


There are many ways to select elements, and it depends on 

what Mesh Select Mode you are in as to what selection tools 
are available. First we will go through these modes and after 
that a look is taken at basic selection tools. 


Selection Modes 


Reference 

Mode: Edit Mode 

Menu: 3D Viewport Header >» Select Mode 
Shortcut: 1, 2, 3 (Shift Multiple Selection Modes, 


ctrt Expand/Contract Selection). 


In Edit Mode there are three different selection modes. You 
can enter the different modes by selecting one of the three 
buttons in the header. 
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2 EditMode v (gig) View Select 


Edit Mode selection buttons from right to left: 
Vertex, Edge, Face. 


Vertex 
In this mode vertices are shown as points. Selected 


vertices are displayed in orange, unselected vertices in 
black, and the active or last selected vertex in white. 


Edge 
In this mode the vertices are not shown. Instead the 
selected edges are displayed in orange, unselected 
edges black, and the active or last selected edge in 
white. 


Face 
In this mode the faces are displayed with a selection 
point in the middle which is used for selecting a face. 
Selected faces and their selection point are displayed in 
orange, unselected faces are displayed in black, and the 
active or last selected face is highlighted in white. 


When using these buttons, you can make use of modifier 
keys, see: Switching Select Mode. 


Almost all tools are available in all three mesh selection 
modes. So you can Rotate, Scale, Extrude, etc. in all modes. 
Of course rotating and scaling a single vertex will not do 
anything useful (without setting the pivot point to another 
location), so some tools are more or less applicable in some 
modes. 


See Fig. Selection modes. for examples of the different 
modes. 


Multiple Selection Modes 


By holding Shift-LMB when selecting a selection mode, you 
can enable multiple Selection Modes at once. This allows 
you to quickly select vertices, edges, or faces, without first 
having to switch mode. 


Selection modes. 


Vertex mode Edge mode 
example. example. 


Mixed mode 


Face mode example. 
P example. 


Switching Select Mode 


When switching modes in an “ascendant” way (i.e. from 
simpler to more complex), from Vertices to Edges and from 
Edges to Faces, the selected parts will still be selected if 
they form a complete element in the new mode. 


For example, if all four edges in a face are selected, 
switching from Edges mode to Faces mode will keep the 
face selected. All selected parts that do not form a complete 
set in the new mode will be unselected. 


Edge mode, the Switching to Face 
initial selection. mode. 


Hence, switching in a “descendant” way (i.e. from more 
complex to simpler), all elements defining the “high-level” 
element (like a face) will be selected (the four vertices or 
edges of a quadrangle, for example). 


Expand/Contract Selection 


By holding ctri when selecting a higher selection mode, all 
elements touching the current selection will be added, even 
if the selection does not form a complete higher element. Or 
contracting the selection when switching to a lower mode. 


Vertex mode, the Expanding to Edge 
initial selection. mode. 


X-Ray 


The X-Ray setting is not just for shading, it impacts selection 
too. When enabled, selection isn’t occluded by the objects 
geometry (as if the object was solid). 


X-ray enabled. X-ray disabled. 


Select Menu 


All A 
Select all. 


None Alt-A 
Select none. 


Inverse Ctrl-I 
Selects all the geometry that is not selected, and 
deselect currently selected components. 


Box Select B 
Interactive box selection. 


Circle Select c 
Interactive circle selection. 


Lasso Select 
Interactive free-form selection. 


Select Random 
Selects a random group of vertices, edges, or faces, 
based on a percentage value. 


Checker Deselect 
Deselect alternate elements relative to the active item. 


Select Sharp Edges 
This tool selects all edges between two faces forming an 
angle greater than the angle value, where an increasing 
angle selects sharper edges. 


Select Similar Shift-G 
Select elements similar to the current selection. 


Select All by Trait 
Select geometry by querying its characteristics. 


Select More/Less 
More Ctrl-NumpadPlus 
Expands the selection to the adjacent elements of the 
selection type. 


Less Ctrl-NumpadMinus 
Contracts the selection from the adjacent elements of 
the selection type. 


Next Active Shift-Ctrl-NumpadPlus 


This uses selection history to select the next vertex, 
edge, or face based on surrounding topology. 


Previous Active Shift-Ctrl-NumpadMinus 
Select previous just removes the last selected 
element. 


Select Loops 
Edge Loops 
Select connected edges. 


Face Loops 
Select connected faces. 


Edge Rings 
Select connected edge ring. 


Select Linked 
Select Linked 
Selects all components that are connected to the 
current selection. 


Shortest Path 
Path between two selected elements. 


Linked Flat Faces 
Select connected faces based on a threshold of the 
angle between them. This is useful for selecting faces 
that are planar. 


Select Side of Active 
Selects all vertices on the mesh in a single axis relative 
to the active vertex. In Vertex selection mode only. 


Select Mirror Shift-Ctrl-M 
Select mesh items at the mirrored location across the 
chosen axis. 


Known Issues 


Dense Meshes 


Selecting dense meshes with X-Ray disabled, has a 
limitation where dense meshes may not have all the 
elements selected. When selecting regions with Box, Circle 
and Lasso select, vertices may overlap each other causing 
some vertices not to be selected. This is a limitation with 
the current selection method, you may workaround this by 
zooming in or enabling X-Ray. 


N-Gons in Face Select Mode 


N-gon face having its center dot inside another face. 


As already noted, in X-Ray and Wireframe mode faces are 
marked with a dot in the middle. With n-gons that can lead 
in certain cases to a confusing display. The example shows 
the center dot of the U-shaped n-gon being inside of the 
oblong face inside the “U”. It is not easy to identify which 
dot belongs to which face (the orange dot in the image is 
the object origin). 


Select Random 


Reference 
Mode: Object Mode 
Menu: Select >» Select Random 


Randomly selects unselected vertices, edges, or faces 
based on percentage probability. 


Percent 
The likelihood of an unselected mesh element being 
selected. Note that this is not the percentage amount of 
elements that will be selected. 


Checker Deselect 


Reference 
Mode: Edit Mode 
Menu: Select » Checker Deselect 


This tool applies an alternating selected/deselected checker 
pattern. This only works if you already have more than one 
mesh element selected. 


Changes the current selection so that only every Nth 
elements (vertices, edges or faces, depending on the active 
selection mode) will remain selected, starting from the 
active one. 


In case of islands of selected elements, this tool will affect 
only the island of the active element (if there is one), or the 
island of the first element in the order of internal storage (if 
there is no active element). 


Deselected 
The number of deselected elements in each pattern 
repetition. 


Selected 
The number of selected elements in each pattern 
repetition. 


Offset 
Offset from the starting point. 


Select Sharp Edges 


Reference 


Mode: Edit Mode 
Menu: Select > Select Sharp Edges 


Selects edges whose faces intersect at an acute angle. This 
can be useful to find hard edges in a mesh. 


Sharpness 


Determines how sharp of an angle at an edge needs to 
be in order for it to be selected. 


Select Similar 


Reference 

Mode: Edit Mode 
Menu: Select > Similar 
Shortcut: Shift-G 


Select geometry that has similar certain properties to the 
ones selected, based on a threshold that can be set in tool 
properties after activating the tool. Tool options change 
depending on the selection mode: 


Vertex Selection Mode: 
Normal 
Selects all vertices that have normals pointing in 
similar directions to those currently selected. 


Amount of Adjacent Faces 
Selects all vertices that have the same number of 
faces connected to them. 


Vertex Groups 
Selects all vertices in the same vertex group. 


Amount of Connecting Edges 
Selects all vertices that have the same number of 
edges connected to them. 


Edge Selection Mode: 
Length 
Selects all edges that have a similar length as those 
already selected. 


Direction 
Selects all edges that have a similar direction (angle) 
as those already selected. 


Amount of Faces Around an Edge 
Selects all edges that belong to the same number of 
faces. 


Face Angles 
Selects all edges that are between two faces forming 
a similar angle, as with those already selected. 


Crease 
Selects all edges that have a similar Crease value as 
those already selected. 


Bevel 
Selects all edges that have the same Bevel Weight as 
those already selected. 


Seam 
Selects all edges that have the same Seam state as 
those already selected. Seam is a mark used in UV 
texturing. 


Sharpness 
Selects all edges that have the same Sharp state as 
those already selected. Sharp is a mark used by the 
Edge Split Modifier. 


Face Selection Mode: 


Material 
Selects all faces that use the same material as those 
already selected. 


Area 


Selects all faces that have a similar area as those 
already selected. 


Polygon Sides 
Selects all faces that have the same number of edges. 


Perimeter 
Selects all faces that have a similar perimeter (added 
values of its edge lengths). 


Normal 
Selects all faces that have a similar normal as those 
selected. This is a way to select faces that have the 
same orientation (angle). 


Co-planar 
Selects all faces that are (nearly) in the same plane as 
those selected. 


Flat/Smooth 
Selects all faces with similar face shading. 


Face-Map 
Selects all faces belonging to a Face-Map. 


Freestyle Face Marks 
Selects all faces with similar Freestyle Face Marks. 


Compare 
For quantitative properties, this property selects the type 
of comparison to between the two numerical values. 


Equal: Select items with the same value as 
the active item’s chosen property. 
Greater: Select items with a larger value as the 


active item’s chosen property. 
Less: 


Select items with a smaller value as the 
active item’s chosen property. 


Threshold 


For quantitative properties, this property controls how 
close the property’s values have to be in the comparison. 


Face Regions 


Reference 


Mode: Edit Mode 
Menu: Select > Similar >» Face Regions 


Select matching features on a mesh that has multiple 
similar areas based on the topology. 


Select All by Trait 
Non-Mantifold 


Reference 
Mode: Edit Mode 
Menu: Select > Select All by Trait >» Non- 


Manifold 


Selects the Non-manifold geometry of a mesh. This entry is 
available when editing a mesh, in Vertex and Edge selection 
modes only. 


Extend 
Lets you extend the current selection. 


Wire 
Selects all the edges that do not belong to any face. 


Boundaries 
Selects edges in boundaries and holes. 


Multiple Faces 
Selects edges that belong to three or more faces. 


Non Contiguous 


Selects edges that belong to exactly two faces with 
opposite normals. 


Vertices 


Selects vertices that belong to wire and multiple face 
edges, isolated vertices, and vertices that belong to non- 


adjoining faces. 


Loose Geometry 


Reference 

Mode: Edit Mode 

Menu: Select > Select All by Trait » Loose 
Geometry 


This selection depends on the currently selected Selection 
Modes; In vertex and edge selection mode it selects all 
vertices or edges that do not form part of a face. In face 


selection mode it selects all faces that do not share edges 
with other faces. 


Interior Faces 


Reference 

Mode: Edit Mode 

Menu: Select > Select All by Trait >» Interior 
Faces 


Selects faces where all edges have more than two faces. 
Faces by Sides 


Reference 


Mode: Edit Mode 
Menu: 


Select > Select All by Trait » Faces by 
Sides 


Selects all faces that have a specified number of edges. 


Ungrouped Vertices 


Reference 

Mode: Edit Mode 

Menu: Select > Select All by Trait » Ungrouped 
Vertices 


Selects all vertices which are not part of a vertex group. 


Select More/Less 


Reference 

Mode: Edit Mode 

Menu: Select >» Select More/Less » More 
Shortcut: Ctrl-NumpadPlus 

Menu: Select >» Select More/Less » Less 
Shortcut: Ctrl-NumpadMinus 


With at least one vertex, edge, or face selected, Select 
More/Less expands or shrinks the selection. However, if 
there is only one selection in any selection mode, Less will 
deselect it. 


Face Step 
With Face Step on, each use of the tool will affect the 
size of the selection on a face by face basis. When 
deactivated, it will be based on either vertices or edges 
depending on which Selection Mode is active. 


(From left to right) initial selection, without Face 
Step, with Face Step, and in edge selection mode. 


Select Next/Previous Active 


Reference 


Mode: Edit Mode 

Menu: Select >» Select More/Less >» Next Active 

Shortcut: Shift-Ctrl-NumpadPlus 

Menu: Select >» Select More/Less » Previous 
Active 

Shortcut: Shift-Ctrl-NumpadMinus 

Next Active 


This uses selection history to select the next vertex, 
edge, or face based on the surrounding topology. Which 
means that, it will derive the next selection from the 
previous two selections. 


eo Using Next Using Next 
Initial 
SaScHon Active Active 
once. twice. 


Previous Active 
Only the last selected element will be removed. 


Select Loops 


Select Edge Loops 


Reference 

Mode: Edit Mode (Vertex or Edge select mode) 
Menu: Select > Select Loops » Edge Loops 
Shortcut: Alt-LMB, Or Shift-Alt-LMB for modifying 


existing selection. 


Holding Alt while selecting an edge selects a loop of edges 
that are connected in a line end-to-end, passing through the 
edge under the mouse pointer. Holding Shift-Alt while 
clicking adds to the current selection. 


Note 
Vertex mode 


In Vertex select mode, you can also select edge loops, by 
using the same shortcuts, and clicking on the edges (not 
on the vertices). 


Longitudinal and latitudinal edge loops. 


The left sohere shows an edge that was selected 
longitudinally. Notice how the loop is open. This is because 
the algorithm hit the vertices at the poles and is terminated 
because the vertices at the pole connect to more than four 
edges. However, the right sohere shows an edge that was 
selected latitudinally and has formed a closed loop. This is 
because the algorithm hit the first edge that it started with. 


Select Edge Loops (All Boundaries) 


All boundary edges can be selected by performing a second 
loop select action on a boundary edge. 


This can be useful for selecting boundaries for meshes that 
include triangles and n-gons, where loop select would not 
otherwise select the full boundary. 


The second loop select action is shown on the right. 


Select Face Loops 


Reference 
Mode: Edit Mode (Face or Vertex select modes) 
Shortcut: Alt-LMB Or Shift-Alt-LMB for modifying 


existing selection. 


In face select mode, holding Alt while selecting an edge 
selects a loop of faces that are connected in a line end-to- 
end, along their opposite edges. 


In vertex select mode, the same can be accomplished by 
using Ctrl-Alt to select an edge, which selects the face loop 
implicitly. 


Face loop selection. 


This face loop was selected by clicking with Alt-LMB on an 
edge, in face select mode. The loop extends perpendicular 
from the edge that was selected. 


Alt versus Ctrl-Alt in vertex select mode. 


A face loop can also be selected in Vertex select mode. 
Technically ctrl-Alt-LmB will select an Edge Ring, however, in 
Vertex select mode, selecting an Edge Ring implicitly selects 
a Face Loop since selecting opposite edges of a face 
implicitly selects the entire face. 


Select Edge Rings 


Reference 

Mode: Edit Mode 

Menu: Select >» Select Loops » Edge Rings 
Shortcut: Ctrl-Alt-LMB 


In Edge select mode, holding ctri-Alt while selecting an 
edge (or two vertices) selects a sequence of edges that are 
not connected, but on opposite sides to each other 
continuing along a face loop. 


As with edge loops, you can also select edge rings based on 
current selection, using either Select » Select Loops » Edge 
Rings. 


Note 


Vertex mode 


In Vertex select mode, you can use the same shortcuts 
when clicking on the edges (not on the vertices), but this 
will directly select the corresponding face loop... 


A selected edge loop, and a selected edge ring. 


In Fig. Aselected edge loop, and a selected edge ring. the 
same edge was clicked on, but two different “groups of 
edges” were selected, based on the different tools. One is 
based on edges during computation and the other is based 
on faces. 


Note 
Convert Selection to Whole Faces 


If the edge ring selection happened in Edge Select Mode, 
switching to Face Select Mode will erase the selection. 


This is because none of those faces had all its (four) edges 
selected, just two of them. 


Instead of selecting the missing edges manually or by 
USING Shift-Alt-LMB twice, it is easier to first switch to 
Vertex Select Mode, which will kind of “flood” the selection. 
A subsequent switch to Face Select Mode will then properly 
select the faces. 


Select Loop Inner-Region 


Reference 
Mode: Edit Mode (Edge select mode) 
Menu: Select > Select Loops >» Select Loop 


Inner-Region 


Select Loop Inner-Region selects all faces that are inside a 
closed loop of edges. While it is possible to use this operator 
in Vertex and Face selection modes, results may be 
unexpected. Note that if the selected loop of edges is not 
closed, then all connected edges on the mesh will be 
considered inside the loop. 


Loop to Region. 


This tool handles multiple loops fine, as you can see. 


This tool handles “holes” just fine as well. 


Select Boundary Loop 


Reference 


Mode: Edit Mode (Edge select mode) 
Menu: Select >» Select Loops >» Select Boundary 
Loop 


Select Boundary Loop does the opposite of Select Loop 
Inner-Region, based on all regions currently selected, it 
selects only the edges at the border (contour) of these 
islands. It can operate in any select mode, but when in Face 
mode it will switch to Edge select mode after running. 


All this is much more simple to illustrate with examples: 


Select Boundary Loop does the opposite and forces 
into Edge Select Mode. 


Select Linked 
Linked 


Reference 

Mode: Edit Mode 

Menu: Select >» Select Linked >» Linked 
Shortcut: Ctrl-L 


Select geometry connected to already selected elements. 
This is often useful when a mesh has disconnected, 
overlapping parts, where isolating it any other way would be 
tedious. To give more control, you can also enable delimiters 
in the Adjust Last Operation panel, so the selection is 
constrained by seams, sharp edges, materials or UV islands. 


With Pick Linked you can also select connected geometry 
directly under the cursor, using the L shortcut to select or 
Shift-L to deselect linked. This works differently in that it 
uses the geometry under the cursor instead of the existing 
selection. 


Shortest Path 


Reference 
Mode: Edit Mode 
Menu: Select >» Select Linked >» Shortest Path 


Shortcut: Ctrl-LMB 


Select a face or vertex path with ctrl-LMB. 


Selects all geometry along the shortest path from the active 
vertex, edge, or face to the one which was selected. 


Edge Tag (in Edge select mode only) 
This select button indicates what should be done when 
selecting a vertex path with ctrt-Lme: 


Select 
Just selects all the edges in the path. 


Tag Seam 
Marks all edges in the path as seams for UV 
unwrapping. 


Tag Sharp 
Marks all edges in the path as sharp for the Edge Split 
Modifier. 


Tag Crease 
Marks all edges in the path as creases for the 
Subdivision Surface Modifier, with weight 1.0. 


Tag Bevel 
Gives bevel weight 1.0 (for the Bevel Modifier) to all 
edges in the path. 


Tag Freestyle Edge Mark 
Marks all edges in the path as Freestyle edges. 


Face Stepping 
Supports diagonal paths for vertices and faces, and 
selects edge rings with edges. 


Topological Distance 
Only takes into account the number of edges of the path 
and not the length of the edges to calculate the 
distances. 


Fill Region Shift-Ctrl-LMB 
Selects all elements in the shortest paths from the active 
selection to the clicked area. 


Checker Deselect Options 
Allows to quickly select alternate elements in a path. 


Deselected 
The number of deselected elements in the repetitive 
sequence. 


Selected 
The number of selected elements in the repetitive 
sequence. 


Offset 
Offset from the starting point. 


Linked Flat Faces 


Reference 


Mode: Edit Mode 
Menu: Select >» Select Linked >» Linked Flat 
Faces 


Selects all connected faces with a similar angle. 


Sharpness 
Select connected faces with a reference angle less than 


the value specified. 


Looking at the image above, when at least one face is 
selected (as seen on the left), Linked Flat Faces will select 
all connecting faces that lie on the same or similar plane (as 
shown in the middle image). If the corners are smoothed, 
those faces are no longer lined up with the selected faces. 
At this point, increasing the Sharpness value in the tool 
options could include the smoothed faces. 


Side of Active 


Reference 
Mode: Edit Mode 
Menu: Select > Side of Active 


With an active vertex, this tool will select all vertices ina 
specified direction. It is similarly to the Loop Inner-Region 
tool in that it will fill select faces within its perimeters, 
however, it is determined by direction and not by a closed 
loop. 


Axis Mode 
Determines the behavior of the selection. More 
information on this can be found in Iransform 
Orientations. 


Axis Sign 
Positive/Negative Axis 
Depending on which Axis is chosen, the selection will 
encompass the positive or negative axis starting from 
the active vertex outward. 


Aligned Axis 
Where Positive and Negative Axis select all vertices in 
a given direction, Aligned Axis will only select the 
vertices that are in-line with the active vertex. 


While following along the X axis: (from left to right) 
active vertex, Aligned, Positive, and Negative. 


Axis 
Chooses the direction of the selection. 


Threshold 
The amount of influence the selection has outside the 
Original perimeters. The higher the Threshold the more 
vertices will be selected. 


Select Mirror 


Reference 

Mode: Edit Mode 

Menu: Select >» Select Mirror 
Shortcut: Shift-Ctri-M 


Select Mirror flips a selection to the opposite side of the 
mesh. 


Axis 
Choose on which axis the selection will occur. The axis is 
based on the meshes origin. Therefore, if the origin is not 
centered within the mesh, the selection will have varying 
results. 


Extend 
The new selection will include the mirrored selection as 


well as the original. 


(From left to right) initial selection, after Select 
Mirror on the X axis, with Extend. 


Tip 


With Extend activated, hold shift while choosing an axis to 
include more than one axis in the selection. Otherwise, 
with Extend off, the mirror will take into account two to 
three axes. 


Example 


(From left to right) initial selection, mirrored along X 
and Z axes, with Extend. 


Editing 


e Introduction 

o Accessing _Mesh Tools 
e Mesh Tools 
Transformation 
Mirror 
Duplicate 
Extrude 
Merge 
Split 
Separate 
Bisect 
Knife Project 
Knife Topology Tool 
Convex Hull 
Symmetrize 
snap to Symmetry 
Normals 
Shading 
Sort Elements 
Clean Up 
Deleting _& Dissolving 
e Vertex Tools 
Extrude Vertices 
Extrude to Cursor or Add 
Bevel Vertices 
New Edge/Face from Vertices 
Connect Vertex Path 
Connect Vertex Pairs 
Rip Vertices 
Rip Vertices and Fill 
Rip Vertices and Extend 
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Slide Vertices 
Smooth Vertices 
Laplacian Smooth 
Blend from Shape 
Propagate to Shapes 
Vertex Groups 

o Hooks 

o Make Vertex Parent 
e Edge Tools 

o Extrude Edges 

o Bevel Edges 

o Bridge Edge Loops 
Screw 
Subdivide 
Subdivide Edge-Ring 
Un-Subdivide 
Rotate Edge 
Edge Slide 
Offset Edge Slide 
Loop Cut and Slide 

o Edge Data 
e Face Tools 

o Extrude Faces 
Extrude Faces Along Normals 
Extrude Individual Faces 
Inset Faces 
Poke Faces 
Triangulate Faces 
Triangles to Quads 
Solidify Faces 
Wireframe 
Fill 
Grid Fill 
Beautify Faces 
Intersect (Knife) 
Intersect (Boolean) 
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o Weld Edges into Faces 
o Shade Smooth & Flat 
o Face Data 
e UV Tools 
o Unwrap 
Smart UV Project 
Lightmap Pack 
Follow Active Quads 
Cube Projection 
Cylinder Projection 
Sphere Projection 
Project from View 
Project from View (Bounds) 
Reset 
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Introduction 


Blender provides a variety of tools for editing meshes. These 
are tools used to add, duplicate, move and delete elements. 


These are available through the Menus in the 3D Viewport 
header, and context menus in the 3D Viewport, as well as 
individual shortcut keys. 


Note 


All the “transform precision/snap” keys ctrl and/or Shift 
also work for all these advanced operations, but most of 
them do not have axis locking possibilities, and some of 
them do not take into account the pivot point and/or 
transform orientation either. 


These transform tools are available in the Transform section 
of the Mesh menu in the header. Note that, some of these 
can also be used on other editable objects, like curves, 
surfaces, and lattices. 


Accessing Mesh Tools 


The mesh tools are found in various places, and available 
through shortcuts as well. 


Menus 


These menus are located in the header. Some of the menus 
can be accessed with shortcuts: 


e Ctrl-F brings up the Face tool menu 
e Ctrl-E brings up the Edge tool menu 
e Ctrl-v brings up the Vertex tool menu 


Mesh Tools 


Transformation 
o Move, Rotate, Scale 
Jo Sphere 
Shear 
Bend 
Push/Pull 
Warp 
Randomize 
Shrink Fatten 
o Skin Resize 
Mirror 
o Axis of Symmetry 
o Pivot Point 
o Transformation Orientations 
Duplicate 
Extrude 
Extrude Faces 
Extrude Faces Along Normals 
Extrude Individual Faces 
Extrude Manifold 
Extrude Edges 
Extrude Vertices 
Extrude Repeat 
spin 
rge 
o By Distance 
li 
° Selection 
o Faces by Edges 
o Faces & Edges by Vertices 
Separate 
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e Bisect 
o Controls 
o Examples 
Knife Project 
o Options 
o Examples 
o Known Limitations 
Knife Topology Tool 
o Usage 
o Tool Settings 
0 Controls 
o Known Limitations 
Convex Hull 
Symmetrize 
Snap to Symmetry 
Normals 
o Flip 
Recalculate 
Set from Faces 
Rotate 
Point to Target 
Merge 
Split 
Average 
Copy Vectors 
Paste Vectors 
Smooth Vectors 
Reset Vectors 
Select by Face Strength 
Set Face Strength 
e Shading 
e Sort Elements 
e Clean Up 
o Decimate Geometry 
o Fill Holes 
o Make Planar Faces 
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Split Non-Planar Faces 
Split Concave Faces 
Delete Loose 
Degenerate Dissolve 
Merge by Distance 
e Deleting & Dissolving 

o Delete 

o Dissolve 
o Limited Dissolve 
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Collapse Edges & Faces 
Edge Loops 


Transformation 


Move, Rotate, Scale 
To Sphere 

Shear 

Bend 

Push/Pull 

Warp 

Randomize 

Shrink Fatten 

Skin Resize 


Move, Rotate, Scale 


Reference 

Mode: Edit Mode 

Tool: Toolbar >» Move, Rotate, Scale 

Menu: Mesh > Transform > Move, Rotate, Scale 
Shortcut: G, R, S 


Once you have a selection of one or more elements, you can 
move G, rotate R or scale s them, like many other things in 
Blender, as described in the Manipulation in 3D Space 
section. To move, rotate and scale selected components, 
either use the Move, Rotate, and Scale buttons, the 
transform gizmos, or the shortcuts: G, R, and Ss respectively. 


After moving a selection, the options in the Adjust Last 
Operation panel allow you to fine-tune your changes, limit 
the effect to certain axes, turn Proportional Editing on and 
off, etc. Of course, when you move an element of a given 
type (e.g. an edge), you also modify the implicitly related 
elements of other kinds (e.g. vertices and faces). 


Pressing G twice enters either Edge Slide or Vertex Slide tool 
depending on the selection. You also have in Edit Mode an 
extra option when using these basic manipulations: the 
Proportional Editing. 


Transform Panel 


Reference 


Mode: Edit Mode 
Panel: Sidebar region > Transform 


When nothing is selected, the panel is empty. When more 
than one vertex is selected, the median values is edited and 
“Median” is added in front of the labels. 


Vertex 


The first controls (X, Y, Z) show the coordinates of the 
selected vertex or the median point. 


Space 
The Space radio buttons let you choose if those 
coordinates are relative to the object origin (local) or the 
global origin (global). 


Global, Local 


Vertex Data 


Bevel Weight 
This vertex property, a value between (0.0 to 1.0), is 
used by the Bevel Modifier to control the bevel intensity 
of the vertices, when the Only Vertices option is active. 


Crease 
This vertex property, a value between (0.0 to 1.0), is 
used by the Subdivision Surface Modifier to control the 
sharpness of the vertices in the subdivided mesh. 


Edge Data 


When an edge is selected, the following options are 
available. More buttons appear: 


Bevel Weight 
This edge property, a value between (0.0 to 1.0), is used 
by the Bevel Modifier to control the bevel intensity of the 
edges. 


This property can also be set using the Edge Bevel 
Weight operator. 


Crease 
This edge property, a value between (0.0 to 1.0), is used 
by the Subdivision Surface Modifier to control the 
sharpness of the edges in the subdivided mesh. 


To Sphere 


Reference 

Mode: Object and Edit Modes 

Menu: Mesh » Transform > To Sphere 
Shortcut: Shift-Alt-S 


The To Sphere transformation will give the selection 
spherical qualities. The Fig. Monkey with increasing 
sphericity. below shows the results of applying the To 
Sphere transformation to the monkey mesh. 
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Monkey with increasing sphericity. 


The sequence above shows a monkey mesh with a 
0, 0.25 (25%), 0.5 (50%) and 1 (100%) To Sphere 
transform applied. 


Usage 


Disable 


J“ Smooth 


To Sphere Factor. 


As can be seen in the below image, the result will be 
smoother and more spherical when there are more mesh 
elements available to work with. 


To Sphere applied to cubes with different subdivision 
levels. 


In this image sequence, To Sphere was applied to 
the entire cube at levels of 0, 0.25 (25%), 0.5 (50%) 
and 1 (100%) respectively. 


The To Sphere transform will generate different results 
depending on the number and arrangement of elements 
that were selected (as shown by the below image). 


To Sphere applied to different selections. 


Shear 


Reference 

Mode: Object and Edit Mode 

Tool: Toolbar >» Shear 

Menu: Object/Mesh/Curve/Surface » Transform 
>» Shear 

Shortcut: Shift-Ctrl-Alt-S 


Shearing is a form of movement where parallel surfaces 
move past one another. During this transform, movement of 
the selected elements will occur along the horizontal axis of 
the current view. The axis location will be defined by the 
Pivot Point. Everything that is “above” this axis will move 
(shear) in the same direction as your mouse pointer (but 
always parallel to the horizontal axis). Everything that is 
“below” the horizontal axis will move in the opposite 
direction. 


Disable 


J Smooth 


Shear Offset Factor. 


Tool Settings 


Offset 
How far items are shifted from their original location. 


Axis 
Defines one axis of the imaginary shearing plane. 


Axis Orthographic 
Defines the other axis of the imaginary shearing plane. 


Orientation 
See Transform Orientations. 


Proportional Editing 
See Proportional Editing. 


Warning 
The Axis and Axis Orthographic cannot be the same axis, 


else the imaginary plane is dimensionless and the objects 
will disappear into a point. 


Usage 


See below for the result of using Shear on a number of 
different elements. 


The effects of a Shear transform with different Pivot 
Points. 


The three frames of the image above show the effects of 
Shearing on the selected vertices when the pivot point is 
altered. In middle frame, the Pivot Point is set to Median 
Point and the mouse was moved to the left during the 
transform. In right frame, the Pivot Point is set to the 3D 
cursor which is located above the mesh. When the mouse is 
moved to the left during a Shear transform, the selected 


vertices are moved to the right as they are below the 
horizontal axis. 


Tip 

Shear Transform Magnitude 

The magnitude of the Shear transform applied to the 
selected elements is directly proportional to the distance 


from the horizontal axis. i.e. the further it is away from the 
axis, the greater the movement. 


The effects of a Shear transform on objects with 
different Pivot Points. 


Bend 


Reference 

Mode: Object and Edit Modes 

Menu: Object/Mesh/Curve/Surface » Transform 
>» Bend 

Shortcut: Shift-W 


Bend Transform with Clamp on and off. 


Before. Clamp on. Clamp off. 


This tool rotates a line of selected elements forming an arc 
between the mouse cursor and the 3D cursor. 


Usage 


The Bend tool can be used in any case where you might 
want to bend a shape in two with a gradual transition 
between both sides. 


This may take a little getting used to, the basics are listed 
below controls are noted here: 


e The initial position of the cursors define the axis to bend 
on. 


e The distance of the mouse cursor to the 3D cursor 
controls how sharp the bend will be. 

e The relative angle of the mouse cursor to the initial axis 
defines the bend angle. 


If this seems overly complicated, it’s probably best to try 
the tool where it becomes quickly apparent how the tool 
reacts to your input. 


Bend Angle 
The amount of rotation. 


Radius 
The sharpness of the bend. 


Clamp 
Normally the arc turns through a clamped rotation angle 
with the selected elements extended along a tangent line 
beyond that (see above left). When the clamp is 
deactivated, the arc continues around aligning the 
selected elements into a circle (right). 


When off Att all selected elements follow a circle, even 
when outside the segment between the 3D cursor and 
the mouse. 


Note 


Unlike most other transform modes, Bend is not effected 
by Pivot Point or Transform Orientation, always using the 
View Plane instead. 


Hint 


You can turn the bend angle through multiple rotations 
potentially forming a spiral shape. 


Bend Transform example. 


Push/Pull 


Reference 

Mode: Object and Edit Modes 

Tool: Toolbar >» Shrink/Flatten >» Push/Pull 
Menu: Object/Mesh > Transform >» Push/Pull 


Push/Pull will move the selected 
elements (objects, vertices, edges or st = 
faces) closer together (Push) or further 
apart (Pull). Specifically, each element 
is moved towards or away from the 
center by the same distance. This 
distance is controlled by moving the 
mouse up (Push) or down (Pull), 
numeric input or through slider control. 


Disable 


J“ Smooth 


Push/Pull distance. 


Usage 


See below for the result of using Push/Pull on a number of 
different elements. 


Equidistant objects being pushed together. 


eo 
= 


Random objects being pushed together. 


Push (middle) vertices around the 3D cursor 
compared to Scale (right). 


Warp 


Reference 
Mode: Edit Modes 
Menu: Object/Mesh/Curve/Surface » Transform 


>» Warp 


The Warp transformation takes selected 
elements and warps them around the 
3D cursor by a certain angle. Note that 
this transformation is always dependent 
on the location of the 3D cursor. The 
Pivot Point is not taken into account. 
The results of the Warp transformation 
are also view dependent. 


Warp tool options. 


Usage 


In this example, a plane is warped around the 3D cursor by 
the indicated number of degrees. 


Before. Warp Angle 90. 


Warp Angle 180. Warp Angle 360. 


Cursor Position & View 


The location of the 3D cursor can be used to alter the 
results of the Warp transformation. As can be seen from the 
example in this section, the Warp radius is dependent on 
the distance of the cursor from the selected elements. The 
greater the distance, the greater the radius. 


The result of the Warp transform is also influenced by your 
current view. The example in this section shows the results 
of a 180 degree Warp transform applied to the same Plane 
mesh when in different views. 


This image shows how the Warp transform is influenced by 
the location of the cursor. 


Before. Warp Angle 180. 


Before. Warp Angle 180. 


This image shows the influence of the current view. 


Warp Angle 180 in 


Before. XZ view. 


Warp Angle 180 in Warp Angle 180 in 
YZ view. User view. 


Note 
Warping text 


If you want to warp text, you will need to convert it from a 
text object to mesh using Convert. 


Example 


Text wrapped around logo. 


This was made by creating the Blender logo and text as 
separate objects. The text was converted to a mesh and 
then warped around the Blender logo. 


Randomize 


Reference 
Mode: Edit Mode 
Menu: Mesh > Transform >» Randomize 


The Randomize tool in Edit Mode allows you to displace the 
vertices of a mesh along their normal. 


Amount 
Distance of the displacement. 


Uniform 
Adds a random offset of the amount. 


Normal 
Adds a random offset to the displacement normal. 


Random Seed 
The random seed is an offset to the random 
transformation. A different seed will produce a new 
result. 


See also 


Object Mode Randomize Transform 


Shrink Fatten 


Reference 

Mode: Edit Mode 

Tool: Toolbar > Shrink/Fatten 

Menu: Mesh » Transform » Shrink Fatten 
Shortcut: Alt-S 


This tool moved selected vertices/edges/faces along their 
own normal (perpendicular to the face), which, on “standard 
normal meshes”, will shrink/fatten them. 


This transform tool does not take into account the pivot 
point or transform orientation. 


Offset Even Ss, Alt 
Scale the offset to give it a more even thickness. A 
greater offset factor is obtained vertices, which share 
faces, forming a more acute angle. 


Inflated Shrunk 
using a using a 
Mesh before positive negative 


shrink/fatten. value. value. 


Skin Resize 


Reference 

Mode: Edit Mode 

Menu: Mesh » Transform > Skin Resize 
Shortcut: Ctrl-A 


This tool is used to set a skin radius per vertex when using a 
Skin Modifier. Non-uniform scaling of the X and Y axes is 
accessible by the usual axis locking with x or y. The radius 
can also be adjusted in the Transform panel of the Sidebar, 
in the 3D Viewport. The mean radius of all vertices can be 


previewed in the 3D Viewport as a dashed circle around a 
vertex. 


Simple creature, made with only the Skin and 
Subdivision Surface modifiers. 


Mirror 


Reference 

Mode: Edit Mode 
Menu: Mesh » Mirror 
Shortcut: Ctrl-M 


The Mirror tool mirrors a selection across a selected axis. 


The Mirror tool in Edit Mode is similar to Mirroring_in Object 
Mode. It is exactly equivalent to scaling vertices by -1 
around one chosen pivot point and in the direction of one 
chosen axis, only it is faster/handier. 


After this tool becomes active, select an axis to mirror the 
selection by pressing x, Y, or Z. 


You can also interactively mirror the geometry by holding 
the mMB and dragging in the desired mirror direction. 


Axis of Symmetry 


For each transformation orientation, you can choose one of 
its axes along which the mirroring will occur. 


As you can see, the possibilities are infinite and the freedom 
complete: You can position the pivot point at any location 
around which we want the mirroring to occur, choose one 
transformation orientation and then one axis on it. 


Pivot Point 


Pivot points must be set first. Pivot points will become the 
center of symmetry. If the widget is turned on it will always 
show where the pivot point is. 


In Fig. Mirror around the individual origins. the pivot point 
default to median point of the selection of vertices in Edit 
Mode. This is a special case of the Edit Mode as explained 
on the pivot point page. 


Mirror around the individual origins. 


Mesh after mirrored 
along X axis. 


Mesh before mirror. 


In Fig. Mirror around the 3D Cursor. the pivot point is the 3D 
Cursor, the transformation orientation is Local, a.k.a. the 
object space, and the axis of transformation is X. 


Mirror around the 3D Cursor. 


Mesh before mirror. Mesh after mirrored 
along X axis using 


the 3D cursor asa 
pivot point. 


Transformation Orientations 


Transformation Orientations are found on the 3D Viewport 
header, next to the Widget buttons. They decide which 
coordinate system will rule the mirroring. 


Duplicate 


Reference 

Mode: Edit Mode 
Menu: Mesh > Duplicate 
Shortcut: Shift-D 


This tool simply duplicates the selected elements, without 
creating any connections with the rest of the mesh (unlike 
extrude, for example), and places the duplicate at the 
location of the original. Once the duplication is done, only 
the new duplicated elements are selected, and you are 
automatically placed in move mode, so you can move your 
copy elsewhere... 


In the Toolbar are settings for Vector offset, Proportional 
Editing, Duplication Mode, and Axis Constraints. 


Note that duplicated elements belong to the same vertex 
groups as the “original” ones. The same goes for the 
material indices, the edge’s Sharp and Seam marks, and 
probably for the other vertex/edge/face properties... 


Extrude 


Reference 

Mode: Edit Mode 
Menu: Mesh >» Extrude 
Shortcut: ALt-E 


Extrude Faces 


See Extrude Faces. 


Extrude Faces Along Normals 


See Extrude Faces Along Normals. 


Extrude Individual Faces 


See Extrude Individual Faces. 


Extrude Manifold 


See Extrude Manifold. 


Extrude Edges 


See Extrude Edges. 


Extrude Vertices 


See Extrude Vertices. 


Extrude Repeat 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Extrude >» Extrude Repeat 


This tool behaves similar to the Array Modifier, by extruding 
the selection along the Z axis of the view. If the selection is 
not Manifold it’s extruded the specified number of times. 


Offset X, Y, Z 
Distance between the instances. 


Steps 
Number of instances. 


Scale Offset 
Multiplication factor to increase or decrease the offset. 


Spin 


See Spin. 


Merge 


Reference 

Mode: Edit Mode 

Menu: Mesh > Merge, Context Menu >» Merge 
Shortcut: M 


This tool allows you to merge all selected vertices to a 
unique one, dissolving all others. You can choose the 
location of the remaining vertex in the menu this tool pops 
up before executing: 


At Center 
It will place the remaining vertex at the center of the 
selection. Available in all select modes. 


At Cursor 
It will place the remaining vertex at the 3D Cursor. 
Available in all select modes. 


Collapse 
Every island of selected vertices (connected by selected 
edges) will merge on its own median center, leaving one 
vertex per island. 


At First 
It will place the remaining vertex at the location of the 
first one selected. Only available in Vertex select mode. 


At Last 
It will place the remaining vertex at the location of the 
last one selected (the active one). Only available in 
Vertex select mode. 


Merging vertices of course also deletes some edges and 
faces. But Blender will do everything it can to preserve 
edges and faces only partly involved in the reunion. 


Note 


At First and At Last depend on that the selection order is 
saved: the order is lost, for instance, after changing 
selection mode. 


UVs 
If UVs is ticked in the Adjust Last Operation panel, the UV 


mapping coordinates, if existing, will be corrected to 
avoid image distortion. 


By Distance 


Todo. 


Split 


Reference 

Mode: Edit Mode 

Menu: Mesh » Split 
Shortcut: Alt-M 
Selection 

Reference 

Mode: Edit Mode 

Menu: Mesh » Split » Selection 
Shortcut: Y 


Splits (disconnects) the selection from the rest of the mesh. 


The border edge to any non-selected elements are 
duplicated. 


Note that the “copy” is left exactly at the same position as 
the original, so you must move it G to see it clearly... 


Faces by Edges 


Reference 


Mode: Edit Mode 
Menu: Mesh » Split » Faces by Edges 


Faces by Edges is similar to the Rip tool. When two or more 
touching interior edges, or a border edge is selected, a hole 
will be created, and the selected edges will be duplicated to 
form the border of the hole. 


Adjacent face moved 
Selected edges. to reveal hole left by 
split. 


Faces & Edges by Vertices 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Split » Faces & Edges by Vertices 


Faces & Edges by Vertices is similar to Faces by Edges 
except that it also splits the vertices of the adjacent 
connecting edges. This has the same functionality as 
manually ripping all faces and edges away from a vertex. 


Before. After (also moving 
edges away). 


Separate 


Reference 

Mode: Edit Mode 
Menu: Mesh >» Separate 
Shortcut: p 


At some point, you will come to a time when you need to cut 
parts away from a mesh to be separate. 


To separate an object, the vertices (or faces) must be 
selected and then separated, though there are several 
different ways to do this. 


Suzanne dissected neatly. 


Selection 
Separates the selected elements. 


By Material 


Separates fragments based on the materials assigned to 
the different faces. 


By Loose Parts 
Creates one object for every independent (disconnected) 
fragment of the original mesh. 


Bisect 


Reference 

Mode: Edit Mode 

Tool: Toolbar > Knife > Bisect 
Menu: Mesh » Bisect 


The Bisect tool is a quick way to cut a mesh in two along a 
custom plane. 


Use LmB click and drag to draw cut line. Once the cut is done 
the Adjust Last Operation panel gives a few options: 


Plane Point, Plane Normal 
The plane can be numerically adjusted for precise values. 


Fill 
Cuts can optionally fill in the holes created, with 


materials, UV maps, and Color Attributes based on the 
surrounding geometry. 


Clear Inner, Clear Outer 
Cuts may remove geometry on one side. 


Axis Threshold 
Cut along the straight plane or along the existing 
geometry below the distance from the plane. 


Controls 


Move Spacebar 
Changes the location of the line. 


Snap Ctrl 
Constrains the rotation of the line to 15 degree intervals. 


Flip F 


Changes the side of the line that is the inner/outer side; 


this option is useful when using Clear Inner, Clear Outer 
and/or Fill. 


Examples 


Example of bisect 


Example of a with the fill option 
common use of enabled. 


bisect. 


Knife Project 


Reference 
Mode: Edit Mode 
Menu: Mesh » Knife Project 


Knife projection is a non-interactive tool where you can use 
objects to cookie-cut into one or more meshes rather than 
hand drawing the line. The outline of selected objects that 
are not in Edit Mode are used to cut the meshes along the 
view axis of objects that are in Edit Mode. Afterwards the 
resulting geometry inside the cutters outline will be 
selected. Outlines can be a wireframe or boundary edges 
(i.e. the unconnected edges of a mesh), as well as Curve 
objects. 


Keep in mind that Knife Project works from the current 
view’s perspective. For best results, make sure to rotate 
your view to exactly the position you require before using 
this tool. Orthographic views such as Right, Front, and Top 
are commonly used for more predictable results. 


Note 


The primitives, being manifold objects, do not have 
wireframe or boundary edges. In the case of the cube, 
deleting the top face will result in cutting edges. Select 
Non-Manifold (Wire, Boundaries) will highlight the cutting 
edges of mesh objects. 


In general, for flat shapes, you will usually want to select 
“Faces Only” from the delete menu to leave behind only 


edges. 


To use Knife Project, first in Object Mode select the objects 
to be cut, then switch to Edit Mode and select the cutting 
objects in the Outliner (ctri-LmB), and finally choose Mesh » 
Knife Project. 


Hint 


3D Viewport Alignment to adjust the projection axis. 


Options 


Cut Through 
Projects the cut through the entire mesh, including back 
faces not currently visible. 


Examples 


Before projecting Resulting knife 
from a text object. projection. 


Before projecting Resulting knife 
from a mesh object. projection (extruded 
after). 


Before projecting Resulting knife 
from a 3D curve projection (extruded 
object. after). 


Known Limitations 


When cutting multiple meshes in Edit Mode at once, 
geometry from these meshes does not occlude separate 
mesh objects behind them. 


Knife Topology Tool 


Reference 

Mode: Edit Mode 

Tool: Toolbar » Knife 

Menu: Mesh » Knife Topology Tool 
Shortcut: K 


The Knife tool can be used to interactively subdivide (cut 
up) geometry by drawing lines or closed loops to create 
holes. 


Usage 


When using Knife, the cursor changes to an icon of a scalpel 
and the header changes to display options for the tool. You 
can draw connected straight lines by clicking LB, marked 
with small green squares. Red squares are already defined 
cuts. Surrounding red squares mean that there is a cut 
already in that position, so no additional vertex will be 
created (besides the first one). 


If multiple objects are selected before entering Edit Mode, 
then knife cuts will affect all of those objects. 


Mesh Knife cut After 
before active. confirming 
knife cut. knife cut. 


Tool Settings 


Occlude Geometry 
Only cut geometry visible on screen. 


Only Selected Shift-K 
Only cuts through selected geometry. 


X-Ray 
Show cut points on non-visible geometry too, when 
Occlude Geometry is deactivated. 


Measurement 
Which visible measurements to show. 


Distance, Angle, None, Both 


Angle Snapping 
Whether or not dragged lines should be constrained to 
particular angles, and if so, which coordinate system the 
angle is relative to. 


None, Screen, Relative 


Angle Snapping Increment 


When angle snapping is on, the angle will be constrained 
to a multiple of this angle. 


Controls 


Confirm Spacebar or Return 


Confirms the cut. Return will leave selected every edge 
except the new edges created from the cut. 


Cancel Esc 
Cancels the cut. 


Draw a Continuous Line LmB drag. 


So you can draw a free-hand line over a surface, points 
will be created at edge intersections. 


Close Loop double-click LMB 


This is a quick way to close the loop you are currently 
cutting. 


New Cut RMB 
Begins a new cut. This allows you to define multiple 
distinct cut lines. If multiple cuts have been defined, they 
are recognized as new snapping points. 


Result of starting 
new cuts while in 
the tool. 


Creating multiple 
cuts. 


Midpoint Snap Shift 


Hold to snap the cursor to the midpoint of edges, 
meaning that all cuts will be performed at the exact 
center of each cut edge. 


Ignore Snap Ctrl 
Hold to make the tool ignore snapping, unlike the default 
where mouse cursor snaps to near edges. 


Cut Through: c 
Allow the Cut tool to cut through to occluded faces, 
instead of only the visible ones. 


Angle Constrain A 
Constrains the cut line to certain degree increments. The 
increment can be specified in the Tool Settings (see 
above), or can be typed when angle constraining is 
active. The default angles are in the plane of the screen, 
but typing A again makes it relative to the last cut edge. 
If the last cut edge is ambiguous (because the cut was on 
a vertex), typing R cycles through the possible reference 
edges. 


i 


Result of 
constraining cut 
angle. 


Constraining cut 
angle. 


Axis Constrain xX, Y, or Z 
Constrains the cut line to one of the coordinate system 
axes. Initially it will be the global axis with the given 
name, but pressing the same key again switches to the 
object’s local axis system. Additionally, if the scene 
transformation orientation is set to a custom orientation 
(e.g. from a face), the constraints will be in that 
coordinate system. 


Visible Measurements s 
Shows measurements of the cuts being made: angles 
with respect to a mesh edge, lengths, or both. Pressing s 
repeatedly cycles between what can be shown. 


Only Distance, Only Angles, Both, None 


Both 
Only Angles 
Distance. and 
Distance. 
Undo Ctrt-Z 


Undoes the previous cut segment. The starting point for 
the next cut is adjusted accordingly. If a cut is a drag cut, 
the entire drag cut is undone. 


X-Ray Mode v 
Toggles whether or not cuts to segments behind the 
visible geometry are shown. 


Known Limitations 


Duplicate Vertices 


If you experience problems where duplicate vertices are 
being created by cuts, this is often caused by too large a 
near/far clipping range. 


Try increasing the Clip Start to avoid this problem, see 
Depth Troubleshooting for details. 


Unconnected Cuts 


Cuts that begin or end in the middle of a face, will be 
ignored. 


This is constrained by the kinds of geometry Blender can 
represent. 


Convex Hull 


Reference 
Mode: Edit Mode 
Menu: Mesh » Convex Hull 


The Convex Hull operator takes a point cloud as input and 
outputs a convex hull surrounding those vertices. If the 
input contains edges or faces that lie on the convex hull, 
they can be used in the output as well. This operator can be 
used as a bridge tool as well. 


Input mesh, point cloud, and Convex Hull result. 


Delete Unused 
Removes vertices, edges, and faces that were selected, 
but not used as part of the hull. Note that vertices and 
edges that are used by other edges and faces not part of 
the selection will not be deleted. 


Use Existing Faces 
Where possible, use existing input faces that lie on the 
hull. This allows the convex hull output to contain n-gons 


rather than triangles (or quads if the Join Triangles option 
is enabled). 


Make Holes 
Delete edges and faces in the hull that were part of the 
input too. Useful in cases like bridging to delete faces 
between the existing mesh and the convex hull. 


Join Triangles 
Joins adjacent triangles into quads. Has all the same 
properties as the Tris to Quads operator (angle limit, 
compare UVs, etc.). 


Max Face Angle, Max Shape Angle, Compare 
See Triangles to Quads. 


Symmetrize 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Symmetrize 


The Symmetrize tool is a quick way to make a mesh 
symmetrical. Symmetrize works by cutting the mesh at the 
pivot point of the object, and mirroring over the geometry in 
the specified axis, and merges the two halves together (if 
they are connected). Also the mesh data is copied from one 
side to the other: e.g. UVs, colors attributes, vertex weights. 


Direction 
Specify the axis and direction of the effect. Can be any of 
the three axes, and either positive to negative, or 
negative to positive. 


Threshold 
The vertices in this range will be snapped to the plane of 
symmetry. 


Mesh before Mesh after 
Symmetrize. Symmetrize. 


See also 


See Mirror for information on mirroring, which allows you 
to flip geometry across an axis. 


Snap to Symmetry 


Reference 
Mode: Edit Mode 
Menu: Mesh > Snap to Symmetry 


The Snap to Symmetry tool lets you snap a mesh vertices to 
their mirrored neighbors. 


Useful when dealing with meshes which are mostly 
symmetrical, but have vertices which have been moved 
enough that Blender does not detect them as mirrored 
(when X Mirror option is enabled for example). 


This can be caused by accident when editing without X 
Mirror enabled. Sometimes models imported from other 
applications are asymmetrical enough that mirror fails too. 


Direction 
Specify the axis and direction to snap. Can be any of the 
three axes, and either positive to negative, or negative to 
positive. 


Threshold 
Specify the search radius to use when finding matching 
vertices. 


Factor 
Support for blending mirrored locations from one side to 
the other (0.5 is an equal mix of both). 


Center 
Snap vertices along the center axis to zero. 


Before Snap to After Snap to 
Symmetry. Symmetry. 


Normals 


See also 

The Normal Edit Modifier can be used to edit normals. 
The Weighted Normal Modifier can be used to affect 
normals by various methods, including Face Strength (see 
below). 


You can also copy normals from another mesh using Mesh 
Data Transfer (operator or modifier). 


Flip 


Reference 
Mode: Edit Mode 
Menu: Mesh > Normals » Flip 


This will reverse the normals direction of all selected faces. 
Note that this allows you to precisely control the direction 
(not the orientation, which is always perpendicular to the 
face) of your normals, as only the selected faces are flipped. 


Recalculate 


Reference 


Mode: Edit Mode 


Menu: Mesh > Normals >» Recalculate Outside 


and Mesh > Normals > Recalculate Inside 
Shortcut: Shift-N and Shift-Ctrl-N 


These tools will recalculate the normals of selected faces so 
that they point outside (respectively inside) the volume that 
the face belongs to. The volume does not need to be closed; 
inside and outside are determined by the angles with 
adjacent faces. This means that the face of interest must be 
adjacent to at least one non-coplanar other face. For 
example, with a Grid primitive, recalculating normals does 
not have a meaningful result. 


Set from Faces 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Normals » Set from Faces 


Set the custom normals at corners to be the same as the 
face normal that the corner is part of. 


Rotate 

Reference 

Mode: Edit Mode 

Menu: Mesh > Normals » Rotate 
Shortcut: RN 


This is an interactive tool. AS you move the mouse around, 
the selected normals are rotated. You can also invoke the 


Rotate Normals tool by pressing the Rotate transform key R, 
followed by N. 


Point to Target 


Reference 

Mode: Edit Mode 

Menu: Mesh >» Normals > Point to Target 
Shortcut: Alt-L 


All selected normals are set to point from their vertex to the 
target after confirmed by Return or LMB. 


A target is set by the keys: 


e The mouse cursor M 

e The pivot L 

e The object origin 0 

e The cursor (set at this click) Ctrl-LMB 

e A mesh item selection (set by this click) Ctr1-RMB 


Mode 
The tool operation can be modified; if one of the 
following keys has been previously pressed: 
Align A 
All normals will point in the same direction: from the 
center of selected points to the target. 


Spherize s 


Each normal will be an interpolation between its 
original value and the direction to the target. 


Invert I 


The normal directions are reversed from what was 
specified above. 


Reset R 


Will reset the custom normals back to what they were 
when the operation started. 


Merge 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Normals >» Merge 


Merge all of the normals at selected vertices, making one 
average normal for all of the faces. 


Split 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Normals » Split 


Split the normals at all selected vertices so that there are 
separate normals for each face, pointing in the same 
direction as those faces. 


Average 


Reference 


Mode: Edit Mode 
Menu: Mesh > Normals >» Average 


Average all of the normals in each fan of faces between 
Sharp edges at a vertex. 


Copy Vectors 


Reference 


Mode: Edit Mode 
Menu: Mesh > Normals » Copy Vectors 


If a single normal is selected, copy it to an internal vector 
buffer. 


Paste Vectors 


Reference 


Mode: Edit Mode 
Menu: Mesh > Normals » Paste Vectors 


Replace the selected normals with the one in the internal 
vector buffer. 


Smooth Vectors 


Reference 


Mode: Edit Mode 
Menu: Mesh > Normals >» Smooth Vectors 


Adjust the normals to bring them closer to their adjacent 
vertex normals. 


Reset Vectors 


Reference 
Mode: Edit Mode 
Menu: Mesh > Normals >» Reset Vectors 


Put normals back the to default calculation of the normals. 


Select by Face Strength 


Reference 
Mode: Edit Mode 
Menu: Mesh > Normals >» Select by Face 


Strength 


Another way to affect normals is to set a Face Strength on 
the faces of the model. The Face Strength can be either 
Weak, Medium, or Strong. The idea is that the Weighted 
Normal Modifier can be set to pay attention to the Face 
Strength as follows: When combining the normals that meet 
at a vertex, only the faces with the strongest Face Strength 
will contribute to the final value. 


For example, if three faces meet at a vertex and have the 
face weights weak, medium, and strong, then only the 
normal associated with the strong face will be used to set 
the final result. 


Use the submenu to pick one of Weak, Medium, or Strong. 
Then this tool selects those faces that have the chosen face 
strength. 


Set Face Strength 


Reference 
Mode: Edit Mode 
Menu: Mesh > Normals > Set Face Strength 


Use the submenu to pick one of Weak, Medium, or Strong. 
Then this tool changes the Face Strength of currently 
selected faces to the chosen face strength. 


Shading 


Reference 
Mode: Edit Mode 
Menu: Mesh » Shading 


Alternatively, you can choose which faces to smooth by 
entering Edit Mode, then selecting some faces and picking 
Shade Smooth from the Face Menu. 


When the mesh is in Edit Mode, only the selected faces will 
receive the “smoothing” attribute. You can set faces as flat 
(removing the “smoothing” attribute) in the same way by 
selecting edges and picking the Shade Flat from the Face 
Menu. 


Sort Elements 


Reference 
Mode: Edit Mode 
Menu: Mesh » Sort Elements... 


This tool (available from the context menu, Vertices, Edges 
and Faces menus) allows you to reorder the matching 
selected mesh elements, following various methods. Note 
that when called from the context menu, the affected 
element types are the same as the active select modes. 


View Z Axis 
Sort along the active view’s Z axis, from farthest to 
nearest by default (use Reverse if you want it the other 
way). 


View X Axis 
Sort along the active view’s X axis, from left to right by 
default (again, there is the Reverse option). 


Cursor Distance 
Sort from nearest to farthest away from the 3D cursor 
position (Reverse also available). 


Material 
Sort faces, and faces only, from those having the lowest 
material’s index to those having the highest. Order of 
faces inside each of those “material groups” remains 
unchanged. Note that the Reverse option only reverses 
the order of the materials, not the order of the faces 
inside them. 


Selected 
Move all selected elements to the beginning (or end, if 
Reverse enabled), without affecting their relative orders. 
Warning: This option will also affect unselected 
elements’ indices! 


Randomize 
Randomizes indices of selected elements (without 
affecting those of unselected ones). The seed option 
allows you to get another randomization - the same seed 
over the same mesh or set of selected elements will 
always give the same result! 


Reverse 
Simply reverse the order of the selected elements. 


Hint 
Enabling the Display Indices Option 


Enable the Developer Extras Option in Preferences > 
Interface > Display panel, a checkbox will appear in Display 
& Shading Menu > Viewport Overlay >» Developer » Indices. 


Clean Up 


These tools are to help cleanup degenerate geometry and 
fill in missing areas of a mesh. 


Decimate Geometry 


Reference 
Mode: Edit Mode 
Menu: Mesh > Clean up >» Decimate Geometry 


The Decimate Geometry tool allows you to reduce the 
vertex/face count of a mesh with minimal shape changes. 


Ratio 
Ratio of triangles to reduce to. 


Vertex Group 
Use the active vertex group as an influence. 


Weight 
Strength of the vertex group. 


Invert 
Inverts the vertex group. 


Symmetry 
Maintain symmetry on either the X, Y, or Z axis. 


See also 


This tool works similar to the Decimate Modifier. 


Fill Holes 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Clean up » Fill Holes 


This tool can take a large selection and detect the holes in 
the mesh, filling them in. 


This is different from the face creation operator in three 
important respects: 


1. Holes are detected, so there is no need to manually find 
and select the edges around the holes. 

2. Holes can have a limit for the number of sides (so only 
quads or tris are filled in for example). 

3. Mesh data is copied from surrounding geometry (UVs, 
Color Attributes, multi-res, all layers), since manually 
creating this data is very time-consuming. 


Make Planar Faces 


Reference 
Mode: Edit Mode 
Menu: Mesh > Clean up > Make Planar Faces 


The Make Planar Faces iteratively flattens faces. This can 
happen with faces over three vertices and it is a common 
convention that faces should be kept planar. 


Factor 
Distance to move the vertices each iteration. 


Iterations 
Number of times to repeat the operation. 


Split Non-Planar Faces 


Reference 


Mode: Edit Mode 
Menu: Mesh > Clean up > Split Non-Planar Faces 


This tool avoids ambiguous areas of geometry by splitting 
non-flat faces when they are bent beyond a given limit. 


Split Concave Faces 


Reference 


Mode: Edit Mode 
Menu: Mesh » Clean up > Split Concave Faces 


This tool can be used to convert any Concave Face to 


convex by splitting the concave into two or more convex 
faces. 


Delete Loose 


Reference 


Mode: Edit Mode 


Menu: Mesh >» Clean up > Delete Loose 


This tool removes disconnected vertices and edges 
(optionally faces). 


Degenerate Dissolve 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Clean up >» Degenerate Dissolve 


This tool collapses / removes geometry which you typically 
will not want. 


e Edges with no length. 
e Faces with no areas (faces on a point or thin faces). 
e Face corners with no area. 


Merge by Distance 


Reference 
Mode: Edit Mode 
Menu: Vertex » Merge by Distance, Context 


Menu » Merge by Distance 


Merge by Distance is a useful tool to simplify a mesh by 
merging the selected vertices that are closer than a 
specified distance to each other. An alternative way to 
simplify a mesh is to use the Decimate Modifier. 


Merge Distance 


Sets the distance threshold for merging vertices. 


Unselected 
Allows vertices in the selection to be merged with 
unselected vertices. When disabled, selected vertices will 
only be merged with other selected ones. 


Deleting & Dissolving 


Reference 
Mode: Edit Mode 
Menu: Mesh » Delete 


These tools can be used to remove components. 
Delete 


Reference 


Shortcut: X, Delete 


Deletes selected vertices, edges, or faces. This operation 
can also be limited to: 


Vertices 
Delete all vertices in current selection, removing any 
faces or edges they are connected to. 


Edges 
Deletes any edges in the current selection. Removes any 
faces that the edge shares with it. 


Faces 
Removes any faces in current selection. 


Only Edges & Faces 


Limits the operation to only selected edges and adjacent 
faces. 


Only Faces 
Removes faces, but edges within the face selection are 
retained. 


Dissolve 


Dissolve operations are also accessed from the delete 
menu. Dissolve will remove the geometry and fill in the 
surrounding geometry. Instead of removing the geometry, 
which may leave holes that you have to fill in again. 


Removes selected geometry, but without creating holes, 
effectively turning the selection into a single n-gon. Dissolve 
works slightly different based on if you have edges, faces or 
vertices selected. You can add detail where you need it, or 
quickly remove it where you do not. 


Dissolve Vertices 


Reference 
Mode: Edit Mode 
Menu: Mesh » Delete > Dissolve Vertices 


Remove the vertex, merging all surrounding faces. In the 
case of two edges, merging them into a single edge. 


Face Split 
When dissolving vertices into surrounding faces, you can 
often end up with very large, uneven n-gons. The face 
split option limits dissolve to only use the corners of the 
faces connected to the vertex. 


Tear Boundaries 


Split off face corners instead of merging faces. 


Examples 


1) Original mesh. 2) Face Split: Off, Tear Boundaries: 
Off. 3) Face Split: On, Tear Boundaries: Off. 4) Face 
Split: On/Off, Tear Boundaries: On. 


Dissolve Edges 


Reference 
Mode: Edit Mode 
Menu: Mesh >» Delete > Dissolve Edges 


Removes edges sharing two faces (joining those faces). 


The options are the same as for the Dissolve Vertices tool. 
Dissolve Faces 


Reference 


Mode: Edit Mode 
Menu: Mesh » Delete > Dissolve Faces 


Merges regions of faces that share edges into a single face 


Note 


This can be accessed quickly using the F key, see: Dissolve 
Existing Faces. 

Dissolve (Context-Sensitive) 

Reference 


Shortcut: Ctrl-X 


This is a convenient shortcut that dissolves based on the 
current selection mode (vertex, edge, face). 


Limited Dissolve 


Reference 


Mode: Edit Mode 
Menu: Mesh » Delete > Limited Dissolve 


This tool can simplify your mesh by dissolving vertices and 
edges separating flat regions. 


Original mesh. Result of Limited 
Dissolve. 


Max Angle 
Reduces detail on planar faces and linear edges with an 
adjustable angle threshold. 


All Boundaries 
Always dissolve vertices that have two edge users at 
boundaries. 


Delimit 


Prevent faces from joining when they don’t share certain 
properties (material for e.g.). 


Collapse Edges & Faces 


Reference 

Mode: Edit Mode 

Menu: Mesh » Delete > Collapse Edges & Faces 
Shortcut: x, Collapse Edges & Faces 


Collapse each isolated edge and face region into single 
vertices, with support for face data such as UVs and vertex 
colors. 


This is useful for taking a ring of edges and collapsing it, 
removing the face loop it ran through. 


Selected edge ring. Edge ring collapsed. 


Tip 


This can be useful as a general way to remove detail, it 
has some advantages over: 


Delete Vertices: 


Leaves holes. 
Collapse Vertices: 


Doesn't correct UVs, vertex colors, etc. 
Dissolve Vertices: 


Often creates n-gons. 


Edge Loops 


Reference 
Mode: Edit Mode (Vertex or Edge select modes) 
Menu: Mesh >» Delete » Edge Loops 


Shortcut: X Or Delete, Edge Loops 


Edge Loop allows you to delete a selected edge loop if it is 
between two other edge loops. This will create one face loop 
where two previously existed. 


Note 


The Edge Loop option is very different to the Edges option, 
even if you use it on edges that look like an edge loop. 
Deleting an edge loop merges the surrounding faces 
together to preserve the surface of the mesh. By deleting 
a chain of edges, the edges are removed, deleting the 
Surrounding faces as well. This will leave holes in the mesh 
where the faces once were. 


Example 


The selected edge loop on the UV Sphere has been deleted 
and the faces have been merged with the surrounding 
edges. If the edges had been deleted by choosing Edges 
from the Delete menu there would be an empty band of 
deleted faces all the way around the sphere instead. 


Selected edge loop. Edge loop deleted. 


See also 


e Vertex merging. 
e Triangles to Quads. 
e Un-Subdivide. 


Vertex Tools 


Extrude Vertices 
Extrude to Cursor or Add 
o Creating Faces 
e Bevel Vertices 
o Options 
« New Edge/Face from Vertices 
o Methods 
Connect Vertex Path 
Connect Vertex Pairs 
Rip Vertices 
o Examples 
o Limitations 
Rip Vertices and Fill 
Rip Vertices and Extend 
Slide Vertices 
Smooth Vertices 
Laplacian Smooth 
Blend from Shape 
Propagate to Shapes 
Vertex Groups 
Hooks 
Make Vertex Parent 


Extrude Vertices 


Reference 

Mode: Edit Mode, Vertex Select mode 
Menu: Vertex >» Extrude Vertices 
Shortcut: AlLt-E 


Extrude vertices as individual vertices, use AlLt-E to access 
Extrude Vertices. 


Vertex selected. Vertices extrude. 


Extrude to Cursor or Add 


Reference 
Mode: Edit Mode 
Shortcut: Ctrl-RMB 


Interactively places new vertices with ctrl-RMB at the mouse 
cursor position. 


The most basic element, a vertex, can be added with a Ctrt- 
RMB click when no other vertices are selected. Because the 
Camera space (computer screen) is two-dimensional, 
Blender cannot determine all three vertex coordinates from 
a single mouse click, so the new vertex is placed at the 
depth of the 3D cursor. 


To create interconnected vertices, you can add a vertex and 
continuously make subsequent Ctrl-RMB operations with the 
last vertex selected. This will link the last selected vertex 
with the vertex created at the mouse position with an edge 
(see Fig. Adding vertices one by one.), and will continuously 
create and connect new vertices if you continue repeating 
this operation. 


Adding vertices one by one. 


Creating Faces 


Quad from an Edge with source automatically 
rotated. 


If you have two vertices selected and already connected 
with an edge, Ctrl-RMB click will create a planar face, also 
known as a quad. Blender will follow your mouse cursor and 
will use the planar view from your viewport to create those 
quads. 


For Ctrl-RMB, Blender will automatically rotate the last 
selected Edge (the source) for the subsequent operations if 
you have at least one face created, dividing the angles 
created between the newly created edge and the last two 
edges, creating a smooth angle between them. Blender will 
calculate this angle using the last positive and negative 
position of the last X and Y coordinates and the last 
connected unselected edge. If this angle exceeds a negative 
limit (following a quadrant rule) between the recently 
created edge and the last two, Blender will wrap the faces. 
But if you do not want Blender to rotate and smooth edges 
automatically when extruding from Ctri-RMB, you Can also 
inhibit Blender from rotating sources using the shortcut 


Shift-Ctrl-RMB. In this case, Blender will not rotate the source 
dividing the angle between those edges when creating a 
face. 


If you have three or more vertices selected, and Ctrl-RMB 
click, you will also create planar faces, but along the 
vertices selected, following the direction of the cursor. This 
operation is similar to an extrude operation. 


Tip 


When adding objects with ctrl-RMB, the extrusions of the 
selected elements, being vertices, edges and faces with 
the Ctrl-RMB, are viewport dependent. This means, once 
you change your viewport, for example, from top to left, 
bottom or right, the extrusion direction will also follow your 
viewport and align the extrusions with your planar view. 


Bevel Vertices 


Reference 

Mode: Edit Mode 

Menu: Edge » Bevel Edges 
Shortcut: Ctrl-B (Bevel Edges) 

Menu: Vertex >» Bevel Vertices 
Shortcut: Shift-Ctri-B (Bevel Vertices) 


The Bevel tool rounds off edges or corners of a mesh at the 
point of the selected vertices. In “vertex only” mode, the 
Bevel Vertices tool works on selected vertices but the option 
to switch to Bevel Edges is available. By doing so, more 
vertices are added in order to smooth out profiles with a 
specified number of segments (see the options below for 
details about the bevel algorithm). 


Cubes with and without bevel. 


Note 


With the Vertex Only option active, some of the other 
options available will not work. However, they will work 
with Bevel Edges. 


Options 
Affect v 
Vertices: Only the areas near vertices are 
beveled, the edges remain unchanged. 
Edges: Bevel the edges, creating intersections 
at vertices. 
Offset A 


You can change the bevel amount by moving the mouse 
towards and away from the object, like with transform 
tools. The exact meaning of the value depends on the 
Amount Type option (see below). 


Width Type m 


Selects how the Amount value controls the size of the 
bevel. According to the selection, the amount is: 


Offset: The relative distance from the new 
edge to the original. 
Width: The distance between the two new 


edges formed by the bevel (or the 

edges on either side of the bevel if 

there is more than one segment). 
Depth: The perpendicular distance from the 

Original edge to the bevel face. 
Percent: 


The percentage of the length of 
adjacent edges that the new edges is 
Slided along. 

Absolute: The exact distance along edges 
adjacent to the beveled edge. A 
difference from Offset is visible when 
the unbeveled edges attached to 
beveled edges meet at an angle 
besides a right angle. 


For vertex-only bevels, the Offset and Depth types 
measure from the original vertex, and the Width type is 
measured from a new vertex to the center of the new 
face (as half the amount). 


Segments s 


The number of segments in the bevel can be defined by 
scrolling the mouse Wheel to increase or decrease this 
value. The greater the number of segments, the 
smoother the bevel. Or press s to change the number 
with mouse movements, as well as numeric input. 


Alternatively, you can manually enter a segment number 
value while using the tool, or in the Mesh Tool options 
panel after using the tool. 


Bevel with four segments. 


Shape P 
This is a number between 0 and 1 that controls the shape 
of the profile (side view of a beveled edge). The default 
value, 0.5, gives a circular arc (if the faces meet at right 
angles). Values less than that give a flatter profile, with 
0.25 being exactly flat, and values less than that giving a 
concave bevel. Values more than 0.5 give a more convex 
profile. Similarly as Segments it can be set with mouse 
movements and numeric input after toggling P. 


Material Index 
The Material number specifies which material should be 
assigned to the new faces created by the Bevel tool. With 
the default, -1, the material is inherited from the closest 
existing face (“closest” can be a bit ambiguous). 
Otherwise, the number is the slot index of the material to 
use for all newly created faces. 


Harden Normals H 
When enabled, the per-vertex face normals of the bevel 
faces are adjusted to match the surrounding faces, and 
the normals of the surrounding faces are not affected. 
This will keep the surrounding faces flat (if they were 
before), with the bevel faces shading smoothly into them. 
For this effect to work, custom split normals need to be 
enabled, which requires Auto Smooth to be enabled (see 
Normals). AS a convenience, that option will be enabled 
for you if it is not already when you enable Harden 
Normals here. 


Clamp Overlap c 
Limits the width of each beveled edge so that vertices do 
not overlap with other geometry. 


Loop Slide 


If there are un-beveled edges along with beveled edges 
into a vertex, the bevel tries to slide along those edges 
when possible. Turning the option off can lead to more 
even bevel widths. 


Face Strength Mode 


Set Face Strength on the faces involved in the bevel, 
according to the specified mode. This can be used in 
conjunction with a Weight Normals Modifier (with the 
Face Influence option checked). 


None: 
New: 


Affected: 


All: 


Profile Type z 


Superellipse: 


Custom: 


Do not set face strength. 

Set the face strength of new faces 
along edges to Medium, and the face 
strength of new faces at vertices to 
Weak. 

In addition to those set for the New 
case, also set the faces adjacent to 
new faces to have strength Strong. 

In addition to those set for the Affected 
option, also set all the rest of the faces 
of the model to have strength Strong. 


Creates a bevel with a uniform concave 
or convex curve. 


This widget allows the creation of a 
user-defined profile with more 
complexity than with the single profile 
parameter. The modal tool allows 
toggling the custom profile, but the 
shape of the profile is only editable in 
the options panel after the operation is 
confirmed. 


Sampling 


\ 7) =X ~—«0.25000 Y 0.24986 x 


Sample Straight Edges 


Sample Even Lengths 


The custom profile widget. 

The profile starts at the bottom right of 
the widget and ends at the top left, as 
if it were between two edges 
intersecting at a right angle. Control 
points are created in the widget and 
then the path is sampled with the 
number of segments from the Bevel 
modifier. 
Presets 

The Support Loops and Steps 

presets are built dynamically 

depending on the number of 

segments in the bevel. If the 

number of segments is changed, the 

preset will have to be re-applied. 


Samples will first be added to each control point, then 
if there are enough samples, they will be divided 
evenly between the edges. The Sample Straight Edges 
option toggles whether the samples are added to 
edges with sharp control points on either side. If there 
aren’t enough samples to give each edge the same 
number of samples, they will just be added to the 
most curved edges. So it is recommended to use at 
least as many segments as there are control points. 


Bevel with Custom Profile on. 


Edge Bevel. Vertex Bevel. 


See also 


The Bevel Modifier is a non-destructive alternative to the 
Bevel tool. 


New Edge/Face from 
Vertices 


Reference 

Mode: Edit Mode 

Menu: Vertex » New Edge/Face from Vertices 
Shortcut: F 


This is a context-sensitive tool which creates geometry by 
filling in the selection. When only two vertices are selected 
it will create an edge, otherwise it will create faces. 


The typical use case is to select vertices and press F, yet 


Blender also supports creating faces from different 
selections to help to quickly build up geometry. 


Methods 


The following methods are used automatically depending on 
the context. 


Isolated Vertices 


Before. After. 


Isolated Edges 


Before. After. 


N-gon from Edges 


When there are many edges Blender will make an n-gon. 
Note that, this does not support holes, to support holes you 
need to use the Fill Faces tool. 


Before. After. 


Mixed Vertices/Edges 


Existing edges are used to make the face as well as an extra 
vertex. 


Before. After. 


Edge-Net 


Sometimes you may have many connected edges without 
interior faces. 


Before. After. 


Point Cloud 


When there are many isolated vertices, Blender will 
calculate the edges for an n-gon. 


Before. After. 


Single Vertex Selection 


With a single vertex selected on a boundary, the face will be 
created along the boundary, this saves manually selecting 


the other two vertices. Notice this tool can run multiple 
times to continue creating faces. 


See also 


For other ways to create faces see: 


Dissolve Existing Faces 


When you have a region of existing faces, creating a face on 
this selection will remove the shared vertices and edges, 


creating a single face. 


This is simply a convenience for accessing Dissolve Faces. 


Connect Vertex Path 


Reference 

Mode: Edit Mode 

Menu: Vertex » Connect Vertex Path 
Shortcut: J 


This tool connects vertices in the order they are selected, 
splitting the faces between them. When there are only two 
vertices selected, a cut will be made across unselected 
faces, a bit like the Knife tool; but this is limited to straight 
cuts across connected faces. 


Two disconnected 


, Result of connecting. 
vertices. 


Running a second time will connect the first/last endpoints. 
When many vertices are selected, faces will be split by their 
selected vertices. 


Before. After. 


Vertices not connected to any faces will create edges, so 
this can be used as a way to quickly connect isolated 
vertices too. 


Connect Vertex Pairs 


Reference 
Mode: Edit Mode 
Menu: Vertex » Connect Vertex Pairs 


This tool connects selected vertices by creating edges 
between them and splitting the face. It can be used on 
many faces at once. 


Vertices After | Resulting 
before connecting face pair. 
connecting. vertices. 


The main difference between this tool and Connect Vertex 
Path is that this tool ignores the selection order and 
connects all selected vertices that share a face. 


Rip Vertices 


Reference 

Mode: Edit Mode 

Menu: Vertex » Rip Vertices 
Shortcut: V 


Rip creates a “hole” in the mesh by making a copy of 
selected vertices and edges, still linked to the neighboring 
non-selected vertices, so that the new edges are borders of 
the faces on one side, and the old ones, borders of the faces 
on the other side of the rip. 


Examples 


Hole created after 


Selected vertex. using rip on vertex. 


Edges selected. Result of rip with 
edge selection. 


A complex selection Result of rip 
of vertices. operation. 
Limitations 


Rip will only work when edges and/or vertices are selected. 
Using the tool when a face is selected (explicitly or 
implicitly), will return an error message “Cannot perform 
ripping with faces selected this way”. If your selection 
includes edges or vertices that are not “between” two faces 


Manifold, it will also fail with the message “No proper 
selection or faces include”. 


Rip Vertices and Fill 


Reference 

Mode: Edit Mode 

Menu: Vertex > Rip Vertices and Fill 
Shortcut: Alt-V 


Rip fill works the same as the Rip tool above, but instead of 
leaving a hole, it fills in the gap with geometry. 


Edges selected. Result of rip fill. 


Rip Vertices and Extend 


Reference 

Mode: Edit Mode 

Menu: Vertex » Rip Vertices and Extend 
Shortcut: Alt-D 


This tool takes any number of selected vertices and 
duplicate-drags them along the closest edge to the mouse. 
When extending an edge loop, it extends the vertices at the 


endpoints of the loop. The behavior is similar to the Extrude 
tool, but it creates an n-gon. 


It helps to easily add details to existing edges. 


Slide Vertices 


Reference 

Mode: Edit Mode 

Menu: Vertex > Slide Vertices 
Shortcut: Shift-V 


Vertex Slide will transform a vertex along one of its adjacent 
edges. Use Shift-v to activate tool. The nearest selected 
vertex to the mouse cursor will be the control one. Move the 
mouse along the direction of the desired edge to specify the 
vertex position. Then press LMB to confirm the transformation. 


Evene 
By default, the offset value of the vertices is a percentage 
of the edges length along which they move. When Even 
mode is active, the vertices are shifted by an absolute 
value. 


Flipped F 
When Flipped is active, vertices move the same distance 
from adjacent vertices, instead of moving from their 
Original position. 


Clamp Alt orc 
Toggle clamping the slide within the edge extents. 


Selected 
vertex. 


Positioning Repositioned 
vertex vertex. 
interactively. 


Smooth Vertices 


Reference 
Mode: Edit Mode 
Menu: Vertex » Smooth Vertices, Context Menu 


>» Smooth 


This tool smooths the selected vertices by averaging the 
angles between the faces. After using the tool, options 
appear in the Toolbar: 


Smoothing 
Smoothing factor. 


Repeat 
The number of smoothing iterations. 


Axes 
Limit the effect to certain axes. 


Mesh after Mesh after 
Mesh t 
before es me 
thi smoothing smoothing 
ae: iteration. iterations. 


See also 


Subdividing 


Adjusting the smooth option after using the Subdivide tool 
results in a more organic shape. 


See also 


Smooth Modifier 


The Smooth Modifier, which can be limited to a Vertex 
Group, is a non-destructive alternative to the Smooth tool. 


Laplacian Smooth 


Reference 
Mode: Edit Mode 
Menu: Context Menu >» Laplacian Smooth 


See the Laplacian Smooth Modifier for details. 


Laplacian smooth uses an alternative smoothing algorithm 
that better preserves larger details and this way the overall 
Shape of the mesh. Laplacian smooth exists as a mesh 
operation and as a non-destructive modifier. 


Note 
Geometry Smoothing versus Smooth Shading 


Do not mistake this tool with the smooth shading options, 
they do not work the same! This tool modifies the mesh 
itself, to reduce its sharpness, whereas Set Smooth, Auto 
Smooth, ... only control the way the mesh is shaded, 
creating an ///usion of softness, but without modifying the 
mesh at all. 


Blend from Shape 


Reference 


Mode: Edit Mode 
Menu: Vertex > Blend from Shape 


Blend in the shape from a shape key. 


Propagate to Shapes 


Reference 


Mode: Edit Mode 
Menu: Vertex >» Propagate to Shapes 


Apply selected vertex locations to all other shape keys. 


Vertex Groups 


Todo. 


Hooks 


Reference 

Mode: Edit Mode 
Menu: Vertex » Hooks 
Shortcut: Ctrl-H 


Adds a Hook Modifier (using either a new empty, or the 
current selected object) linked to the selection. Note that 
even if it appears in the history menu, this action cannot be 
undone in Edit Mode - because it involves other objects... 


When the current object has no hooks associated, only the 
first two options will appear on the menu. 


Hook to New Object 
Creates a new Hook Modifier for the active object and 
assigns it to the selected vertices; it also creates an 


empty at the center of those vertices, which are hooked 
to it. 


Hook to Selected Object 
Does the same as Hook to New Object, but instead of 
hooking the vertices to a new empty, it hooks them to 
the selected object (if it exists). There should be only one 
selected object (besides the mesh being edited). 


Hook to Selected Object Bone 
Does the same as Hook to New Object, but it sets the last 
selected bone in the also selected armature as a target. 


Assign to Hook 


The selected vertices are assigned to the chosen hook. 
For that to happen, a list of the hooks associated to the 
object is displayed. All the unselected vertices are 
removed from it (if they were assigned to that particular 
hook). One vertex can be assigned to more than one 
hook. 


Remove Hook 
Removes the chosen hook (from the displayed list) from 
the object. Which means that the specific Hook Modifier 
is removed from its modifier stack. 


Select Hook 


Selects all vertices assigned to the chosen hook (from 
the hook list). 


Reset Hook 


It’s equivalent to the Reset button of the specific Hook 
Modifier (chosen from the hook list). 


Recenter Hook 


It’s equivalent to the Recenter button of the specific 
Hook Modifier (chosen from the hook list). 


Make Vertex Parent 


Reference 

Mode: Edit Mode 

Menu: Vertex » Make Vertex Parent 
Shortcut: Ctrl-P 


This will parent the other selected object(s) to the 
vertices/edges/faces selected, as described in parenting. 


Edge Tools 


Extrude Edges 
Bevel Edges 
o Usage 
o Options 
o Examples 
Bridge Edge Loops 
o Examples 
Screw 
o Usage 
o Limitations 
o Options 
o Examples 
Subdivide 
o Options 
o Examples 
Subdivide Edge-Ring 
Un-Subdivide 
Rotate Edge 
Edge Slide 
o Usage 
Offset Edge Slide 
Loop Cut and Slide 
o Usage 
o Options 
Edge Data 
o Edge Crease 
o Edge Bevel Weight 
o Mark Seam & Clear Seam 
o Mark Sharp & Clear Sharp 


Extrude Edges 


Reference 

Mode: Edit Mode, Edge Selection mode 
Menu: Edge » Extrude Edges 
Shortcut: Alt-E 


Extrude edges as individual edges, use Alt-E to access the 
Extrude Edges. 


Edge selected. Edge extruded. 


Bevel Edges 


Reference 

Mode: Edit Mode 

Menu: Edge » Bevel Edges 
Shortcut: Ctrl-B (Bevel Edges) 

Menu: Vertex > Bevel Vertices 
Shortcut: Shift-Ctrtl-B (Bevel Vertices) 


The Bevel tool allows you to create chamfered or rounded 
corners on geometry. A bevel is an effect that smooths out edges 
and corners. 


Real world edges are very seldom exactly sharp. Not even a knife 
blade edge can be considered perfectly sharp. Most edges are 
intentionally beveled for mechanical and practical reasons. 


Bevels are also useful for giving realism to non-organic models. 
In the real world, the blunt edges on objects catch the light and 
change the shading around the edges. This gives a solid, realistic 
look, as opposed to un-beveled objects which can look too 
perfect. 


Cubes with and without bevel. 


Usage 


The Bevel Edges tool works only on selected edges with exactly 
two adjacent faces. It will recognize any edges included ina 
vertex or face selection as well, and perform the bevel the same 
as if those edges were explicitly selected. In “vertex only” mode, 
the Bevel Vertices tool works on selected vertices instead of 
edges, and there is no requirement about having any adjacent 
faces. The Bevel tool smooths the edges and/or “corners” 
(vertices) by replacing them with faces making smooth profiles 
with a specified number of segments (see the options below for 
details about the bevel algorithm). 


Use Ctri-B or a method listed above to run the tool. Move the 
mouse to interactively or type a number to specify the bevel 
offset, and scroll the wheel to increase or decrease the number of 
segments (see below). 


Selected Result of de of 
edge before bevel (one fvariex 
beveling. segment). 
only). 
Note 


Normal (edge) beveling only works on edges that have exactly 
two faces attached to them. Vertex beveling has no such 
restriction. 

Options 


Affect v 


Vertices 
Only the areas near vertices are beveled, the edges remain 
unchanged. 


Edges 
Bevel the edges, creating intersections at vertices. 


Width Type m 
Selects how the Width value controls the size of the bevel. 
According to the selection, the width is: 


Offset: The distance from the new edge to the 
original. 
Width: The distance between the two new edges 


formed by the bevel (or the edges on either 
side of the bevel if there is more than one 


segment). 

Percent: The percentage of the length of adjacent 
edges that the new edges slide. 

Absolute: The exact distance along edges adjacent to 


the beveled edge. A difference from Offset 
is visible when the unbeveled edges 
attached to beveled edges meet at an angle 
besides a right angle. 


For vertex-only bevels, the Offset and Depth types measure 
from the original vertex. The Width type is measured from a 
new vertex to the center of the new face (as half the Width). 


Width A 
You can change the bevel width by moving the mouse towards 
and away from the object, a bit like with transform tools. The 
exact meaning of the value depends on the Width Type option 
(see above). As usual, the scaling can be controlled to a finer 
degree by holding Shift to scale in 0.001 steps. LmB finalizes 
the operation, RMB or Esc aborts the action. 


Note 


When multiple edges are beveled at the same time, it is 
sometimes impossible to make the width match the above 
definition on all edges simultaneously. Bevel tries to 
compromise in such cases. Sometimes turning off Loop Slide 
(see below) can make it easier for Bevel to make the widths 
as specified. 


Segments s 


The number of segments in the bevel can be defined by 
scrolling the mouse wheel to increase or decrease this value. 
The greater the number of segments, the smoother the bevel. 
Or press Ss to change the number with mouse movements, as 
well as numeric input. 


Alternatively, you can manually enter a segment number 
value while using the tool, or in the Mesh Tool options panel 
after using the tool. 


Bevel with four segments. 


Shape P 
This is a number between 0 and 1 that controls the shape of 
the profile (side view of a beveled edge). The default value, 
0.5, gives a circular arc (if the faces meet at right angles). 
Values less than that give a flatter profile, with 0.25 being 
exactly flat, and values less than that giving a concave bevel. 
Values more than 0.5 give a more convex profile. Similarly as 


Segments it can be set with mouse movements and numeric 
input after toggling P. 


Material Index 


The Material number specifies which material is assigned to 
the new faces created by the Bevel tool. With the default, -1, 
the material is inherited from the closest existing face 
(“closest” can be a bit ambiguous). Otherwise, the number is 
the slot index of the material to use for all newly created 
faces. 


Harden Normals H 


When enabled, the per-vertex face normals of the bevel faces 
are adjusted to match the surrounding faces, and the normals 
of the surrounding faces are not affected. This will keep the 
surrounding faces flat (if they were before), with the bevel 
faces shading smoothly into them. For this effect to work, 
custom split normals need to be enabled, which requires Auto 
Smooth to be enabled (see Normals). As a convenience, that 
option will be enabled for you if it is not already when you 
enable Harden Normals here. 


Clamp Overlap c 


Limits the width of each beveled edge so that edges cannot 
cause overlapping intersections with other geometry. 


Loop Slide 
If there are un-beveled edges along with beveled edges into a 
vertex, the bevel tries to slide along those edges when 


possible. Turning the option off can lead to more even bevel 
widths. 


Mark 
Seams U 
If aseam edge crosses a non-seam one and you bevel all 


of them, this option will maintain the expected propagation 
of seams. 


Sharp K 


Similar to Mark Seams, but for sharp edges. 


Miter Outer 0 
A miter is formed when two beveled edges meet at an angle. 
On the side where the angle is greater than 180 degrees, if 
any, it is called an outer miter. This option specifies the 
pattern that Blender uses at an outer miter. 


Sharp: Edges meet at a sharp point, with no extra 
vertices introduced on the edges. 
Patch: Edges meet at a sharp point but in addition, 


two extra vertices are introduced near the 
point so that the edges and faces at the 
vertex may be less pinched together than 
what occurs in the Sharp case. 

Arc: Two vertices are introduced near the 
intersection, and a curved arc joins them 
together. The Spread slider controls how far 
the new vertices are from the intersection. 
The Profile curve widget controls the shape 
of the arc. 


The current choices are shown in this diagram, where the 
outer miter is along the horizontal surface. 


at aks Patch outer Arc outer 
; miter. miter. 
miter. 


Inner I 
An Inner Miter is formed when the angle between two beveled 
edges is less than 180 degrees. This option specifies the 
pattern Blender uses at an inner miter. The options are the 
same as for Outer Miter, except that Patch makes no sense 


and is therefore omitted. Inner miters are shown in the 
following diagram, where two inner miters are on the vertical 
Surfaces. 


Sharp inner miter. Arc inner miter. 


Spread 


The value used to spread extra vertices apart for Outer and 
Inner Miters. This option is available when Miter Inner is set to 
Arc. 


Intersection Type N 


When more than two beveled edges meet at a vertex, a mesh 
is created as a way to complete the intersection between the 
generated geometry. This option controls the method used to 
create that mesh. 


Grid Fill: The default method for building 
intersections, useful when a smooth 
continuation of the bevel profile is desired. 
Without Custom Profile enabled, the curve 
of the profile continues through the 
intersection, but with a custom profile it just 
creates a smooth grid within the 
intersection’s boundary. 


Cutoff: Creates a cutoff face at the end of each 
beveled edge coming into the vertex. This is 
most useful for custom profiles when the 
new intersection is too complex for a 
smooth grid fill. 


With a three way intersection, when the 
inner corners of the cutoff profiles faces 
meet at the same location, no center face is 
created. 

The direction of the cutoff faces depends on 
the original vertex’s normal. 


Intersection method options. 


eee ey Cutoff 
ee ; : intersection 
Grid fill intersection 
. ; method 
intersection where the th 
method inner wine 
| vertices are COneee 
face. 
merged. 


Face Strength 
Set Face Strength on the faces involved in the bevel, 
according to the specified mode. This can be used in 
conjunction with a Weight Normals Modifier (with the Face 
Influence option checked). 


None: Do not set face strength. 

New: Set the face strength of new faces along 
edges to Medium, and the face strength of 
new faces at vertices to Weak. 

Affected: In addition to those set for the New case, 
also set the faces adjacent to new faces to 
have strength Strong. 

All: In addition to those set for the Affected 
option, also set all the rest of the faces of 
the model to have strength Strong. 


Profile Type z 


Superellipse: Creates a bevel with a uniform concave or 
convex curve. 


Custom: 
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Sample Straight Edges 


Sample Even Lengths 


The custom profile widget. 
This Curve Widget allows the creation of a 
user-defined profile with more complexity 
than with the single profile parameter. The 
modal tool allows toggling the custom 
profile, but the shape of the profile is only 
editable in the options panel after the 
operation is confirmed. 
The profile starts at the bottom right of the 
widget and ends at the top left, as if it were 
between two edges intersecting at a right 
angle. Control points are created in the 
widget and then the path is sampled with 
the number of segments from the Bevel 
modifier. 


Note 


Examples 


Result of 
beveling 
multiple 
edges. 


The Profile curve widget stays active when 
miters are enabled because it still controls 
the shape of the miter profiles. 


Presets 
The Support Loops and Steps presets are 
built dynamically depending on the 
number of segments in the bevel. If the 
number of segments is changed, the 
preset will have to be re-applied. 

Sampling 
Samples will first be added to each 
control point, then if there are enough 
samples, they will be divided evenly 
between the edges. The Sample Straight 
Edges option toggles whether the 
Samples are added to edges with sharp 
control points on either side. If there 
aren’t enough samples to give each edge 
the same number of samples, they will 
just be added to the most curved edges. 
So it is recommended to use at least as 
many segments as there are control 
points. 


Another 

example of An example 
beveling using 
multiple Profile=0.150. 


edges. 


See also 


The Bevel Modifier is a non-destructive alternative to the Bevel 
tool. 


Bridge Edge Loops 


Reference 
Mode: Edit Mode 
Menu: Edge >» Bridge Edge Loops 


Bridge Edge Loops connects multiple edge loops with faces. 


Connect Loops 
Open Loop 
Loops connected with open ends. 


Closed Loop 
Tries to connect to a circular loop (where the start and 
end are merged). 


Loop Pairs 
Connects each even count of loops individually. 


Merge 
Merges edge loops rather than creating a new face. 


Merge Factor 
Which edge loop the edges are merged to, a value of 0.5 
will merge at a half-way point. 


Twist 
Determines which vertices in both loops are connected to 
each other. 


Number of Cuts 
The number of intermediate edge loops used to bridge 
the distance between two loops. 


Interpolation 
Linear, Blend Path, Blend Surface 


Smoothness 
Smoothness of the Blend Path and Blend Surface. 


Profile Factor 
How much intermediary new edges are 
shrunk/expanded. 


Profile Shape 
The shape of the new edges. See the Proportional Editing 
page for a description of each option. 


Examples 


Simple example showing two closed edge loops. 


Input. Bridge result. 


Example of the Bridge tool between edge loops with 
different numbers of vertices. 


Input. Bridge result. 


Example using the Bridge tool to cut holes in face selections 
and connect them. 


Input. Bridge result. 


Example showing how Bridge tool can detect multiple loops 
and connect them in one step. 


Input. Bridge result. 


Example of the subdivision option and surface blending with 
UVs. 


Input. Bridge result. 


Screw 


Reference 
Mode: Edit Mode 
Menu: Edge > Screw 


The Screw tool combines a repetitive Spin with a translation, 
to generate a screw-like, or spiral-shaped, object. Use this 
tool to create screws, springs, or shell-shaped structures 
(Sea shells, Wood Screw Tips, Special profiles, etc.). 


The main difference between the Screw tool and the Screw 
Modifier is that the Screw tool can calculate the angular 
progressions using the basic profile angle automatically. It 
can also adjust the Axis angular vector without using a 
second modifier (for example, using the Screw Modifier with 
a Bevel Modifier, Curve Modifier, etc.), resulting in a much 
cleaner approach for vertex distribution and usage. 


This tool works using open or closed profiles, as well as 
profiles closed with faces. You can use profiles like an open- 
edge part that is a part of a complete piece, as well asa 
closed circle or a half-cut sphere, which will also close the 
profile end. 


You can see some examples of meshes generated with the 
Screw tool in Fig. Wood Screw tip created with the Screw 
tool. and Fig. Spring_created with the Screw tool.. 


Wood Screw tip Spring created with 
created with the the Screw tool. 
Screw tool. 


Usage 


This tool works only with meshes. In Edit Mode, the Screw 
tool operation can be found by navigating to Edge > Screw 
in the header of the 3D Viewport. To use this tool, you need 
to create at least one open profile or line to be used as a 
vector for the height, and an angular vector to specify a 
direction. 


The Screw tool uses two points given by the open line to 
create an initial vector to calculate the height and basic 
angle of the translation vector that is added to the “Spin” 
for each full rotation (see examples below). If the vector is 
created with only two vertices at the same XYZ location 
(which will not give Blender a vector value for height), this 
will create a normal “Spin”. 


Having at least one vector line, you can add other closed 
support profiles that will follow this vector during the 
extrusions (see Limitations). The direction of the extrusions 


is calculated by two determinant factors, the point of view in 
Global Space and the position of the cursor in the 3D 
Viewport using Global coordinates. The profile and the 
vector must be fully selected in Edit Mode before you click 
the Screw button (see Limitations). When you have the 
vector for the open profile and the other closed profiles 
selected, click the Screw button. 


Limitations 


There are strict conditions about the profile selection when 
you want to use this tool. You must have at least one open 
line or open profile, giving Blender the starting Vector for 
extrusion, angular vector and height (e.g. a simple edge, a 
half circle, etc.). You need only to ensure that at least one 
reference line has two “free” ends. If two open Lines are 
given, Blender will not determine which of them is the 
vector, and will then show you an error message, "You have 
to select a string of connected vertices too". You need to 
select all of the profile vertices that will participate in the 
Screw tool operation; if they are not properly selected, 
Blender will also show you the same message. 


Note that the open line is always extruded, so if you only 

use it to “guide” the screw, you will have to delete it after 
the tool completion (use linked-selection, Ctri-L, to select 
the whole extrusion of the open line). 


If there is any problem with the selection or profiles, the tool 
will warn you with the error message: "You have to select a 
string of connected vertices too" aS seen in Fig. Screw error 
message in the status bar. and Fig. Error message when 
clicking_in the Screw tool with an incorrect or bad selection., 
both in the Status Bar and at the place where you clicked to 


start performing the operation (when you click the Screw 
Button). 


€} You have to select a string of connected vertices too 


Screw error message in the status bar. 


Error message when clicking in the Screw tool with 
an incorrect or bad selection. 


You may have as many profiles as you like (like circles, 
Squares, and so on) - Note that, not all vertices in a profile 
need to be in the same plane, even if this is the most 
common case. You may also have other, more complex, 
selected closed islands, but they have to be closed profiles 
because Blender will seek for only one open profile for the 
translation, height and angular vector. Some closed meshes 
that overlap themselves may not screw correctly (for 
example: Half UV Sphere works fine, but more than half 
could cause the Screw tool to have wrong behavior or 
errors), and profiles that are closed with faces (like a cone or 
half sohere) will be closed automatically at their ends, like if 
you were extruding a region. 


Tip 
Simple Way to not Result in Error 


Only one open Profile, all of the others can be closed, avoid 
volumes and some profiles closed with faces... 


Options 


This tool is an interactive and modal tool, and only works in 
Edit Mode. When you select the Screw tool, Blender will 
enter the Screw interactive mode, and the Adjust Last 
Operation panel in the 3D Viewport will be replaced so you 
can adjust the values explained below. 


Once you perform any other operation, Blender leaves the 
interactive mode and accepts all of the values. Because it is 
modal, you cannot return to the interactive mode after 
completing/leaving the operation or changing from Edit 
Mode to Object Mode. If you want to restart the operation 
from its beginning, you can press Ctrl-Z at any time in Edit 
Mode. 


The basic location of the cursor at the point of view (using 
Global coordinates) will determine around which axis the 
selection is extruded and spun at first (See Fig. Sidebar 
region » Cursor.). Blender will copy the cursor location 
coordinates to the values present in the Center values of the 
Screw interactive panel. Depending on the Global View 
position, Blender will automatically add a value of 1 to one 
of the Axis vectors, giving the profiles a starting direction for 
the Screw Operation and also giving a direction for the 
extrusions. (See examples below.) 


The position of the 3D cursor will be the starting center of 
the rotation. Subsequent operations (e.g. pressing the Screw 
button again), will start from the last selected element. 
Continuous operations without changing the selection will 
repeat the operation continuously from the last point. 


¥ 3D Cursor 


Location 


Screw tools Adjust Last Operation panel (in Edit 
Mode). 


Steps 
This number field specifies how many extrusion(s) will be 
done for each 360 degree turn. The steps are evenly 
distributed by dividing 360 degree by the number of 
steps given. The minimum value is 3; the maximum is 


256 (See Fig. Screw tools bpy.ops.screen.redo last panel 
(in Edit Mode).). 


Turns 


This number field specifies how many turns will be 
executed. Blender will add a new full 360 degree turn for 
each incremental number specified here. The minimum 
value is 1; the maximum is 256. (See Fig. Screw tools 
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Center X, Y, Z 
These number fields specify the center of the spin. When 
the tool is called for the first time, it will copy the XYZ 
location (global coordinates) of the cursor presently in 
the 3D Viewport to start the operation. You can specify 
the cursor coordinates using the Transform panel in 3D 
Viewport, and typing in the 3D Cursor Location 
coordinates. You can adjust these coordinates 
interactively and specify another place for the spin 
center during the interactive session. (See Fig. Screw 
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Axis X, Y, Z 
These three number fields vary from (-1.0 to 1.0) and are 
clamped above those limits. These values correspond to 
angular vectors from (-90 to 90) degrees. Depending on 
the position where you started your cursor location and 
Object operation in the viewport and its axis positions in 
Global View space and coordinates, Blender will give the 
proper Axis vector a value of 1, giving the angular vector 
of the profile a starting direction and giving the 
extrusions a starting direction based on the current view. 
Blender will let you adjust the axis angular vectors and 
you can tweak your object such that you can revert the 
direction of the screw operation (by reverting the angular 
vector of the height), meaning you can revert the 
clockwise and counterclockwise direction of some 
operations, and also adjust the angular vectors of the 
profile, bending it accordingly. (See Fig. Screw tools 
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Examples 


The Spring Example 


1; 
Zz 


3. 


CON OD UI 


10. 
11. 


Open Blender and delete the default Cube. 

Change from perspective to orthographic view using 
shortcut Numpad5. 

Change the view from User Orthographic to Front 
Orthographic, using the shortcut Numpad. You will see the 
X (red) and Z (blue) coordinate lines. 


. In case you have moved the cursor by clicking anywhere 


in the screen, again place the cursor at the Center, 
using the shortcut Shift-S choosing Cursor to World 
Origin or the Transform panel, placing the cursor at (0, 
0, 0) typing directly into the Cursor 3D Location. 


. Add a circle using shortcut Shift-A » Mesh » Circle. 

. Rotate this circle using the shortcut R X 9 0 and Return. 

. Apply the Rotation using ctrl-A and choosing Rotation. 

. Move this circle three units on the X axis to the left; you 


can use the shortcut ctri while selecting with the mouse 
using the standard transform widgets (clicking on the 
red arrow shown with the object and moving while using 
Shortcut ctri until the info in the top left corner of the 
3D Viewport displays D. -3.0000 (3.0000) Global), or press 
the shortcut G X Minus 3 and Return. You can use the 
Transform panel, and type Minus 3 and Return in the 


. You will have to scale the circle using the shortcut s 


Period 5, then Return. 
Now enter Edit Mode using shortcut Tab. 
Deselect all vertices using the shortcut Alt-A. 


Circle placed at X (-3, 0, 0). 


The following steps explain how to create a height vector: 


1. 


Select an edge from the circle and duplicate the edge 
with Shift-D and move the edge to the right of the circle. 
This edge will be used as the first height and angle 
vector of the screw. 


. With one of the vertices selected, in the Transform panel 


give the vertex the global position to the XYZ 
coordinates of (-2, 0, -1). 


. Select the other vertex, and again, set its XYZ 


coordinates to (-2, 0, 1). This will create a straight 
vertical line with 2 units of height. 


. Select everything again with the shortcut A. (See Fig. 


Profile and vector created..) 


. Again, place the cursor at the center. 
. At this point, Save the blend-file to reuse the spring for 


another exercise. You can name it e.g. “Screw spring 
example.blend”. 


. Click Screw and adjust the Steps and Turns as you like 


to create a nice spring. 


Profile and vector created. 


Clockwise & Counterclockwise using the 
Spring Example 


Still in the interactive session of the Screw tool, you will see 
that the Z axis Value of the Screw panel is set to 1.000. LmB 
click in the middle of the Value and set this value to -1.000. 
At first, the spring was being constructed in a 
counterclockwise direction, and you reverted the operation 
180 degrees in the Z axis. This is because you have 
changed the angular vector of the height you have given to 
Blender to the opposite direction (remember, -90 to 90 = 
180 degrees ?). See Fig. Spring direction.. 


Spring direction. 


Counterclockwise Flipped to Clockwise 
direction. direction. 


It is also important to note that this vector is related to the 
same height vector axis used for the extrusion and you have 
created a parallel line with the Z axis, so, the sensibility of 
this vector is in practical sense reactive only to negative and 
positive values because it is aligned with the extrusion axis. 
Blender will clamp the positive and negative to its maximum 
values to make the extrusion follow a direction, even if the 
profile starts reverted. The same rule applies to other global 
axes when creating the object for the Screw tool; this means 
if you create your object using the Top View with a straight 
parallel line following another axis (for the Top View, the Y 
axis), the vector that gives the height for extrusion will also 
change abruptly from negative to positive and vice versa to 
give the extrusion a direction, and you will have to tweak 
the corresponding axis accordingly to achieve the clockwise 
and counterclockwise effect. 


Note 


Vectors that are not Parallel with Blender Axis 


The high sensibility for the vector does not apply to 
vectors that give the Screw tool a starting angle (e.g. any 
non-parallel vector), meaning Blender will not need to 
clamp the values to stabilize a direction for the extrusion, 
as the inclination of the vector will be clear for Blender and 
you will have the full degree of freedom to change the 
vectors. This example is important because it only changes 
the direction of the profile without the tilt and/or bending 
effect, as there is only one direction for the extrusion, 
parallel to one of the Blender Axes. 


Bending the Profiles using the Spring 
Example 


Still using the spring example, you can change the 
remaining vector for the angles that are not related to the 
extrusion axis of the spring. Bending the spring with the 
remaining vectors and creating a profile that will also open 
and/or close because of the change in starting angular 
vector values. What really is changed is the starting angle of 
the profile before the extrusions. It means that Blender will 
connect each of the circles inclined with the vector you have 
given. The images below show two bent meshes using the 
axis vectors and the spring example. See Fig. Bended 
mesh.. These two meshes generated with the Screw tool 
were created using the Top Orthographic View. 


Bended mesh. 


The Axis will give The vector angle is 
the profile a starting maintained along 
vector angle. the extrusions. 


Creating Perfect Screw Spindles 


Using the spring example, it is easy to create perfect screw 
spindles (like the ones present in normal screws that you 
can buy in hardware stores). Perfect screw spindles use a 
profile with the same height as its vector, and the beginning 
and ending vertex of the profile are placed at a straight 
parallel line with the axis of extrusion. The easiest way of 
achieving this effect is to create a simple profile where the 
beginning and ending vertices create a straight parallel line. 
Blender will not take into account any of the vertices 
present in the middle but those two to take its angular 
vector, so the spindles of the screw (which are defined by 
the turns value) will assembly perfectly with each other. 


1. Open Blender and click on File located in the header of 
the Info editor again, choose Open Recent and select 
the file you saved for this exercise. All of the things will 
be placed exactly the way you saved before. Choose the 
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last saved blend-file; in the last exercise, you gave it the 
name “screw spring example.blend”. 


. Press the shortcut Alt-A to deselect all vertices. 
. Press the shortcut B, and Blender will change the cursor; 


you are now in box selection mode. 


. Open a box that selects all of the circle vertices except 


the two vertices you used to create the height of the 
extrusions in the last example. 


. Use the shortcut x to delete them. 

. Press the shortcut A to select the remaining vertices. 
. Select Context Menu » Subdivide. 

. Now, click with the LmB on the middle vertex. 

. Move this vertex using the shortcut G X Minus 1 and 


Return. See Fig. Profile for a perfect screw spindle.. 


. At this point, you can save this blend-file to recycle the 


generated Screw for another exercise; click with LMB on 

File - it is in the header of the Info editor (at the top left 
side), and choose Save as. You can name it e.g. “Screw 

hardware example.blend”. 


. Press the shortcut A to select all the vertices again. 
. Now press Screw. 
. Change Steps and Turns as you like. Fig. Generated 


mesh. shows you an example of the results. 


Generated mesh. 


Profile for a perfect You can use this 


screw spindle. technique to 
perform normal 
The starting and screw modeling. 


ending vertices are 
forming a parallel 
line with the Blender 
Axis. 


Fig. Ramp. shows an example using a different profile, but 
maintaining the beginning and ending vertices at the same 
position. The generated mesh looks like a medieval ramp! 


Ramp. 


Profile with starting Generated mesh 
and ending vertices with the profile at 
forming a parallel the left. The 

line with the Blender visualization is 
Axis. inclined a bit. 


As you can see, the Screw spindles are perfectly assembled 
with each other, and they follow a straight line from top to 
bottom. You can also change the clockwise and 
counterclockwise direction using this example, to create 


right and left screw spindles. At this point, you can give the 
screw another dimension, changing the Center of the spin 
extrusion, making it more suitable to your needs or 
calculating a perfect screw and merging its vertices with a 
cylinder, modeling its head, etc. 


A Screw Tip 


As explained before, the Screw tool generates clean and 
simple meshes to deal with; they are light, well-connected 
and are created with very predictable results. This is due to 
the Blender calculations taking into account not only the 
height of the vector, but also its starting angle. It means 
that Blender will connect the vertices with each other ina 
way that they follow a continuous cycle along the extruded 
generated profile. 


In this example, you will learn how to create a simple Screw 
Tip (like the ones used for wood; as shown in the example at 
the beginning of this page). To make this new example as 
Short as possible, it will recycle the last example (again). 


1. Open Blender and click on File located in the header of 
the Info editor again; choose Open Recent and the file 
saved for this exercise. All of the things will be placed 
exactly the way you saved before. Choose the last 
saved blend-file; from the last exercise, which is named 
“screw hardware example.blend”. 

2. Move the upper vertex and move a bit to the left, but no 
more than you have moved the last vertex. (See Fig. 
Profile with a starting vector angle..) 

. Press the shortcut A twice to deselect and select all. 

. Press the shortcut Shift-S and select Cursor to Center. 

. Press Screw. 
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Profile with a Generated mesh 


starting vector with the profile. 
angle. 


As you can see in Fig. Generated mesh with the profile., 
Blender follows the basic angular vector of the profile, and 
the profile basic angle determines whether the extruded 
subsequent configured turns will open or close the resulting 
mesh following this angle. The vector of the extrusion angle 


is determined by the starting and ending vertex of the 
profile. 


Subdivide 


Reference 
Mode: Edit Mode 
Menu: Edge » Subdivide 


Subdividing splits selected edges and faces by cutting them in 
half or more, adding new vertices, and subdividing accordingly 
the faces involved. It adds resolution to the mesh by divide 
faces or edges into smaller units. 


This process follows a few rules, depending on the settings: 


e When only one edge of a face is selected (Triangle mode), 
triangles are subdivided into two triangles, and quads, into 
three triangles. 

e When two edges of a face are selected: 

o If the face is a triangle, a new edge is created between 
the two new vertices, subdividing the triangle ina 
triangle and a quad. 

If the face is a quad, and the edges are neighbors, there 

have three possible behaviors to divide the quad, 

depending on the setting of Quad Corner Type (see 
below for details). 

If the face is a quad, and the edges are opposite, the 

quad is just subdivided in two quads by the edge linking 

the two new vertices. 

e When three edges of a face are selected: 

o If the face is a triangle, this means the whole face is 
selected and it is then subdivided in four smaller 
triangles. 

o If the face is a quad, first the two opposite edges are 
subdivided as described above. Then, the “middle” 
edge is subdivided, affecting its new “sub-quad” as 
described above for only one edge. 


[e) 


(e) 


e When a face of a Quad is selected, the face is subdivided 
into four smaller quads. 

e When a face of an N-gon is selected, the individual edges 
will be subdivided but the face will stay unsubdivided. 


Options 


These options are available in the Too/ panel after running the 
tool: 


Number of Cuts 
Specifies the number of cuts per edge to make. By default 
this is 1, cutting edges in half. A value of 2 will cut it into 
thirds, and so on. 


Smoothness 
Displaces subdivisions to maintain approximate curvature. 
The effect is similar to the way the Subdivision Surface 
Modifier might deform the mesh. 


Mesh Subdivided oe 
before with no socthing 
subdividing. smoothing. ae. 


Quad/Tri Mode 
Forces subdivide to create triangles or quads instead of n- 
gons (see examples below). This mode doesn’t allow the use 
of Straight Cut on quad corners. 


Quad Corner Type 


Controls the way quads with only two adjacent selected 
edges are subdivided. 


Fan 
The quad is subdivided in a fan of four triangles, the 
common vertex being the one opposite to the selected 
edges. 


Inner Vertices 
The selected edges are subdivided, then an edge is 
created between the two new vertices, creating a small 
triangle. This edge is alSo subdivided, and the “inner 
vertex” thus created is linked by another edge to the one 
opposite to the original selected edges. All this results in a 
quad subdivided in a triangle and two quads. 


Path 
First an edge is created between the two opposite ends of 
the selected edges, dividing the quad in two triangles. 
Then, the same goes for the involved triangle as 
described above. 


Straight Cut 
The selected edges are subdivided, then an edge is 
created between the two new vertices, creating a small 
triangle and n-gon. 


Inner 
a Warines dal cut 
yPS cut type. a 


Fractal 


Displaces the vertices in random directions after the mesh is 
subdivided. 


Same 
Plane a eaniGe mesh 
pele subdivision _ 
subdivision. : fractal 

added. 


Along Normal 
Causes the vertices to move along their normals, instead of 
random directions. 


Along normal set to 1. 


Random Seed 
Changes the random seed of the Fractal noise function, 
producing a different result for each seed value. 


Same mesh with a different seed value. 


Examples 


Below are several examples illustrating the various possibilities 
of the Subdivide and Subdivide Multi tools. Note the selection 
after subdivision. 


The sample mesh. 


One Edge 


One Edge. Quad/Tri Mode. 


Two Tri Edges 


Quad/Tri Mode. 


Two Opposite Quad Edges 


Quad/Tri Mode. 


Two Adjacent Quad Edges 


Fan cut type. Quad/Tri Mode. 
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Inner vertices cut 


type. Quad/Tri Mode. 


Path cut type. Quad/Tri Mode. 


Three Edges 


Quad/Tri Mode. 


Tri 


Quad/Tri Mode. 


Quad/Four Edges 


Quad/Tri Mode. 


Multiple Cuts 


Triangle with two cuts. Quad with two cuts. 


Subdivide Edge-Ring 
Reference 


Mode: Edit Mode 
Panel: Edge > Subdivide Edge-Ring 


Take an edge ring, and subdivide with interpolation options. 
Options 
See Bridge Edge Loops. 


Un-Subdivide 


Reference 
Mode: Edit Mode 
Menu: Edge » Un-Subdivide 


Un-subdivide functions as the reverse of subdivide by 
attempting to remove edges that were the result of a 
subdivide operation. If additional editing has been done 
after the subdivide operation, unexpected results may 
occur. 


Iterations 
How many subdivisions to remove. 


Rotate Edge 


Reference 
Mode: Edit Mode 
Menu: Edge >» Rotate Edge CW / Rotate Edge 


CCW 


Rotating an edge clockwise (CW) or counterclockwise (CCW) 
spins an edge between two faces around their vertices. This 
is very useful for restructuring a mesh’s topology. 


The tool operates on selected edges or the shared edge 
between selected faces. 


Two adjacent faces Selected edge 
selected. rotated. 


Selected edge. Edge, rotated CW. 


Warning 


To rotate an edge based on faces you must select adjacent 
face pairs, otherwise Blender notifies you with an error 
message, “Could not find any select edges that can be 
rotated”. Using either Rotate Edge CW or Rotate Edge 
CCW will produce exactly the same results as if you had 
selected the common edge. 


Edge Slide 


Reference 
Mode: Edit Mode 
Menu: Edge » Edge Slide 


Slides one or more edges across adjacent faces with a few 
restrictions involving the selection of edges (i.e. the 
selection must define a valid loop, see below). 


Evene 
Forces the edge loop to match the shape of the adjacent 
edge loop. You can flip to the opposite vertex using F. Use 
Alt-Wheelt to change the control edge. 


Flipped F 
When Even mode is active, this flips between the two 
adjacent edge loops the active edge loop will match. 


Clamp Alt or Cc 
Toggle clamping the slide within the edge extents. 


Factor 
Determines the amount of slide performed. Negative 
values correspond to slides toward one face, while 
positive ones, refer to the other one. It is also displayed 
in the 3D Viewport footer. 


Mirror Editing 
Lets you propagate the operation to the symmetrical 
elements of the mesh (if present, in local X direction). 


Correct UVs 


Corrects the corresponding UV coordinates, if these exist, 
to avoid image distortions. 


Usage 


By default, the position of vertices on the edge loop move 
as a percentage of the distance between their original 
position and the adjacent edge loop, regardless of the 
edges’ lengths. 


a / 


Repositioned edge 


Selected edge loop. loop 


Even Mode 


Even mode keeps the shape of the selected edge loop the 
same as one of the edge loops adjacent to it, rather than 
Sliding a percentage along each perpendicular edge. 


In Even mode, the tool shows the position along the length 
of the currently selected edge which is marked in yellow, 
from the vertex that has an enlarged red marker. Movement 
of the sliding edge loop is restricted to this length. As you 


move the mouse the length indicator in the header changes 
showing where along the length of the edge you are. 


To change the control edge that determines the position of 
the edge loop, use the Alt-wheel to scroll to a different edge. 


4 


Even Mode with Flip 
enabled. 


Even Mode enabled. 


Moving the mouse moves the selected edge loop towards or 
away from the start vertex, but the loop line will only move 
as far as the length of the currently selected edge, 
conforming to the shape of one of the bounding edge loops. 


Limitations & Workarounds 


There are restrictions on the type of edge selections that 
can be operated upon. Invalid selections are: 


Loop Crosses Itself 
This means that the tool could not find any suitable faces 
that were adjacent to the selected edge(s). An example 
that shows this is selecting two edges that share the 
same face. A face cannot be adjacent to itself. 


Multiple Edge Loops 


The selected edges are not in the same edge loop, which 
means they do not have a common edge. You can 
minimize this error by always selecting edges end-to-end 
or ina “chain”. If you select multiple edges just make 
sure they are connected. This will decrease the possibility 
of getting looping errors. 


Border Edges 
When a single edge was selected in a single-sided object. 
An edge loop cannot be found because there is only one 
face. Remember, edge loops are loops that span two or 
more faces. 


A general rule of thumb is that if multiple edges are 
selected they should be connected end-to-end such that 
they form a continuous chain. This is /iterally a general rule 
because you can still select edges in a chain that are invalid 
because some of the edges in the chain are in different 
edge loops. 


Offset Edge Slide 


Reference 

Mode: Edit Mode 

Tool: Edge >» Offset Edge Slide 
Shortcut: Shift-Ctrl-R 


Add two edge loops on either side of selected loops. 


Cap Endpoint 
Extends the loop by creating triangles at endpoints. 


Factor 
Location of the loop relative to the center loop and the 
outside edge loops. 


Even 
Only available for single edge loops. This matches the 
Shape of the edge loop to one of the adjacent edge loops. 
(See Edge Slide tool for details.) 


Flipped 
When Even is enabled, this flips the target edge loop to 
match. (See Edge Slide tool for details.) 


Clamp 
Clamp within the edge extents. 


Correct UVs 
Correct UV coordinates when transforming. 


Loop Cut and Slide 


Reference 

Mode: Edit Mode 

Menu: Edge >» Loop Cut and Slide 
Shortcut: Ctrl-R 


Loop Cut and Slide splits a loop of faces by inserting a new 
edge loop intersecting the chosen edge. 


Usage 


The tool is interactive and has two steps: 
1. Pre-Visualizing the Cut 


After the tool is activated, move the cursor over a 
desired edge. The cut to be made is marked with a 
magenta colored line as you move the mouse over the 
various edges. The to be created edge loop stops at the 
poles (tris and n-gons) where the existing face loop 
terminates. 


2. Sliding the new Edge Loop 


Once an edge is chosen via LMB, you can move the 
mouse along the edge to determine where the new 
edge loop will be placed. This is identical to the Edge 
Slide tool. Clicking LMB again confirms and makes the cut 
at the pre-visualized location, or clicking RMB forces the 
cut to exactly 50%. This step is skipped when using 
multiple edge loops (see below). 


Interactive 


placement 
ene Preview of of edge 
inserting edge loop loop 
edge loop. location. ats 
loops. 
Options 


These options are available while the tool is in use, and later 
in the Adjust Last Operation panel. 


Number of Cuts Wheel or PageUp / PageDown 
After activating the tool, but before confirming initial loop 
location, you can increase and decrease the number of 
cuts to create, by entering a number with the keyboard, 
scrolling Wheel Or uSiNg PageUp and PageDown. 


Note 

When creating multiple loops, these cuts are uniformly 
distributed in the original face loop, and you will not be 
able to control their positions. 


Preview of multiple Result of using 
edge loops. multiple cuts. 


Smoothness Alt -Wheel 
Smoothing causes edge loops to be placed in an 
interpolated position, relative to the face it is added to, 
causing them to be shifted outwards or inwards by a 
given percentage, similar to the Subdivide Smooth tool. 
When not using smoothing, new vertices for the new 
edge loop are placed exactly on the pre-existing edges. 
This keeps subdivided faces flat, but can distort 
geometry, particularly when using Subdivision Surfaces. 
Smoothing can help maintain the curvature of a surface 
once it is subdivided. 


Same edge loops, 
but with smoothing 
value. 


Added edge loops 
without smoothing. 


Falloff 


Falloff type for Smoothness, changes the shape of the 
profile. 


Factor 
Position of the edge loop relative to the surrounding edge 
loops. 


Evene 
Only available for single edge loops. This matches the 
Shape of the edge loop to one of the adjacent edge loops. 
(See Edge Slide tool for details.) 


Flip F 
When Even is enabled, this flips the target edge loop to 
match. (See Edge Slide tool for details.) 


Clamp 
Clamp within the edge extents. 


Correct UVs 
Corrects the corresponding UV coordinates, if these exist, 
to avoid image distortions. 


Edge Data 


Edges can have several different properties that affect how 
certain other tools affect the mesh. 


Edge Crease 


Reference 

Mode: Edit Mode 

Menu: Edge » Edge Crease 
Shortcut: Shift-E 


This operator interactively sets the Edge Crease amount by 
moving the mouse (or typing a value with the keyboard). 
Selecting more than one edge will adjust the mean 
(average) crease value. A negative value will subtract from 


the actual crease value, if present. To clear the crease edge 
property, enter a value of -1. 


Edge Bevel Weight 


Reference 
Mode: Edit Mode 
Menu: Edge > Edge Bevel Weight 


This edge property, a value between (0.0 to 1.0), is used by 
the Bevel Modifier to control the bevel intensity of the 
edges. This operator enters an interactive mode (a bit like 
transform tools), where by moving the mouse (or typing a 


value with the keyboard) you can set the bevel weight of 
selected edges. If two or more edges are selected, this 
operator alters the average weight of the edges. 

See also 


Vertex Bevel Weight 


Mark Seam & Clear Seam 


Reference 


Mode: Edit Mode 
Menu: Edge > Mark Seam/Clear Seam 


These operators set or unset this mark for selected edges. 
Seams are a way to create separations, “islands”, in UV 
maps. See the UV Mapping section for more details. 


Mark Sharp & Clear Sharp 


Reference 


Mode: Edit Mode 
Menu: Edge » Mark Sharp/Clear Sharp 


The Sharp mark is used by the split normals and the Edge 
Split modifier, which are part of the smoothing or 
customized shading techniques. As seams, it is a property of 
edges, and these operators set or unset it for selected ones. 


Face Tools 


Extrude Faces 
Extrude Faces Along Normals 
Extrude Individual Faces 
Inset Faces 

o Options 
Poke Faces 
Triangulate Faces 
Triangles to Quads 
Solidify Faces 
Wireframe 
Fill 
Grid Fill 
Beautify Faces 
Intersect (Knife) 
Intersect (Boolean) 
Weld Edges into Faces 
Shade Smooth & Flat 

0 Shade Smooth 

o Shade Flat 
e Face Data 
o Rotate Colors 
o Reverse Colors 
o Rotate UVs 
o Reverse UVsS 
o Mark Freestyle Face 


Clear Freestyle Face 


Extrude Faces 


Reference 

Mode: Edit Mode 

Menu: Mesh » Face » Extrude Faces 
Shortcut: E 


Extrude Faces duplicate faces, while keeping the new 
geometry connected with the original vertices. 


Single vertex Single edge 
extruded. extruded. 


This tool is of paramount importance for creating new 
geometry. It allows you to create parallelepipeds from 
rectangles and cylinders from circles, as well as easily 
creating such things as tree limbs. 


The axis on which faces are extruded along can be set 
interactively. Faces are extruded by default along their 


averaged normal. The extrusion can be limited to a single 
axis by specifying an axis; see Axis Locking. 


The extrude tools differentiate in how the new geometry is 
connected in itself. Only the border loop gets extruded. The 
inner region of the selection gets moved unchanged with 
the extrusion. 


Selected During Set to Z 
face. extrude. axis. 


Flip Normals 
Only the normals of the new faces created from the 
extrusion will be flipped. 


Dissolve Orthogonal Edges 
Removes and connects edges whose faces form a flat 
surface and intersect new edges. 


Orientation 
Aligns the transformation axes to a specified orientation 
constraint. See Transform Orientations for more 
information. 


Proportional Editing 
The extruded face will affect nearby geometry. See 
Proportional Editing for a full reference. 


Note 


Even with the Proportional Size set to it’s minimum, it 
will extrude the selected face as well as the new 
geometry and they will be layered on top of each other. 


Extrude Faces Along 
Normals 


Reference 

Mode: Edit Mode 

Tool: Toolbar » Extrude Region » Extrude 
Along Normals 

Menu: Mesh >» Extrude » Extrude Faces Along 
Normals 

Shortcut: ALt-E 


Extrusion and offset will be locked in to only move along the 
local normals of the selected mesh. 


Flip Normals 
Only the normals of the new faces created from the 
extrusion will be flipped. 


Dissolve Orthogonal Edges 
Removes and connects edges whose faces form a flat 
surface and intersect new edges. 


Offset 
Amount to move geometry along the normals. 


Offset Even 
The length of the new edges will be uniform. 


Proportional Editing 
The extruded face will affect nearby geometry. See 
Proportional Editing for a full reference. 


Extrude Individual Faces 


Reference 

Mode: Edit Mode 

Tool: Toolbar » Extrude Region » Extrude 
Individual 

Menu: Mesh » Extrude » Individual Faces 

Shortcut: ALt-E 


This tool allows you to extrude a selection of multiple faces 
as individuals, instead of as a region. The faces are extruded 
along their own normals, rather than their average. This has 
several consequences: first, “internal” edges (i.e. edges 
between two selected faces) are no longer deleted (the 
Original faces are). 


Selection Extruded Extruded 
of multiple as using 
faces. extrude Extrude 


region. Individual. 


Inset Faces 


Reference 

Mode: Edit Mode 

Tool: Toolbar > Inset Faces 
Menu: Face > Inset Faces 
Shortcut: I 


This tool takes the currently selected faces and creates an 
inset of them, with adjustable thickness and depth. Think of 
it as like creating an edge loop, but relative to the selected 
edges, even in complex meshes. 


The tool is modal, such that when you activate it, you may 
adjust the thickness with your mouse position. You may also 


adjust the depth of the inset during the modal operation by 
holding ctrl. 


Result of inset with 
Selection to inset. Select Outer 


enabled. 


Options 


Boundary B 
Determines whether open edges 
will be inset or not. 


Offset Even 
Scale the offset to give a more 
even thickness. 


Offset Relative 
Scale the offset by lengths of 
surrounding geometry. 


Edge Rail 
Created vertices slide along the 
original edges of the inner 
geometry, instead of the 
normals. 


Thickness 
Set the size of the offset. 


Depth ctrl 


Boundary 


Offset Even 


__—0.0500 * 


~ Interpolate 


Inset operator options. 


Raise or lower the newly inset faces to add depth. 


Outset 0 


Create an outset rather than an inset. Causes the 
geometry to be created surrounding selection (instead of 


within). 


Select Outer 


Toggle which side of the inset is selected after the 


operation. 


Individual 1 


By default the Inset tool operates on the region around 
selected faces, but with this option each selected face 
can be inset on its own. 


Interpolate 
Interpolate mesh data: e.g. UVs, Color Attribute’s colors, 
weights, etc. 


Poke Faces 


Reference 
Mode: Edit Mode 
Menu: Faces » Poke Faces 


Splits each selected faces into a triangle fan, creating a new 
center vertex and triangles between the original face edges 
and new center vertex. The Offset can be used to make 
spikes or depressions. 


Poke Offset 
Offset the new center vertex along the face normal. 


Offset Relative 


Multiply the Offset by the average length from the center 
to the face vertices. 


Poke Center 
Computes the center of a face. 


Weighted Mean 
Using the mean average weighted by edge length. 


Mean 
Using the mean average. 


Bounds 
Uses center of bounding box. 


Triangulate Faces 


Reference 

Mode: Edit Mode 

Menu: Face > Triangulate Faces 
Shortcut: Ctrl-T 


This tool converts each of the selected faces (whether it be 
quads or n-gons) to triangular faces. See the Triangulate 
Modifier. 


Triangles to Quads 


Reference 

Mode: Edit Mode 

Menu: Face > Triangles to Quads 
Shortcut: Alt=J 


This tool converts the selected triangles into quads by 
taking adjacent triangles and removing the shared edge to 
create a quad, based on a threshold. This tool can be 
applied on a selection of multiple triangles. 


This means you can select the entire mesh and convert 
triangles that already form square shapes - to be converted 
into quads, without having to concern yourself with 
individual faces. 


Alternatively you can force this operation selecting a pairs 
of faces (see hint below for other ways of joining). 


To create a quad, this tool needs at least two adjacent 
triangles. If you have an even number of selected triangles, 
it is also possible not to obtain only quads. In fact, this tool 
tries to create most even rectangular quads from the given 
triangles, which means some triangles could remain. 


Before converting After converting tris 
tris to quads. to quads. 


Max Angle 
This value, between (0 to 180), controls the threshold for 
this tool to work on adjacent triangles. With a threshold 
of 0.0, it will only join adjacent triangles that form a 
perfect rectangle (i.e. right-angled triangles sharing their 
hypotenuses). Larger values are required for triangles 
with a shared edge that is small, relative to the size of 
the other edges of the triangles. 


Compare UVs 
When enabled, it will prevent the union of triangles that 
are not also adjacent in the active UV map. 


Compare VCols 
When enabled, it will prevent the union of triangles that 
have no matching Color Attribute color. 


Compare Sharp 
When enabled, it will prevent the union of triangles that 
Share an edge marked as sharp. 


Compare Materials 
When enabled, it will prevent the union of triangles that 
do not have the same material assigned. 


Hint 


When isolated groups of faces are selected, they can be 
combined with Create Face or Dissolve Faces; this is not 
limited to quads. 


Solidify Faces 


Reference 
Mode: Edit Mode 
Menu: Face » Solidify Faces 


This takes a selection of faces and solidifies them by 
extruding them uniformly to give volume to a Non-manifold 
surface. This is alSo available as a Modifier. After using the 
tool, you can set the offset distance in the Adjust Last 
Operation panel. 


Thickness 
Amount to offset the newly created surface. Positive 
values offset the surface inward relative to the normals 
direction. Negative values offset outward. 


Mesh Solidify Solidify 
before with a with a 
solidify positive negative 


operation. thickness. thickness. 


Wireframe 


Reference 
Mode: Edit Mode 
Menu: Face > Wireframe 


The Wireframe tool makes a wireframe from faces by 
turning edges into wireframe tubes, similar to the Wireframe 
Modifier. 


Fill 


Reference 

Mode: Edit Mode 
Menu: Face > Fill 
Shortcut: Alt-F 


The Fill option will create triangular faces from any group of 


selected edges or vertices, as long as they form one or more 
complete perimeters. 


Beauty 
Arrange the new triangles nicely. 


Filled using fill. 


Note, unlike creating n-gons, Fill supports holes. 


A closed perimeter Filled using fill. 
of edges with holes. 


Grid Fill 


Reference 
Mode: Edit Mode 
Menu: Face > Grid Fill 


Grid Fill uses a pair of connected edge loops or a single, 
closed edge loop to fill in a grid that follows the surrounding 
geometry. 


The best predictable result can be achieved if you select two 
opposite edge loops with an equal number of vertices. When 
a single, closed edge loop is selected, the Span/Offset 
options allows you to adjust the way two opposite edge 
loops are detected from one closed edge loop. 


Span 
Specifies the number of columns in the grid. 


Offset 
Defines the vertex that is considered to be the corner of 
the grid, by default, it’s the active vertex. The Offset 
allows you to rotate the grid lines. 


Simple Blending 
Use a simple interpolation algorithm to generate grid 
vertices from boundary loops, which does not tries to 
maintain the shape, useful for flat surfaces or times when 
keeping the shape gives odd results. 


Input. Grid Fill result. 


Beautify Faces 


Reference 
Mode: Edit Mode 
Menu: Face > Beautify Faces 


Beautify Faces works only on selected existing faces. It 
rearrange selected triangles to obtain more “balanced” ones 


(i.e. less long thin triangles). 
Max Angle 


An angle delimiter option to limit edge rotation to flat 
Surfaces. 


Text converted to a Result of Beautify 
mesh. Faces. 


Intersect (Knife) 


Reference 
Mode: Edit Mode 
Menu: Face > Intersect (Knife) 


The Intersect tool lets you cut intersections into geometry. It 
is a bit like the Boolean tool, but, does not calculate 
interior/exterior geometry. Faces are split along the 
intersections, leaving new edges selected. 


Source 
Self Intersect 
Operate on the overlapping geometry of the mesh. 


Selected/Unselected 


Operate between the selected and unselected 
geometry. 


Separate Mode 
All 
Splits the geometry at the new edge. 


Cut 
Keep each side of the intersection separate without 
splitting the faces in half. 

Merge 
Merge all the geometry from the intersection. 


Solver 
Algorithm used to calculate the intersections. 


Fast 


Uses a mathematically simple solver which offers the 
best performance; however, this solver lacks support 
for overlapping geometry. 


Merge Threshold 


Tolerance for close faces to be considered touching. 
It may be useful to increase this when some 
intersections aren’t detected that should be and 
when extra geometry is being created because 
edges aren’t detected as overlapping. 


Warning 


A threshold approaching the size of faces may 
cause very slow calculation, in general keep this 
value small. 


Exact 


Uses a mathematically complex solver which offers 
the best results and has full support for overlapping 
geometry; however, this solver is much slower than 
the Fast Solver. 


Intersect (Boolean) 


Reference 
Mode: Edit Mode 
Menu: Face > Intersect (Boolean) 


Performs Boolean operations with the selection on the 
unselected geometry. While the Boolean Modifier is useful 
for non-destructive edits, access to these operations with a 
tool in Edit Mode can be useful to quickly perform edits. 


Boolean Operation 


Intersect: Opposite of Difference (everything 
inside of the target mesh is kept). 

Union: The target mesh is added to the 
modified mesh. 

Difference: The target mesh is subtracted from the 


modified mesh (everything outside of 
the target mesh is kept). 


Solver 
Algorithm used to calculate the Boolean intersections. 


Fast: Uses a mathematically simple solver 
which offers the best performance; 
however, this solver lacks support for 
overlapping geometry. 

Merge Threshold 
Tolerance for close faces to be 
considered touching. It may be 
useful to increase this when some 
intersections aren’t detected that 


should be and when extra geometry 
is being created because edges 
aren’t detected as overlapping. 


Warning 

A threshold approaching the size of 
faces may cause very slow 
calculation, in general keep this 
value small. 


Exact: Uses a mathematically complex solver 
which offers the best results and has 
full support for overlapping geometry; 
however, this solver is much slower 
than the Fast Solver. 


Swap 
Changes the order of the operations when using 
Difference to determine which side is kept. 


Self Intersection 
Correctly calculates cases when one or both operands 
have self-intersections, this involves more calculations 
making it slower. 


Weld Edges into Faces 


Reference 
Mode: Edit Mode 
Menu: Face >» Weld Edges into Faces 


A tool to split selected faces by loose wire edges. This can 
be used in a similar way to the Knife tool, but the edges are 
manually setup first. 


Shade Smooth & Flat 


The appearance of the mesh edges are determined to be 
evened out or well defined within the 3D Viewport and 
render. In Edit Mode, individual faces can be selected to 
determine which faces are smoothed or flattened. 


Note 


Both Shade Smooth and Flat are also available in Object 
Mode and function the same way. 


Shade Smooth 


Reference 
Mode: Edit Mode 
Menu: Face >» Shade Smooth 


Using interpolated vertex normals, the mesh faces will blur 
at the edges and appear smooth. 


Shade Flat 


Reference 


Mode: Edit Mode 
Menu: Face > Shade Flat 


Face normals are displayed evenly, because of this all the 
edges of the selected mesh will be easily visible. 


Tip 
Use the Edge Split modifier and Auto Smooth within the 


mesh data properties to balance between smooth surfaces 
and sharp edges. 


Face Data 


Rotate Colors 


Reference 


Mode: Edit Mode 
Menu: Face >» Face Data > Rotate Colors 


Rotates the Color Attribute’s colors inside faces either 
clockwise or counterclockwise. 


Reverse Colors 


Reference 


Mode: Edit Mode 
Menu: Face > Face Data > Reverse Colors 


Flips the direction of Color Attribute’s colors inside the 
selected faces. 


Rotate UVs 
Reference 

Mode: Edit Mode 
Menu: 


Face > Face Data » Rotate UVs 


See Rotate UVs. 


Reverse UVs 


Reference 


Mode: Edit Mode 
Menu: Face > Face Data >» Reverse UVs 


See Reverse UVs. 


Mark Freestyle Face 


Reference 

Mode: Edit Mode 

Menu: Face >» Face Data > Mark Freestyle Face 
Todo. 


Clear Freestyle Face 


Reference 


Mode: Edit Mode 
Menu: Face >» Face Data > Clear Freestyle Face 


Todo. 


UV Tools 


Reference 

Editor: 3D Viewport 
Mode: Edit Mode 
Menu: Header >» UV 
Shortcut: U 


Blender offers several ways of mapping UVs. The simpler 
projection methods use formulas that map 3D space onto 
2D space, by interpolating the position of points toward a 
point/axis/plane through a surface. The more advanced 


methods can be used with more complex models, and have 
more specific uses. 


Unwrap 

Reference 

Editor: 3D Viewport and UV Editor 
Mode: Edit Mode 

Menu: UV > Unwrap 

Shortcut: U 


Flattens the mesh surface by cutting along seams. Useful 
for organic shapes. 


Note 


The Unwrap operator is the only UV unwrapping operator 
that takes into account seams. 


Begin by selecting all faces you want to unwrap. In the 3D 
Viewport, select UV >» Unwrap or U and select Unwrap. You 
can also do this from the UV Editor with UV > Unwrap or u. 
This method will unwrap all faces and reset previous work. 
The UVs menu will appear in the UV Editor after unwrapping 
has been performed once. 


Result of unwrapping Suzanne. 


This tool unwraps the faces of the object to provide the 
“best fit” scenario based on how the faces are connected 
and will fit within the image, and takes into account any 
seams within the selected faces. If possible, each selected 
face gets its own different area of the image and is not 
overlapping any other faces UVs. If all faces of an object are 
selected, then each face is mapped to a part of the image. 


Options 


Blender has two ways of calculating the unwrapping. They 
can be selected in the tool setting in the tool panel in the 3D 
Viewport. 


Angle Based 
This method gives a good 2D representation of a mesh. 


Conformal 
Uses LSCM (Least Squares Conformal Mapping). This 
usually gives a less accurate UV mapping than Angle 
Based, but works better for simpler objects. 


Fill Holes 
Activating Fill Holes will prevent overlapping from 


occurring and better represent any holes in the UV 
regions. 


Correct Aspect 
Map UVs taking image aspect into account. 


Use Subdivision Surface Modifier 


Map UVs taking vertex position after Subdivision Surface 
Modifier into account. 


Margin 
Space between UV islands. 


Tip 


A face’s UV image texture only has to use part of the 
image, not the whole image. Also, portions of the same 
image can be shared by multiple faces. A face can be 
mapped to less and less of the total image. 


Smart UV Project 


Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Menu: UV > Smart UV Project 
Shortcut: U 


Smart UV Project, cuts the mesh based on an angle 
threshold (angular changes in your mesh). This gives you 
fine control over how automatic seams are be created. It is 
good method for simple and complex geometric forms, such 
as mechanical objects or architecture. 


This algorithm examines the shape of your object, the faces 
selected and their relation to one another, and creates a UV 
map based on this information and settings that you supply. 


In the example below, the Smart Mapper mapped all of the 
faces of a cube to a neat arrangement of three sides on top, 
three sides on the bottom, for all six sides of the cube to fit 
squarely, just like the faces of the cube. 


Smart UV project on a cube. 


For more complex mechanical objects, this tool can quickly 
and easily create a regular and straightforward UV layout for 
you. 


Options 


The Adjust Last Operation panel allows fine control over how 
the mesh is unwrapped: 


Angle Limit 
This controls how faces are grouped: a higher limit will 
lead to many small groups but less distortion, while a 
lower limit will create fewer groups at the expense of 
more distortion. 


Island Margin 
This controls how closely the UV islands are packed 


together. A higher number will add more space between 
islands. 


Area Weight 
Weight projection’s vector by faces with larger areas. 


Lightmap Pack 


Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Menu: UV > Lightmap Pack 


Shortcut: U 


Lightmap Pack takes each of a mesh’s faces, or selected 
faces, and packs them into the UV bounds. Lightmaps are 
used primarily in realtime rendering, where lighting 
information is baked onto texture maps, when it is needed 
to use as much UV space as possible. It can also work on 
several meshes at once. It has several options that appear 
in the Toolbar: 


You can set the tool to map just Se/ected Faces or All Faces 
if working with a single mesh. 


The Selected Mesh Object option works on multiple meshes. 
To use this, in Object Mode select several mesh objects, 
then go into Edit Mode and activate the tool. 


Options 


Share Texture Space 
This is useful if mapping more than one mesh. It 
attempts to fit all of the objects’ faces in the UV bounds 
without overlapping. 


New UV Map 
If mapping multiple meshes, this option creates a new UV 
map for each mesh. See UV Maps. 


New Image 
Assigns new images for every mesh, but only one if 
Shared Tex Space is enabled. 


Image Size 
Set the size of the new image. 


Pack Quality 
Pre-packing before the more complex Box packing. 


Margin 
This controls how closely the UV islands are packed 


together. A higher number will add more space between 
islands. 


Follow Active Quads 


Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Menu: UV > Follow Active Quads 
Shortcut: U 


The Follow Active Quads tool takes the selected faces and 
lays them out by following continuous face loops, even if the 
mesh face is irregularly-shaped. Note that it does not 
respect the image size, so you may have to scale them all 
down a bit to fit the image area. 


Options 


Edge Length Mode 
Even 
Space all UVs evenly. 


Length 
Todo. 


Length Average 
Average space UVs edge length of each loop. 


Note 


Please note that it is the shape of the active quad in UV 
space that is being followed, not its shape in 3D space. To 
get a clean 90-degree unwrap make sure the active quad 
is a rectangle in UV space before using “Follow active 
quad”. 


Cube Projection 


Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Menu: UV > Cube Projection 
Shortcut: U 


Cube Projection maps the mesh onto the faces of a cube, 
which is then unfolded. It projects the mesh onto six 
separate planes, creating six UV islands. In the UV editor, 
these will appear overlapped, but can be moved. See 
Editing_UVs. 


Options 


Cube Size 
Set the size of the cube to be projected onto. 


Common 


The following settings are common for the Cube, Cylinder, 
and Sphere mappings: 


Correct Aspect 


Map UVs will take the images aspect ratio into 
consideration. If an image has already been mapped to 
the Texture Space that is non-square, the projection will 
take this into account and distort the mapping to appear 
correct. 


Clip to Bounds 
Any UVs that lie outside the (0 to 1) range will be clipped 
to that range by being moved to the UV space border it is 
closest to. 


Scale to Bounds 
If the UV map is larger than the (0 to 1) range, the entire 
map will be scaled to fit inside. 


Cylinder Projection 


Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Menu: UV > Cylinder Projection 
Shortcut: U 


Normally, to unwrap a cylinder (tube) as if you slit it 
lengthwise and folded it flat, Blender wants the view to be 
vertical, with the tube standing “up”. Different views will 
project the tube onto the UV map differently, skewing the 
image if used. However, you can set the axis on which the 
calculation is done manually. 


Options 


Direction 


View on Poles 
Use when viewing from the top (at a pole) by using an 
axis that is straight down from the view. 


View on Equator 
Use if view is looking at the equator, by using a 
vertical axis. 


Align to Object 
Uses the object’s transform to calculate the axis. 


Align 
Select which axis is up. 


Polar ZX 
Polar O is on the X axis. 


Polar ZY 
Polar 0 is on the Y axis. 


Radius 
The radius of the cylinder to use. 


Sphere Projection 


Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Menu: UV > Sphere Projection 
Shortcut: U 


Spherical mappings is similar to cylinder but the difference 
is that a cylindrical mapping projects the UVs on a plane 
toward the cylinder shape, while a spherical map takes into 


account the sphere’s curvature, and each latitude line 
becomes evenly spaced. Sphere Projection is useful for 
spherical shapes, like eyes, planets, etc. 


Recall the opening cartographer’s approaching to mapping 
the world? Well, you can achieve the same here when 
unwrapping a sphere from different points of view. Normally, 
to unwrap a sphere, view the sphere with the poles at the 
top and bottom. After unwrapping, Blender will give you an 
equirectangular projection; the point at the equator facing 
you will be in the middle of the image. A polar view will give 
a very different but common projection map. Using an 
equirectangular projection map of the earth as the UV 
image will give a good planet mapping onto the sphere. 


F wl | =e al a 
“|| «€ eee 
SB RBES Zee: 

a : 


aaa 
Tks Ie 


Using an equirectangular image with a Sphere 
Projection. 


Options 


Direction 
View on Poles 
Use when viewing from the top (at a pole) by using an 
axis that is straight down from the view. 


View on Equator 


Use if view is looking at the equator, by using a 
vertical axis. 


Align to Object 
Uses the object’s transform to calculate the axis. 


Align 
Select which axis is up. 


Polar ZX 
Polar O is on the X axis. 


Polar ZY 
Polar O is on the Y axis. 


Radius 
The radius of the sphere to use. 


Project from View 


Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Menu: UV > Project from View 
Shortcut: U 


Project from View takes the current view in the 3D Viewport 
and flattens the mesh as it appears. Use this option if you 
are using a picture of a real object as a UV Texture for an 
object that you have modeled. You will get stretching in 
areas where the model recedes away from you. 


Options 


See also Common options. 


Orthographic 
Apply an orthographic projection. 


Project from View (Bounds) 


Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Menu: UV > Project from View (Bounds) 
Shortcut: U 


Similar to Project from View, but with Scale to Bounds and 
Correct Aspect activated. 


Reset 

Reference 

Editor: 3D Viewport and UV Editor 
Mode: Edit Mode 

Menu: UV > Reset 

Shortcut: U 


Reset UVs maps each face to fill the UV grid, giving each 
face the same mapping. 


If you want to use an image that is tileable, the surface will 
be covered in a smooth repetition of that image, with the 
image skewed to fit the shape of each individual face. Use 


this unwrapping option to reset the map and undo any 
unwrapping (go back to the start). 


Properties 


e Object Data 
o Vertex Groups 
Shape Keys 
UV Maps 
Color Attributes 
Face Maps 
Attributes 
Normals 
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Geometry Data 
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o Vertex Weights 
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Object Data 


Meshes 
The mesh Data-Block Menu can be used to link the data 
between objects. 


Vertex Groups 


Vertex groups can be used to assign a group or weighted 
group to some operator. An object can have several weight 
groups and can be assigned in Weight Paint mode, or in Edit 
Mode via this panel. 


See Vertex Groups for more information. 


Shape Keys 


Shape Keys can be used to transform one shape into 
another. See Shape Keys Panel for more information. 


UV Maps 


UV Maps are used to map a 3D object onto a 2D plane that 
determines where a texture appears on the 3D object. 
Different UV Maps can be used for different textures. For 
more information see UV Maps. 


Color Attributes 


Color data can be applied directly to an object’s vertices 
rather than using a texture or a material. There are two 
modes to paint color attributes in. Use Vertex Paint mode to 
paint per face corner by enabling the paint mask in the 
header. This is useful to achieve sharp edges in the color 
attribute on low-poly assets. Alternatively use Sculpt mode 
to paint on a much higher vertex count. 


Creating a New Color Attribute 


To create a new Color Attribute select the plus icon next to 
the list of attributes. This action will open a pop-up with the 
following information. 


Name 
The name of the Color Attribute which can be referenced 
elsewhere in Blender. 


Domain 
The associated part of the geometry that stores the 
attribute. See Attribute Domains for more information. 


Vertex: Color Attributes are stored per each 
vertex. 

Face Corner: Color Attributes are stored per each 
corner of a face. 


Data Type 
The data type to represent colors internally. 
Color: RGBA color with floating-point 
precision. 
Byte Color: RGBA color with 8-bit precision. 
Color 


The default color to fill for every element in the domain. 


Color Attribute Specials 


These are operators that are available in the menu to the 
right of the attribute list. 


Duplicate Color Attribute 
Creates a copy of the active color attribute in the list. 


Face Maps 


Face Maps create custom gizmos to deform meshes by 
assigning faces to Face Maps. They can be used to rig 
quickly within Object Mode and without making complicated 
rigging setups. Face Maps are currently not fully 
implemented in Blender and require add-ons to take full 
advantage of this feature. 


See also 


Auto Face Map Widgets add-on 


Attributes 


An attribute is data stored per mesh element. Every 
attribute has a data type, domain and name. This panel only 
lists custom attributes which excludes all the built-in 
attributes like position and other attributes like vertex 
groups. 


See Attributes Reference for more information. 


Normals 


In geometry, a normal is a direction or line that is 
perpendicular to something, typically a triangle or surface 
but can also be relative to a line, a tangent line for a point 
on a curve, or a tangent plane for a point on a surface. 
Normals help to determine the shading of the mesh among 
other things. 


See Normal Properties for more information. 


Texture Space 


Each object can have an automatically generated UV map, 
these maps can be adjusted here. 


See Generated UV Properties for more information. 


Remesh 


Mesh objects, in particular meshes that have been modeled 
to represent organic objects, often have geometry that is 
not particularly uniform. This can cause problems if the 
object needs to be rigged or just needs simpler geometry 
for workflows such as 3D printing. Remeshing is a technique 
that rebuilds the geometry with a more uniform topology. 
Remeshing can either add or remove the amount of 
topology depending on the defined resolution. Remeshing is 
especially useful for sculpting, to generate better topology 
after blocking out the initial shape. 


See Mesh Retopology for more information. 


Geometry Data 


Mesh objects can have different types of custom data 
attached to them. This data is mostly used internally and 
can be exported by some exporters. See Geometry Data for 
more information. 


Vertex Groups 


Introduction 
o Usage 
e Vertex Groups Panel 
o Editing Vertex Groups 
e Assigning_a Vertex Group 
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o Deleting Vertex Groups 
o Locking Vertex Groups 
o Working with Content of Vertex Groups 
e Vertex Weights 
o Vertex Group Categories 
Weight Table 
Tools 
Locking 
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Introduction 


Vertex groups are mainly 
used to tag the vertices 
belonging to parts of a 
mesh object or Lattice. 
Think of the legs of a chair 
or the hinges of a door, or 
hands, arms, limbs, head, 
feet, etc. of a character. In 
addition you can assign 
different weight values (in 
the range O to 1) to the 
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The Vertex Groups panel. 


vertices within a vertex group. Hence vertex groups are 
sometimes also named ‘weight groups’. 


Usage 


Vertex groups are most commonly used for armatures. But 
they are also used in many other areas of Blender, like for 


example: 


e Armature deformation (also called skinning) 


e Shape keys 

e Modifiers 

e Particle generators 
e Physics simulations 


See also 


Skinning_Mesh Objects. 


Many more usage scenarios are possible. Actually you can 
use vertex groups for whatever makes sense to you. In 
some contexts vertex groups can also be automatically 
generated (e.g. for rigged objects). However, in this section 
we will focus on manually created (user-defined) vertex 
groups. 


Note 


Vertex groups only apply to mesh and lattice objects. 


Vertex Groups Panel 


Reference 

Mode: All Modes 

Panel: Object Data tab » Vertex Groups 
¥ Vertex Groups 

Vertex groups are 

maintained within the faz mPelvis 
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Active Vertex Group 
A List view. 


co 


Lock The Vertex Group panel. 


Locks the group from 
being editable. You 
can only rename or delete the group. 


Add + 
Create an empty vertex group. 


Remove - 
Deletes the active vertex group. 


Specials 
Sort by Name 
Sorts vertex groups alphabetically. 


Sort by Bone Hierarchy 
(Todo) 


Copy Vertex Group 


Add a copy of the active vertex group as a new 
group. The new group will be named like the 
original group with “ copy” appended at the end of 
its name. And it will contain associations to exactly 
the same vertices with the exact same weights as 
in the source vertex group. 


Copy Vertex Group to Selected 
Copy all vertex groups to other selected objects 
provided they have matching indices (typically this 
is true for copies of the mesh which are only 
deformed and not otherwise edited). 


Mirror Vertex Group 
Mirrors weights and/or flips group names. See 
Mirror Vertex Group for more information. 


Mirror Vertex Group (Topology) 
Performs the Mirror Vertex Group with the Topology 
Mirror option enabled. 


Remove from All Groups 
Unassigns the selected vertices from all (even 
locked) groups. After this operation has been 
performed, the vertices will no longer be contained 
in any vertex group. (Not available for locked 
groups.) 


Clear Active Group 
Remove all assigned vertices from the active 
group. The group is made empty. Note that the 
vertices may still be assigned to other vertex 
groups of the object. (Not available for locked 
groups.) 


Delete All Unlocked Groups 


Remove all vertex groups from the object that are 
not locked. 


Delete All Groups 
Remove all vertex groups from the object. 


Lock All 
Lock all groups. 


Unlock All 
Unlock all groups. 


Lock Invert All 
Invert group locks. 


Editing Vertex Groups 


Reference 


Mode: Edit Mode 

Panel: Object Data tab » Vertex Groups 
Menu: Vertex >» Vertex Groups 
Shortcut: Ctrl-G 
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Assign Remove Select Deselect 


can be 

edited. 

The same operations are available in the 3D Viewport’s 
Vertex » Vertex Groups menu or Ctrl-G. 


Assign 
To assign the selected vertices to the active group with 
the weight as defined in the Weight (see below). 


Remove 
To remove the selected vertices from the active group 
(and thus also delete their weight values). 


Select 
To select all vertices contained in the group. 


Deselect 
To deselect all vertices contained in the group. 


Weight 
The weight value that gets assigned to the selected 
vertices. 


Set Active Group 
Lets you select the group that will become the active one 
(menu only). 


Assigning a Vertex Group 


Creating Vertex Groups 


Vertex groups are 
maintained within the 
Object Data tab (1) in 
the Properties. As long 
as no vertex groups are 
defined (the default for 
new mesh objects), the 
panel is empty (2). 


You create a vertex 
group by LmB on the Add 
button + on the right 
panel border (3). Initially 
the group is named 
“Group” (or “Group.nnn” 
when the name already 
exists) and gets 
displayed in the panel 
(2) (see next image). 
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>» Shape Keys 
» UV Maps 

® Vertex Colors 
» Face Maps 


» Normals 


>» Texture Space 


» Remesh 
» Geometry Data 


» Custom Properties 


Empty Vertex Groups panel. 


Vertex Groups Panel Controls 


Once a new vertex group has been added, the new group 
appears in the Vertex Groups panel. There you find three 


clickable elements: 


Group Name ¥ Vertex Groups 
The group name can be 
changed by double- 
clicking LMB on the name 
itself. Then you can edit m 
the name as you like. = 


e 
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Filter (a rrow icon) Assign Remove Select Deselect 
When the little arrow Weight {1000 
icon in the left lower 
corner is clicked, a new 
row opens up where you 
can enter a search term. 
This becomes handy 
when the number of vertex groups gets big. 


One vertex group. 


Drag Handle 
If you have a large number of vertex groups and you 
want to see more than a few groups, you can LMB on the 
small drag handle to make the vertex groups list larger or 
smaller. 


Active Group 
When a vertex group is created, then it is also 
automatically marked as the Active Group. This is 
indicated by setting the background of the panel entry to 
a light gray color. If you have two or more groups in the 
list, then you can change the active group by LMB on the 
corresponding entry in the Vertex Groups panel. 


Deleting Vertex Groups 


You delete a vertex group by first making it the active group 
(select it in the panel) and then LmB the Remove button - at 
the right panel border. 


Deleting a vertex group DL cHEX Croups 
only deletes the vertex 
assignments to the group. 
The vertices themselves are 
not deleted. 


$29 Group 


Delete a vertex group. 


Locking Vertex Groups 


Right after creation of a aoe 
vertex group, an open 23 Group 
padlock icon shows up on 
the right side of the list 
entry. This icon indicates 
that the vertex group can 
be edited. You can add 
vertex assignments to the 
group or remove Lock a vertex group. 
assignments from the 

group. And you can change 

it with the weight paint brushes, etc. 


When you click on the icon, it changes to a closed padlock 
icon and all vertex group modifications get disabled. You can 
only rename or delete the group, and unlock it again. No 
other operations are allowed on locked vertex groups, thus 
all corresponding buttons become disabled for locked vertex 
groups. 


Working with Content of Vertex 


Groups 


Assigning Vertices to a Group 


You add vertices to a 
group as follows: 


e Select the group from 
the group list, thus 
making it the active 
group (1). 

e From the 3D Viewport 
select Shift-LMB all 
vertices that you want 
to add to the group. 

e Set the weight value 
that shall be assigned 


to all selected vertices 


(2). 
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Assign weights to active group. 


e LMB the Assign button to assign the selected vertices to 
the active group using the given weight (3). 


Note that weight assignment is not available for locked 
vertex groups. The Assign button is grayed out in that case. 


Note 


Assign is additive 


The Assign button only adds the currently selected vertices 
to the active group. Vertices already assigned to the group 
are not removed from the group. 


Also keep in mind that a vertex can be assigned to 
multiple groups. 


Checking Assignments 


To be sure the selected vertices are in the desired vertex 
group, you can try press the deselect button. If the vertices 
remain selected then they are not yet in the current vertex 


group. 


At this point you may assign them, but take care since all 
selected vertices will have their weight set to the value in 
the Weight: field. 


Removing Assignments from a Group 


You remove vertices from a group as follows: 


e Select the group from the group list (make it the active 


group). 

e Select all vertices that you want to remove from the 
group. 

e LMB click the Remove button. 


Note that removing weight assignments is not available for 
locked vertex groups. The Remove button is grayed out in 
that case. 


Using Groups for Selecting/Deselecting 


You can quickly select all assigned vertices of a group: 


e (Optionally) press Alt-A to deselect all vertices. 


e Select the group from the group list (make it the active 
group). 

e When you now LMB click the Se/ect button, then the 
vertices assigned to the active group will be selected 
and highlighted in the 3D Viewport. 

e When you LMB click the Deselect button instead, then the 
vertices assigned to the active group will be deselected 
in the 3D Viewport. 


Note 
Selecting/Deselecting is additive 


If you already have vertices selected in the 3D Viewport, 
then selecting the vertices of a group will add the vertices 
but also keep the already selected vertices selected. Vice 
versa, deselecting the vertices of a vertex group will only 
deselect the vertices assigned to the group and keep all 
other vertices selected. 


Finding Ungrouped Vertices 


You can find ungrouped vertices as follows: 


e Press Alt-A to deselect all vertices. 
e In the header of the 3D Viewport, navigate to Select > 
Select All by Trait » Ungrouped Vertices. 


Vertex Weights 


Reference 
Mode: Edit and Weight Paint Modes 
Panel: Sidebar region >» Vertex Weights 


Vertex Weights panel. 


(1) Vertex Group Categories, (2) Weight Table, (3) 
Tools. 


As mentioned before in Vertex Groups each entry in a vertex 
group also contains a weight value in the range of (0.0 to 
1.0). Blender provides a Vertex Weights panel from where 
you can get (and edit) information about the weight values 
of each vertex of a mesh. That is: to which vertex groups 
the vertex is assigned with which weight value. 


The Vertex Weights panel can be found in the Sidebar region 
of the 3D Viewport. It is available in Edit Mode and in Weight 
Paint Mode (when Vertex Selection masking is enabled as 
well). 


Vertex Group Categories 


Actually we do not have any strict categories of vertex 
groups in Blender. Technically they all behave the same way. 
However, we can identify two implicit categories of vertex 
groups: 


Deform Groups 


These vertex groups are sometimes also named ‘weight 
groups’ or ‘weight maps’. They are used for defining the 
weight tables of armature bones. All deform groups of an 
object are strictly related to each other via their weight 
values. 


Strictly soeaking, the sum of all deform weights for any 
vertex of a mesh should be exactly 1.0. In Blender this 
constraint is a bit relaxed (see below). Nevertheless, deform 
groups should always be seen as related to each other. 
Hence, we have provided a filter that allows restricting the 
Vertex Weight panel to display only the deform bones of an 
object. 


Other Groups 


All other usages of vertex groups are summarized into the 
Other category. These vertex groups can be found within 
Shape keys, Modifiers, etc. There is really no good name for 
this category, so we kept it simple and named it Other. 


Weight Table 


The Weight Table shows all weights associated to the active 
vertex. Note that a vertex does not necessarily have to be 
associated to any vertex groups. In that case the Vertex 
Weights Panel is not displayed. 


Tip 

The active Vertex 

That is the most recently selected vertex. This vertex is 
always highlighted so that you can see it easily in the 
mesh. If the active vertex does not have weights, or there 


is no active vertex selected at the moment, then the 
Vertex Weights Panel disappears. 


Each row in the Weight table contains four active elements: 


Change Active Group. 


Set the Active Group 


As soon as you select any of the Vertex Group Names in the 
Weight table, the referenced vertex group becomes the new 
active group. 


Display Weights in Edit Mode 


When you are in Edit Mode, you can make the weights of 
the active group visible on the mesh: 


Select the Viewport Overlays popover from the header of 
the 3D Viewport. And there enable the Vertex Group 
Weights option. Now you can see the weights of the active 


vertex group 
displayed on the 
mesh surface. 
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Enable display of weights in Edit Mode. 


Weights in Edit Mode. 


Edit Weights in Edit Mode 


It is now very easy to work with vertex groups in Edit Mode. 
All edit options of the mesh are available and you have 
direct visual control over how your weights change when 
you edit the weight values. 


Change Weight value. 


Change a Weight 


You can either enter a new weight value manually (click on 
the number and edit the value), or you can change the 
weight by LMB and while holding down the mouse button, 
drag right or left to increase/decrease the weight value. You 


also can use the right/left arrows displayed around the 
weight value to change the weight in steps. 


Paste weights. 


Pasting 


LMB the Paste button allows you to forward a single weight of 
the active vertex to all selected vertices. But note that 
weights are only pasted to vertices which already have a 
weight value in the affected vertex group. 


Delete weights. 


Deleting 
LMB the Delete button will instantly remove the weight from 


the active vertex. Thus the entire row disappears when you 
click on the delete icon. 


Tools 


Vertex Weights panel. 


Normalize 
Normalizes the weights of the active vertex. That is all 
weights of the active vertex are recalculated such that 


their relative weight is maintained and the weight sum is 
1.0. 


Copy 
Copies all weights defined for the active vertex to all 


selected vertices. Thus all previously defined weights are 
overwritten. 


Tip 

The filter setting is respected 

Note that both tools only work on the vertex groups 
currently displayed in the Weights Table. So if for example 


only the Deform weights are displayed, then Normalize 
and Copy only affect the Deform bones. 


Locking 


Locked Vertex Weights panel. 


Whenever a weight group is locked, all data changing tools 
get disabled: 


e Normalize the vertex weights. 

e Copy the vertex weights. 

e Change the weight of the active vertices. 
e Paste to selected vertices. 


Tip 

The filter setting is respected 

If you have for example all deform weight groups unlocked 
and all other vertex groups locked, then you can safely 


select Deform from the Filter row and use all available 
tools from the Weight Table again. 


Geometry Data 


This panel is used to manage any generic data attributes 
that a mesh could have. 


Warning 


Clearing any data will result in the data loss of these 
values. 


Clear Sculpt-Mask Data 
Completely removes the mask data from the mesh. While 
not a huge benefit, this can speed-up sculpting if the 
mask is no longer being used. 


Add/Clear Skin Data 
Used to manage the skin data which is used by the Skin 
Modifier. This operator can be needed in case a Skin 
modifier is created but no skin data exist. 


Add/Clear Custom Split Normals Data 
Adds Custom Split Normals data, if none exists yet. 


Add/Clear Edge Bevel Weight 
Adds a zero Edge Bevel Weight value to all edges of the 
mesh. If edge bevel data does exist, this operator will 
delete all that data. 


Add/Clear Vertex Bevel Weight 
Adds a zero Vertex Bevel Weight value to all vertices of 
the mesh. If vertex bevel data does exist, this operator 
will delete all that data. 


Add/Clear Edge Crease 
Adds a zero Edge Crease value to all edges of the mesh. 
If edge crease data does exist, this operator will delete 
all that data. 


Add/Clear Vertex Crease 
Adds a zero Vertex Crease value to all vertices of the 
mesh. If vertex crease data does exist, this operator will 
delete all that data. 


UVs 


e UVs & Texture Space 
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UV Maps 
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Transform 
Randomize 

Mirror 

Snap 

Merge 

Split 

Unwrap 

Pin & Unpin 
Mark/Clear Seams 
Seams from Islands 
Pack Islands 
Average Island Scale 
Minimize Stretch 
Stitch 

Align 

Align Rotation 
Show/Hide Faces 
Export UV Layout 
Proportional Editing 
UV Options 

3D Viewport 


e Workflows 
o Layout Workflow 
o UDIMs 
e Using UV Maps 
o Using the Test Grid 


UVs & Texture Space 
UV Maps 
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The UV Maps panel in the Mesh tab. 


In the Mesh tab the UV maps panel contains a List view that 
lists the UV maps created for this mesh. The selected map is 
displayed in the UV Editor. 


Active Render 
Click the camera icon to enable that UV texture for 
rendering. If no other map is explicitly specified. 


Add + 
Clicking the Add button duplicates the selected UV map. 


See also 


Note that each texture can be mapped to a specific UV 
layout. 


Texture Space 


Reference 


Mode: All Modes 
Panel: Properties » Object Data » Texture Space 


These are settings of the Texture Space used by generated 
texture mapping. The visualization of the texture space can 
be activated in the Viewport Display. 


Auto Texture Space 


Adjusts the active object’s texture space automatically 
when transforming the object. 


Location, Size 
If the texture space is not calculated automatically 
then you can define the location and size of the 
texture space relative to the base object. These can 
also be adjusted from the 3D Viewport, see Editing for 
more information. 


Texture Mesh 
Use another mesh for texture indices, the vertex of the 
two objects must be perfectly aligned. Otherwise the UV 
map will be distorted. Note that, this is only for mesh 
objects. 


Match Texture Space 
Modifies the Location and Size to match the objects 
bounding box. This disables Auto Texture Space. Note 
that, this is only for curve objects. 


Editing 


Reference 


Mode: Object Mode and Edit Mode 


Menu: Object > Transform >» Scale/Move Texture 


Space 


To modify the texture space from the 3D Viewport, enable 
Edit Texture Space while transforming an object. 


Accessing 


The automatically calculated UV map can be accessed by an 
object’s material through the Generated output of the 
Texture Coordinate Node. This output can then be used to 
map any texture onto an object. 


Tip 


Generated texture spaces do not have rotation support, to 


overcome this, a Mapping Node can be used to rotate the 
UV map. 


Unwrapping 


e Introduction 

o About UVs 

o Getting Started 
e Seams 

o Mark Seam 


Introduction 


The first step is to unwrap your mesh. Generally, it is 
recommended to start unwrapping when only minor 
adjustments to the geometry of your model are required. If 
you do add faces or subdivide existing faces when a model 
is already unwrapped, Blender will add those new faces for 
you, but you may need to do additional mapping or editing. 
In this fashion, you can use the UV texture image to guide 
additional geometry changes. 


About UVs 


Every point in the UV map corresponds to a vertex in the 
mesh. The lines joining the UVs correspond to edges in the 
mesh. Each face in the UV map corresponds to a mesh face. 
Think of a UV map as projecting the surface of your 3D 
model onto a 2D image. 


Each face of a mesh can have many UV textures. Each UV 
texture can have an individual image assigned to it. When 
you unwrap a face to a UV texture in the UV Editor, each 
face of the mesh is automatically assigned four UV 
coordinates: These coordinates define the way an image or 
a texture is mapped onto the face. To distinguish from XYZ 
coordinates, the U and V axes are used to mark the 
coordinates of each point. Hence the name, UV unwrapping. 
These coordinates can be used for rendering or for real-time 
viewport display as well. 


Every face in Blender can have a link to a different image. 
The UV coordinates define how this image is mapped onto 
the face. This image then can be rendered or displayed in 


real-time. A 3D Viewport has to be in “Face Select” mode to 
be able to assign Images or change UV coordinates of the 
active mesh object. This allows a face to participate in many 
UV textures. A face at the hairline of a character might 
participate in the facial UV texture, and in the scalp/hair UV 
texture. 


These are described more fully in the next sections. 


Getting Started 


Default UV editing workspace. 


By default, meshes are not created with UVs. First you must 
map the faces, then you can edit them. The process of 
unwrapping your model is done within Edit Mode in the 3D 
Viewport. This process creates one or more UV Islands in the 
UV Editor. 


To begin, choose the UV Editing workspace from the 
selection list at the top of your screen in the Preferences 


header. This sets one of the areas to show you the UV 
Editor, and the other area to the 3D Viewport. 


Enter Edit Mode, as all unwrapping is done in Edit Mode. You 
can be in vertex, face, or edge selection mode. 


Workflow 


The general workflow is as follows, but know that different 
models may require different approaches to unwrapping: 


1. Mark Seams if necessary. See more about marking 
seams. 

2. Select mesh faces in the 3D Viewport. 

3. Select a UV mapping method from the UV > Unwrap 
menu or the UV menu in the 3D Viewport. 

4. Adjust the unwrap settings in the Adjust Last Operation 
panel. 

5. Add a test image to see if there will be any distortion. 
See Applying Images to UVs. 

6. Adjust UVs in the UV editor. See Editing UVs. 


Seams 


For many cases, using the Unwrap calculations of Cube, 
Cylinder, Sphere, or the regular “Unwrap” operators will 
produce a good UV layout. But for more complex meshes, 
especially those with lots of indentations, you may want to 
define a seam to limit and guide the Unwrap operator. 


Just like in sewing, a seam is where the ends of the 
image/cloth are sewn together. In unwrapping, the mesh is 
unwrapped at the seams. Think of this method as peeling an 
orange or skinning an animal. You make a series of cuts in 
the skin, then peel it off. You could then flatten it out, 
applying some amount of stretching. These cuts are the 
same as seams. 


Simple seam on a cylinder. 


When using this method, you need to be aware of how much 
stretching there is. The more seams there are, the less 
stretching there is, but this is often an issue for the 
texturing process. It is a good idea to have as few seams as 
possible while having the least amount of stretching. Try to 
hide seams where they will not be seen. In productions 
where 3D paint is used, this becomes less of an issue, as 
projection painting can easily deal with seams, as opposed 
to 2D texturing, where it is difficult to match the edges of 
different UV islands. 


The workflow is the following: 


1. Mark seams. 

2. Unwrap. 

3. Adjust seams and repeat. 
4. Manually adjust UVs. 


Mark Seam 


Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Tool: UV > Mark/Clear Seam 
Menu: Edge » Mark/Clear Seam 
Reference 

Editor: UV Editor 

Mode: View mode 


Menu: UV > Mark/Clear Seam 


Seamed Suzanne. 


To add an edge to a seam, simply select the edge and press 
Ctrl-E to Mark Seam, or to remove it, use Ctr1-E to Clear 
Seam. 


In the example to the right, the back-most edge of the 
cylinder was selected as the seam (to hide the seam), and 
the default unwrap calculation was used. In the UV Editor, 
you can see that all the faces are nicely unwrapped, just as 
if you cut the seam with a scissors and spread out the 
fabric. 


When marking seams, you can use the Select >» Linked 
Faces or Ctri-L in Face Select Mode to check your work. This 
menu option selects all faces connected to the selected one, 
up to a seam. If faces outside your intended seam are 
selected, you know that your seam is not continuous. You do 
not need continuous seams, however, as long as they 
resolve regions that may stretch. 


Just as there are many ways to skin a cat, there are many 
ways to go about deciding where seams should go. In 
general though, you should think as if you were holding the 
object in one hand, and a pair of sharp scissors in the other, 
and you want to cut it apart and spread it on the table with 


as little tearing as possible. Note that we seamed the 
outside edges of her ears, to separate the front from the 
back. Her eyes are disconnected sub-meshes, so they are 
automatically unwrapped by themselves. A seam runs along 
the back of her head vertically, so that each side of her 
head is flattened out. 


Another use for seams is to limit the faces unwrapped. For 
example, when texturing a head, you do not really need to 
texture the scalp on the top and back of the head since it 
will be covered in hair. So define a seam at the hairline. 
Then, when you select a frontal face, and then select linked 
faces before unwrapping, the select will only go up to the 
hairline seam, and the scalp will not be unwrapped. 


When unwrapping anything that is bilateral, like a head ora 
body, seam it along the mirror axis. For example, cleave a 
head or a whole body right down the middle in front view. 
When you unwrap, you will be able to overlay both halves 
onto the same Texture Space, so that the image pixels for 
the right hand will be shared with the left; the right side of 
the face will match the left, etc. 


Note 


You do not have to come up with “one unwrapping that 
works perfectly for everything everywhere”. As we will 
discuss later, you can easily have multiple UV 
unwrappings, using different approaches in different areas 
of your mesh. 


Seams from Islands 


Reference 


Mode: View mode 
Menu: UV > Seams from Islands 


Adds seams at the boundaries of existing UV islands. This is 
useful when modifying the UVs of already unwrapped 
meshes. 


Tools 


e Toolbar 


Types 


Toolbar 
Select 
Select or moved. 


Select Box 
Select UVs by dragging a box. 


Select Circle 
Select UVs by painting on it. 


Select Lasso 
Select UVs by drawing a lasso. 


Cursor 
Change the location of the 2D Cursor. 


Move 
Translation tool. 


Rotate 
Rotation tool. 


Scale 
Scale tool. 


Transform 
Tool to adjust the UVs translation, rotations and scale. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Rip 
The Rip tool separates UV faces from each other. 


Grab 
The Grab tool moves UVs around. 


Relax 
The Relax tool makes UVs more evenly distributed. 
Pinch 


The Pinch tool moves UVs toward the brush’s center. 


Rip 


Reference 

Mode: Edit Mode 
Tool: Toolbar » Rip 
Shortcut: V 


The Rip tool separates UV components (vertices, edges, 
faces) from connected components. The components are 
ripped in the direction of the mouse pointer position. 


Before. After. 


See also 


Mesh editing Rip operation. 


Grab 


Reference 
Mode: Edit Mode 
Tool: Toolbar > Grab 


The Grab brush moves UVs around. 
Tool Settings 


Brushes 


Brushes 
The Data-Block Menu to select a preset brush type ora 
custom brush. 


Brush Settings 


Radius 
This option controls the radius of the brush, measured in 
pixels. F allows you to change the brush size interactively 
by dragging the mouse and then LMs. Typing a number 
then enter while using F allows you to enter the size 
numerically. 


Size Pressure 
Brush size can be affected by enabling the pressure 
sensitivity icon, if you are using a Graphics Tablet. 


Use Unified Radius 
Use the same brush Radius across all brushes. 


Strength 
Controls how much each application of the brush affects 
the UVs. You can change the brush strength interactively 
by pressing Shift-F in the 3D Viewport and then moving 
the brush and then Lms. You can enter the size 
numerically also while in Shift-F sizing. 


Use Unified Strength 
Use the same brush Strength across all brushes. 


Note 


All brushes use the Airbrush Stroke Method; they continue 
to act as long as you keep LMB pressed. 


Falloff 


The Falloff allows you to control the Strength falloff of the 
brush. See Painting Falloff for more information. 


Options 

Reference 

Mode: Edit Mode 

Panel: Sidebar > Tool > Options 


When UV sculpting is activated, the Sidebar shows the 
brush tool selection and options. 


Lock Borders 
Locks the boundary of UV islands from being affected by 
the brush. This is very useful to preserve the shape of UV 
islands. 


Sculpt All Islands 
To edit all islands and not only the island nearest to the 
brush center when the sculpt stroke was started. 


Display Cursor 
Hides the sculpt cursor. 


Relax 


Reference 
Mode: Edit Mode 
Tool: Toolbar > Relax 


The Relax brush can be used to distribute UVs more evenly. 
It works by pulling vertices along UV edges to bring the UV 
unwrap into balance. 


The Relax brush can be compared with the Minimize Stretch 
tool which works directly on faces to reduce texture 
stretching and shearing. You may find that sometimes 
minimize stretch works better, sometimes the unwrap tool 
and other times the relax brush. 


First using Unwrap, then Minimize Stretch and touching up 
with the Relax Brush often gives the best results. 
Remember, you can use “Undo” at any time to return to an 
earlier state. 


Tool Settings 


Brushes 
Brushes 


The Data-Block Menu to select a preset brush type ora 
custom brush. 


Brush Settings 


Radius 
This option controls the radius of the brush, measured in 
pixels. F allows you to change the brush size interactively 
by dragging the mouse and then LMs. Typing a number 
then enter while using F allows you to enter the size 
numerically. 


Size Pressure 
Brush size can be affected by enabling the pressure 
sensitivity icon, if you are using a Graphics Tablet. 


Use Unified Radius 
Use the same brush Radius across all brushes. 


Strength 
Controls how much each application of the brush affects 
the UVs. You can change the brush strength interactively 
by pressing Shift-F in the 3D Viewport and then moving 
the brush and then Lms. You can enter the size 
numerically also while in Shift-F sizing. 


Use Unified Strength 
Use the same brush Strength across all brushes. 


Relaxation Method 
There are three ways to determine the edge weighting: 


Laplacian: The classic discrete laplace operator 
applied to the UV graph. Each edge has 
equal weighting, resulting in triangles 
which resemble a honeycomb shape, or 
quads aligned into square grid. 


HC: 


Similar to Laplacian, the HC method 
uses equal weighting while trying to 
preserve a gradient between dense 
regions of the mesh and regions with 
fewer edges.e 

Note, this method uses the The 
“Humphrey’s Classes” operator as 
described in the paper: “Improved 
Laplacian Smoothing of Noisy Surface 
Mashes 


Geometry: Edges are weighted according to the 
discrete laplace operator (cotangent 
formula) applied to the 3D geometry. 
This tries to bring the relative lengths 
of edges in UV closer to the relative 
lengths of edges in 3D, resulting in a 
UV unwrap with less distortion across 
edge boundaries. 


Note 


All brushes use the Airbrush Stroke Method; they continue 
to act as long as you keep LMB pressed. 
Falloff 


The Falloff allows you to control the Strength falloff of the 
brush. See Painting Falloff for more information. 


Options 


Reference 


Mode: Edit Mode 
Panel: Sidebar > Tool » Options 


When UV sculpting is activated, the Sidebar shows the 
brush tool selection and options. 


Lock Borders 
Locks the boundary of UV islands from being affected by 
the brush. This is useful to preserve the shape of UV 
islands. 


Sculpt All Islands 
To edit all islands and not only the island nearest to the 
brush center when the sculpt stroke was started. 


Display Cursor 
Hides the sculpt cursor. 


Pinch 


Reference 
Mode: Edit Mode 
Tool: Toolbar > Pinch 


The Pinch brush moves UVs toward the brush’s center. The 
pinch brush can be inverted by pressing Ctrl-LMB. 


Tool Settings 


Brushes 


Brushes 
The Data-Block Menu to select a preset brush type ora 
custom brush. 


Brush Settings 


Radius 
This option controls the radius of the brush, measured in 
pixels. F allows you to change the brush size interactively 
by dragging the mouse and then LMs. Typing a number 
then enter while using F allows you to enter the size 
numerically. 


Size Pressure 
Brush size can be affected by enabling the pressure 
sensitivity icon, if you are using a Graphics Tablet. 


Use Unified Radius 


Use the same brush Radius across all brushes. 


Strength 
Controls how much each application of the brush affects 
the UVs. You can change the brush strength interactively 
by pressing Shift-F in the 3D Viewport and then moving 
the brush and then LMs. You can enter the size 
numerically also while in Shift-F sizing. 


Use Unified Strength 
Use the same brush Strength across all brushes. 


Note 


All brushes use the Airbrush Stroke Method; they continue 
to act as long as you keep LMB pressed. 


Falloff 


The Falloff allows you to control the Strength falloff of the 
brush. See Painting Falloff for more information. 


Options 

Reference 

Mode: Edit Mode 

Panel: Sidebar > Tool » Options 


When UV sculpting is activated, the Sidebar shows the 
brush tool selection and options. 


Lock Borders 


Locks the boundary of UV islands from being affected by 
the brush. This is very useful to preserve the shape of UV 
islands. 


Sculpt All Islands 
To edit all islands and not only the island nearest to the 
brush center when the sculpt stroke was started. 


Display Cursor 
Hides the sculpt cursor. 


Editing 


After unwrap, you will likely need to arrange the UV maps, 
so that they can be used in texturing or painting. Your goals 
for editing are: 


e Stitch pieces (of UV maps) back together. 

e Minimize wasted space in the image. 

e Enlarge the faces where you want more detail. 

e Re-size/enlarge the faces that are stretched. 

e Shrink the faces that are too grainy and have too much 
detail. 


With a minimum of dead space, the most pixels can be 
dedicated to giving the maximum detail and fineness to the 
UV texture. A UV face can be as small as a pixel (the little 
dots that make up an image) or as large as an entire image. 
You probably want to make major adjustments first, and 
then tweak the layout. 


Transform 
Reference 
Editor: UV Editor 
Mode: Edit Mode 
Tool: Toolbar >» Move, Rotate, Scale, Transform 
Menu: UV > Transform 
e Move G 
e Rotate R 


e Scale s 


e Shear Shift-Ctrl-Alt-S 
Axis Locking 


Transformations can be locked to an axis by pressing xX or Y 
after one of the transform tools. Also, holding the mms will 
constrain movement to the X or Y axis. 


Randomize 

Reference 

Editor: UV Editor 

Mode: Edit Mode 

Menu: UV > Transform >» Randomize 


Randomize the scale, rotation and offset of selected UV 
islands. The Randomize Transform tool in the UV editor 
works similar to Randomize Transform tool in the 3d view. 


Random Seed 
Changes the random seed used by the pseudo-random 


number generator, producing a different transform result 
for each seed value. 


Location 
Amount to randomize location. 


Rotation 
Amount to randomize rotation. 


Scale Even 


Apply the same scale to the U coordinate and V 
coordinate. 


Scale 
Amount to randomize scale in U and V coordinates. 


Mirror 

Reference 

Editor: UV Editor 
Mode: Edit Mode 
Menu: UV > Mirror 
Shortcut: Ctrl-M 


UVs can be mirrored on the Y axis or the X axis: 


e Mirror X 
e Mirror Y 


You can also use the hotkeys xX or Y, or hold the mms and drag 
in the mirror direction. 


Copy Mirrored UV Coordinates 


Reference 

Editor: UV Editor 

Mode: Edit Mode 

Menu: UV > Copy Mirrored UV Coordinates 


Copies UVs from one side of the mirrored mesh to the other. 
Affects only selected vertices (on both sides). 


Axis Direction 
Positive/Negative 


Precision 
Tolerance for finding vertex duplicates. 


Snap 


Reference 

Editor: UV Editor 
Mode: Edit Mode 
Menu: UV > Snap 
Shortcut: Shift-S 


Snapping in the UV Editor is similar to Snapping _in 3D. For 
the snap to pixel options to work an image has to be loaded. 


Selected to Pixels 
Moves selection to nearest pixel. See also Round to Pixels 
below. 


Selected to Cursor 
Moves selection to 2D cursor location. 


Selected to Cursor (Offset) 
Moves selection center to 2D cursor location, while 
preserving the offset of the vertices from the center. 


Selected to Adjacent Unselected 
Moves selection to adjacent unselected element. 


Cursor to Pixels 
Snaps the cursor to the nearest pixels. 


Cursor to Selected 
Moves the Cursor to the center of the selection. 


Cursor to Origin 
Places the cursor to the location (0, O, 0). 


Merge 


Reference 
Editor: UV Editor 
Mode: Edit Mode 
Menu: UV > Merge 
Shortcut: M 
At Center 


Moves selected UVs to their average position. 


At Cursor 
Moves selection UVs to 2D cursor location. 


By Distance 
Merges selected UVs within the specified Merge Distance. 


Split 


Reference 

Editor: UV Editor 
Mode: Edit Mode 
Menu: UV > Split 
Shortcut: AlLt-M 
Selection Y 


Splits (disconnects) the selection from the rest of the UV. 
The border edge to any non-selected elements are 


duplicated. 


Note that the “copy” is left exactly at the same position 
as the original, so you must move it to see it clearly. 


Unwrap 

Reference 

Editor: UV Editor 
Mode: Edit Mode 
Menu: UV > Unwrap 
Shortcut: U 


Blender offers several ways of mapping UVs. The simpler 
projection methods use formulas that map 3D space onto 
2D space, by interpolating the position of points toward a 
point, axis or plane through a surface. The more advanced 
methods can be used with more complex models, and have 
more specific uses. 


e Unwrap 
e Smart UV Project 

e Lightmap Pack 

e Follow Active Quads 


Cube Projection 
Cylinder Projection 
Sphere Projection 


Pin & Unpin 


Reference 


Editor: UV Editor 


Mode: Edit Mode 
Menu: UV >» Pin/Unpin 
Shortcut: P, Alt-P 


You can pin UVs so they do not move between multiple 
unwrap operations. When Unwrapping a model it is 
sometimes useful to “Lock” certain UVs, so that parts of a 
UV layout stay the same shape, and/or in the same place. 
Pinning is done by selecting a UV, then selecting Pin from 
the UVs menu, or the shortcut P. You can Unpin a UV with 
the shortcut Alt-P. 


Pinning is most effective when using the Unwrap method of 
UV mapping, for organic objects. An example is when you 
are modeling a symmetrical object using the Mirror Modifier. 
Some of the UVs on the mirror axis may be shared across 
the mirrored counterparts. You could pin the UVs that 
correspond to the midline, then align them on the X axis, 
and they will stay in that location. 


Pinning also work great with the Live Unwrap tool. If you pin 
two or more UVs, with Live Unwrap on, dragging pinned UVs 
will interactively unwrap the model. This helps with fitting a 
UV island to a certain shape or region. 


Mark/Clear Seams 


Reference 

Editor: UV Editor 

Mode: Edit Mode 

Menu: UV > Mark/Clear Seam 


See Seams. 


Seams from Islands 


Reference 
Mode: View mode 
Menu: UV > Seams from Islands 


Adds seams at the boundaries of existing UV islands. This is 


useful when modifying the UVs of already unwrapped 
meshes. 


Pack Islands 


Reference 

Editor: UV Editor 

Mode: Edit Mode 

Menu: UV > Pack Islands 


The Pack Islands tool generates an optimized UV layout with 


non-overlapping islands that tries to efficiently fill the 
Texture Space. 


First it will uniformly scale the selected islands, then 
individually translate each island so that they maximize the 


usage of the UV space. 
Pack To 
The UDIM grid to pack UV islands into. 


Closest UDIM: Pack islands to the UDIM closest to 


the center of the selection. 
Active UDIM: 


Pack islands to active UDIM image 
tile or, if no image is available, the 
UDIM grid tile where the 2D cursor 
is located. 


Rotate 
Allow islands to be rotated as well as translated to 
maximize texture usage. 


Margin Method 
The method to use when calculating the empty space 
between islands. 


Scaled: Use scale of existing UVs to 
multiply margin. (The default from 
Blender 3.3 and later.) 

Add: Simple method, just add the 
margin. (This is the default margin 
scale from Blender 2.8 and earlier.) 

Fraction: Precisely specify the fraction of the 
UV unit square for margin. (Slower 
than other two methods.) 


Margin 
The scale for the empty space between islands. 


Average Island Scale 


Reference 
Editor: UV Editor 
Mode: Edit Mode 


Menu: UV > Average Island Scale 


Using the Average Island Scale tool, will scale each UV 
island so that they are all approximately the same scale. 


Non-Uniform 
Reduces average texture stretching within islands by 
scaling the U and V axes independently. 


Shear 
Reduces average texture shearing within islands by 
Shearing the U axis. 


Minimize Stretch 


Reference 

Editor: UV Editor 

Mode: Edit Mode 

Menu: UV > Minimize Stretch 


The Minimize Stretch tool, reduces UV stretch by minimizing 
angles. This essentially relaxes the UVs. 


Stitch 

Reference 

Editor: UV Editor 
Mode: Edit Mode 
Menu: UV > Stitch 
Shortcut: Alt-V 


The Stitch tool, will join selected UVs that share vertices. 
You set the tool to limit stitching by distance in the Adjust 


Last Operation panel, by activating Use Limit and adjusting 
the Limit Distance. 


Align 


Reference 

Editor: UV Editor 
Mode: Edit Mode 
Menu: UV > Align 
Shortcut: Shift-W 


The Align tool will move the selected UVs to a line, where 
that line is specified in different ways by Axis. 


The Straighten option will calculate a line segment between 
two endpoints and move all selected UVs onto that line. 


The Align X and Align Y options will axis-align all selected 
UVs to the midpoint of the current selection. 


Axis 
Straighten: Move UV to closest point on line 
segment. 
Straighten X: Move U co-ordinates onto the line. 
Straighten Y: Move V co-ordinates onto the line. 


Align X: Move U co-ordinates to the midpoint of 
the selection. 

Align Y: Move V co-ordinates to the midpoint of 
the selection. 

Align Auto: Choose between Align X or Align Y 


automatically. 


Align Rotation 


Reference 


Editor: UV Editor 
Mode: Edit Mode 
Menu: UV > Align Rotation 


The Align Rotation tool aligns entire islands to either the U 
or V axis. 


The tool has three different methods of operation. The 
different methods specify the source for the alignment, and 
also whether to align with both the U and V axes, or just the 
V axis alone. 


When using the Auto method, islands are aligned so that UV 
edges are aligned to either the U axis or the V axis. This 
method works best with quads and meshes representing 
organic subjects. 


When using the Edge method, only the selected edges are 
considered, and the islands will be aligned such that the 
selected edges are aligned with the V axis. This method 
works with the selection, so it works best when a particular 
edge, or edge loop, needs to be aligned in UV coordinates. 


When using the Geometry method, the geometry is taken 
into consideration. Either the X axis, the Y axis, or the Z axis 
can be used. Suppose the X axis is chosen. Using this 
method, edges which have a positive extent in the X axis 
will be rotated in the UV map so that the edge extends 
upwards in the V axis. This method works best to align 
multiple islands which share some common geometric 
property, either in the X, Y or Z axis. 


Note that in the Auto method, edges can end up aligned 
either up or down or left or right depending on the 


orientation of the island prior to activating the tool. In the 
Edge method, the alignment of selected edges can be either 
up or down in the V axis, whatever is closest to the current 
orientation of the UV island. By comparison, in the 
Geometry method, the alignment will always be pointing up 
in the V axis, ignoring any previous orientation. 


Show/Hide Faces 


Reference 

Editor: UV Editor 

Mode: Edit Mode 

Menu: UV > Show/Hide Faces 


e Reveal Hidden Alt-H 
e Hide Selected H 
e Hide Unselected Shift-H 


Export UV Layout 


Reference 

Editor: UV Editor 

Mode: Edit Mode 

Menu: UV > Export UV Layout 


If you are using an external application, you need to know 
where on the mesh you are painting. 


Note 


This is an add-on activated by default. 


Proportional Editing 


Reference 

Editor: UV Editor 

Mode: Edit Mode 

Header: Proportional Editing 
Menu: UV >» Proportional Editing 
Shortcut: 0 


Proportional Editing is available in UV editing. The controls 
are the same as in the 3D Viewport. See Proportional Editing 
in 3D for a full reference. 


UV Options 


Reference 

Editor: UV Editor 
Mode: Edit Mode 
Menu: UVs 


Live Unwrap 


Continuously unwraps the selected UV islands while 
transforming pinned vertices. Note, this is different than 
the Live Unwrap option in the 3D Viewport. 


Round to Pixels 


During UV transforms, you can use Round to Pixels to 
help with matching features in the image or ensure your 
UVs have precise horizontal, vertical or diagonal 
alignment. 


Note that Round to Pixels is applied after any snapping 


modes. 

Disabled: UVs will not be rounded. 

Corner: Will force the UVs to round to the 
corner of the nearest pixel of an image 
if loaded. 

Center: Will force the UVs to round to the 
center of the nearest pixel of an image 
if loaded. 


Constraining to Image Bounds 
For standard textures, this option prevents UVs from 
being moved outside the 0 to 1 UV range. For UDIMs 
textures, this option prevents UVs from being moved 
outside the nearest UDIM tile. 


3D Viewport 


Rotate UVs 

Reference 

Editor: 3D Viewport 

Mode: Edit Mode 

Menu: Face > Face Data » Rotate UVs 


The orientation of the UV texture is defined by each face. If 
the image is, for example, upside down or laying on its side, 
use the Face » Rotate UVs (in the 3D Viewport in Face Select 
mode) menu to rotate the UVs per face in 90-degree turns. 


Reverse UVs 


Reference 


Editor: 3D Viewport 
Mode: Edit Mode 
Menu: Face > Face Data » Reverse UVs 


The Face > Reverse UVs tool mirrors the UVs per face, which 
flips the image over, showing you the image reversed. 


Workflows 


e Layout Workflow 
o Transferring UV Maps 
o Multiple UV Maps 
o Optimizing the UV Layout 
o Refining the Layout 
e UDIMs 
o Workflow 
o File Substitution Tokens 
o UDIM Tiles 


Layout Workflow 
Transferring UV Maps 


You can copy a UV map from one mesh to another mesh 
provided both meshes have the same geometry/vertex 
order. This is useful for example when you want to recreate 
a UV map from an earlier version of your model with intact 
UVs. This works by: 


1. Select the target mesh (to which you want to copy the 
UV map). 

2. Shift select the source mesh (that contains the intact UV 
map). 

3. Object menu » Make Links... » Transfer UV Layouts 
(Shortcut: Ctrl-L ...). 


The target mesh will now have a UV map that matches the 
Original mesh. 


Multiple UV Maps 


You are not limited to one UV map per mesh. You can have 
multiple UV maps for parts of the mesh by creating new UV 
maps. This can be done by clicking the Add button next to 
UV_maps list and unwrapping a different part of the mesh. 
UV maps always include the whole mesh. 


Optimizing the UV Layout 


When you have unwrapped, possibly using seams, your UV 
layout may be quite disorganized and chaotic. You may 
need to proceed with the following tasks: Orientation of the 
UV mapping, arranging the UV maps, stitching several maps 
together. 


The next step is to work with the UV layouts that you have 
created through the unwrap process. If you do add faces or 
subdivide existing faces when a model is already 
unwrapped, Blender will add those new faces for you. In this 
fashion, you can use the UV texture image to guide 
additional geometry changes. 


When arranging, keep in mind that the entire view is your 
workspace, but only the UV coordinates within the grid are 
mapped to the image. So, you can put pieces off to the side 
while you arrange them. Also, each UV unwrap is its own 
linked set of coordinates. 


You can lay them on top of one another, and they will onion 
Skin (the bottom one will show through the top one). To 
move only one though, RMB select one of the UV coordinates, 
and use Select > Linked UVs, ctri-L to select connected UVs, 
not box select because UVs from both will be selected. 


Combining UV Maps 


2s 


Bad unwrap, note ear and neck. 


Very often you will unwrap an object, such as the face 
example we have been using, and get it “mostly right” but 
with parts of the mesh that did not unwrap properly, or are 
horribly confusing. The picture to the right shows an initial 
unwrap of the face using the Unwrap from sphere option. 
The issues are with the ear; it is just a mush of UVs, and the 
neck, it is stretched and folded under. Too much work to 
clean up. 


Unwrap face only, without ear or neck. 


We can tell that the ear would unwrap nicely with just a 
straightforward projection from the side view, and the neck 
with a tubular unwrap. So, our general approach will be to 
unwrap different parts of the object (face, ears, and so on) 
using different unwrap tool, selecting each tool according to 
which one works best for that part. So let us begin: We 
select only the “face” faces, unwrap them using the Sphere 
projection, and scale and rotate them a bit to fit logically 
within the image area of the UV Editor. 


Unwrap ear only, using Project from View. 


Once we are satisfied with the face, it is time to turn our 
attention to the ear. First, unselect the faces you were 
working with. Their UVs will disappear from the UV Editor, 
but they are still there, just not shown. (To verify this, you 
can select a few faces in 3D Viewport and it will show up in 
the UV Editor.) 


To work on the ear, in the 3D Viewport, we now select only 
the “ear” faces. You can use vertex groups to select the ear 
faces. Selecting sub-meshes is easy too, since they are not 
connected to the rest of the mesh. Simply selecting linked 
vertices will select that entire submesh. Basically, since you 


are in Edit Mode, all the selecting/deselecting features are 
available to you. 


Now unwrap the ear again using the Project tool from side 
view, and scale and rotate them a bit (discussed in the next 
section), and place them off to the side. You can do this 
repetitively, using different unwrapping algorithms; each re- 
apply just puts those UVs for the selected faces somewhere 
else. Choose the tool for each part that gives you the best 
fit and most logical layout for subsequent painting of that 
part. 


When all parts of the mesh have been unwrapped using the 
various methods, you should end up with something that 
looks like the example to the right. All sections of the mesh 
have been mapped, and all those maps are laid out in the 
same UV texture map. Congratulations! From here, it is a 
simple matter of “stitching” (discussed in the next section) 
to construct the entire UV map as a single map. 


UV maps arranged together and stitched. 


When you have completed arranging and stitching, you will 
end up with a consolidated UV map, like that shown to the 


right, arranged such that a single image will cover, or paint, 
all of the mesh that needs detailed painting. All the detailed 
instructions on how to do this are contained in the next 
section. The point of this paragraph is to show you the 
ultimate goal. Note that the mesh shown is Mirrored along 
the Z axis, so the right side of the face is virtual; it is an 
exact copy of the right, so only one set of UVs actually exist. 
(If more realism is desired, the Mirror Modifier would be 
applied, resulting in a physical mirror and a complete head. 
You could then make both side physically different by 
editing one side and not the other. Unwrapping would 
produce a full set of UVs (for each side) and painting could 
thus be different for each side of the face, which is more 
realistic). 


iteration & Refinement 


At least for common people, we just do not “get it right the 
first time.” It takes building on an idea and iterating our 
creative process until we reach that magical milestone 
called “Done”. In software development, this is called the 
‘spiral methodology’. 


Applied to computer graphics, we cycle between modeling, 
texturing, animating, and then back to making modifications 
to mesh, UV mapping, tweaking the animation, adding a 
bone or two, finding out we need a few more faces, so back 
to modeling, etc. We continue going round and round like 
this until we either run out of time, money, or patience, or, 
in rare cases, are actually happy with our results. 


Refining the Layout 


Refinement comes into play when we finally look at our 
character, and realize that we need more detail in a 
particular spot. For example, areas around the eyes might 
need crow’s feet, or we need to add a logo to the vest. As 
you Start to edit the image, you realize that there just are 
not enough pixels available to paint the detail that you 
want. 


Your only choice is to expand the size (scale out) that UV 
face. Using the Minimize Stretch or Scale tools, you expand 
the UV faces around the eyes or chest, allocating more 
pixels to those areas, but at the same time taking away 
pixels (detail) from somewhere else, like the back of the 
head. After refining the UV map, you then edit the image so 
that it looks right and contains the details you want. 


Reusing Textures 


Another consideration is the need to conserve resources. 
Each image file is loaded in memory. If you can reuse the 
Same image on different meshes, it saves memory. So, for 
example, you might want to have a generic face painting, 
and use that on different characters, but alter the UV map 
and shape and props (sunglasses) to differentiate. 


You might want to have a “faded blue jeans” texture, and 
unwrap just the legs of characters to use that image. It 
would be good to have a generic skin image, and use that 
for character’s hands, feet, arms, legs, and neck. When 
modeling a fantasy sword, a small image for a piece of the 
sword blade would suffice, and you would Reset Unwrap the 
sword faces to reuse that image down the length of the 
blade. 


UDIMs 


Using UV maps can have one disadvantage, they consist of 
one texture for the entire mesh. Most of the time this is 
sufficient but the disadvantage is that the texture is one 
resolution for the entire mesh. This causes issues if you 
have a very large mesh with geometry of different 
importance. When using a singular texture, the resolution 
might be too low to cover larger UV islands while being 
inefficient for smaller, less important islands. 


UDIM offers a solution to this by being able to spread UV 
islands across several different textures. UDIM which stands 
for U DiMension is based on a tile system where each tile is 
a different texture in the overall UDIM texture array. 
Basically each tile consists of its own UV space (0-1, 1-2, 2- 
3) and have its own image assigned to that tile. Tiles are 
managed in the UDIM Tiles panel where they can have a 
generated image assigned to them. Generally, you create 
several textures of different resolutions; for example, you 
may have a 4k resolution texture for the major details, and 
2k and/or 1k textures for less important details. 


The UDIM array consists of one main tile, this tile is given 
the index number of 1001. The next tile that gets added will 
be 1002 and will be placed to the right of the main tile. The 
overall UDIM array is ten tiles wide, so tiles 1001 through 1010 
are created on the first row. After ten tiles a new row of tiles 
is started above the main tile; so 1011 will be place directly 
above 1001. 


Workflow 


To start using a UDIM workflow, you should unwrap a mesh 
as you would for any other UV map. After that you should 
decide how many textures you want to split your UV map 
into. This will be different for every mesh and workflow but a 
good minimum is 3: one 4k, one 2k, and one 1k image. Then 
create the desired textures to match how many textures you 
want. 


After this it is the same process of moving UVs to the 
appropriate tile and scaling and managing them like any 
other UV map. See Layout Workflow for information on 
laying out UVs. 


When the UVs are correctly set up across the multiple UV 
islands it is time to add proper textures the UDIM array. 
Currently, existing textures cannot be added to a tile, to fill 
a tile with an existing texture you first must: 


1. Create the desired tiles. 

2. Save the image. 

3. Replace the saved image file with the desire texture by 
deleting the file and replacing it with a new image file, 
keeping the old file name. Or by opening the image in 
another application and modifying the contents of the 
image. 


Other than using a third-party application to edit the UDIM 
texture it is possible to paint on UDIM textures. This works 
for either 2D Painting or 3D Painting. 


File Substitution Tokens 


Substitution tokens are special sequences of characters ina 
filename that can be replaced with more meaningful and 


context aware information. In this case, tokens are identified 
by being text wrapped in angle bracket characters. 


This substitution is used while load loading or saving an 
image to automatically identify the tile associated with a 
particular texture in the UDIM array. 


The following tokens are supported: 


e <UDIM>: A 4-digit notation calculated as 1001 + u-tile + v- 
tile * 10. 

e <UVTILE>: A notation defined as u(u-tile + 1) v(v-tile + 
1). 


Examples: 


e monster-basecolor.<UDIM>.png will load/save files like 
monster-basecolor.1021.png etc. 

e monster-basecolor.<UVTILE>.png will load/save files like 
monster-basecolor.ul v3.png etc. 


UDIM Tiles 


Reference 

Editor: Image Editor, UV Editor 
Mode: All Modes 

Panel: Sidebar > Image » UDIM Tiles 


In this panel UDIM tiles are managed; new tiles can be 
added, tiles can be removed, or tiles can filled with a 
generated texture. 


UDIM Tile List 


List all UDIM tiles associated with the main index (1000 
tile). Double clicking on the tile name allows you to alter 
the tiles Label. 


Add Tile + 
Adds new UDIM tiles to the group. 


Number 
The starting tile index number. UDIMs must start with 
the 1001 tile and typically increase in incremental 
order. 


Count 
The number of tiles to add. 


Label 
An optional label can be used instead of the index 
number. These labels are shown in the 2D Viewport. 


Fill 
Occupy the UDIM tile with a generated image; see Fill 
Tile below. 


Remove Tile - 
Deletes the selected UDIM tile from the group. If this tile 
is not saved and contains data, that data will be lost. 


Fill Tile 
Occupy the UDIM tile with a Generated Image. 


Warning 
If a tile is not filled, it will not be saved with the image. 


Using UV Maps 


Sooner or later, you may want to use an image texture on 
your model. The UV Editor allows you to map textures 
directly to the mesh faces. The 3D Viewport shows you the 
object being textured. If you set the 3D Viewport into 
Textured viewport shading, you will immediately see any 
changes made in the UV Editor, and vice versa. This is 
because no real rendering is taking place; it is all just 
viewport shading. If you were to apply an image to UVs then 
render, the texture would not show up by default. So to 
render an image, you must: 


e Create a Material for the object. 
e Tell Blender to use the UV textures on faces when 
rendering. 


To create a Material, you have to click Add New Material in 
the Shading context. 


There are two ways to tell Blender to use the UV texture 
when rendering; the quick way and the proper way. 


The quick way is to use generated UV coordinates. 
Generated coordinates is used by default by all Texture 
nodes, with the exception of Image textures that use UV 
coordinates by default. To use generated coordinates for 
images as well use the Generated output of the Texture 
Coordinate node. 


The proper way is to use UV Unwrapping to manually 
generate UV coordinates. To use UV mapping, use the 
Texture Coordinate node (UV output) or the UV Map node 
and select the UV map to use, “UVMap” by default. 


Full details of using Image textures are on the Image 
Textures page. 


Note 
Material is Required for Rendering 


You can perform UV texturing on a mesh within Blender 
without assigning a material, and you will even see it in 
your 3D Viewport in textured viewport mode. However, 
when you render, you will just get a default gray if the 
object does not have a Material assigned. You will get a 
black if you do not load an image. If you do not create a 
texture that uses the image, your object will render 
according to the procedural material settings. 


Using the Test Grid 


If your image is a base uniform pattern and you want the 
application of that image to your model to look like cloth, 
you do not want any stretching (unless you want the cloth 
to look like soandex). You may also need to test your UV 
mapping with a test image: 


The test grid applied A preview of the 
to the UVs. texture on the 
geometry. 


When you render, the mesh will have the test grid as its 
colors, and the UV texture will be the size image you 
specified. Note that Blender has a built-in test image. To use 
it, press the New button of the data-block menu in the 
Image editor header and change the Generated Type to UV 
Grid. 


Modifying Your Image Texture 


See also 


e Render Bake 
e Texture Paint 


The advantage to saving as a separate file is that you can 

easily switch textures just by copying other image files over 
it, and you can use external editing programs to work on it. 
The advantage of packing is that your whole project is kept 
in the blend-file, and that you only have to manage one file. 


Mesh Analysis 


Reference 
Mode: Edit Mode 
Panel: Header >» Overlays >» Mesh Analysis 


Mesh analysis is useful for displaying attributes of the mesh, 
that may impact certain use cases. 


The mesh analysis works in Edit Mode and Solid Viewport 
Shading. It shows areas with a high value in red, and areas 
with a low value in blue. Geometry outside the range is 
displayed gray. 


Currently the different modes target 3D printing as their 
primary use. 


Overhang 


Extrusion 3D printers have a physical limit to the overhang 
that can be printed, this display mode shows the overhang 
with angle range and axis selection. 


Minimum/Maximum 
Minimum/Maximum angle to display. 


Axis 
Axis and direction to use as the bases to calculate the 
angle to visualize. 


Overhang. 


Thickness 


Printers have a limited wall-thickness where very thin areas 
cannot be printed, this test uses ray casting and a distance 
range to the thickness of the geometry. 


Minimum/Maximum 
Minimum/Maximum thickness to display. 


Samples 
Number of samples to use to calculate the thickness. 


Thickness. 


Intersections 


Another common cause of problems for printing are 
intersections between surfaces, where the inside/outside of 
a model cannot be reliably detected. 


Unlike other display modes, intersections have no variance 
and are either on or off. 


Intersecting faces. 


Distortion 


Distorted geometry can cause problems since the 
triangulation of a distorted n-gon is undefined. 


Distortion is measured by faces which are not flat, with 
parts of the face pointing in different directions. 


Minimum/Maximum 
Minimum/Maximum distortion to display. 


Distorted Faces. 


Sharp Edges 


Similar to wall-thickness, sharp edges can form shapes that 
are too thin to be able to print. 


Minimum/Maximum 
Minimum/Maximum angle to display. 


Sharp edges. 


Known Limitations 


There are some known limitations with mesh analysis: 


e Currently only displayed with Deform Modifiers. 
e For high-poly meshes the performance is low while 
editing. 


Retopology 


Retopology is the process of simplifying the topology of a 
mesh to make it cleaner and easier to work with. Retopology 
is need for mangled topology resulting from sculpting or 
generated topology, for example from a 3D scan. Meshes 
often need to be retopologized if the mesh is going to be 
deformed in some way. Deformations can include rigging or 
physics simulations such as cloth or soft body. Retopology 
can be done by hand by manipulating geometry in Edit 
Mode or through automated methods. 


Using the Poly Build Tool 


Todo 2.81. 

Remeshing 

Reference 

Mode: Object Mode, Sculpt Mode 

Panel: Properties » Object Data » Remesh 


Remeshing is a technique that automatically rebuilds the 
geometry with a more uniform topology. Remeshing can 
either add or remove the amount of topology depending on 
a defined resolution. This technique is especially useful for 
sculpting, to generate better topology after blocking out the 
initial shape. 


Note 


Limitations: 


e Remeshing only works on the original mesh data and 
ignores generated geometry from modifiers, shape 
keys, rigging, etc. 

e Remeshing will not work with the Multiresolution 
Modifier. 


See also 


Remesh modifier 


Voxel 


The Voxel Remesher uses OpenVDB to generate a new 
manifold mesh from the current geometry. It produces a 
mesh with perfectly even distributed topology and it does 
not have any performance penalty once the new mesh is 
calculated. This makes the voxel remesher great for 
sculpting as it is possible to sculpt at a much higher level of 
detail than using other features like dyntopo which often 
adds more performance overhead. 


Voxel Size 
The resolution or the amount of detail the remeshed 
mesh will have. The value is used to define the size, in 
object space, of the Voxel. These voxels are assembled 
around the mesh and are used to determine the new 
geometry. For example a value of 0.5 m will create 
topological patches that are about 0.5 m (assuming 
Preserve Volume is enabled). Lower values preserve finer 
details but will result in a mesh with a much more dense 
topology. 


Adaptivity 
Reduces the final face count by simplifying geometry 
where detail is not needed. This introduce triangulation 
to faces that do not need as much detail. Note, an 
Adaptivity value greater than zero disables Fix Poles. 


Fix Poles 
Tries to produce less Poles at the cost of some 
performance to produce a better topological flow. 


Preserve 
Volume 
Tells the algorithm to try to preserve the original 
volume of the mesh. Enabling this could make the 
operator slower depending on the complexity of the 
mesh. 


Paint Mask 
Reprojects the paint mask onto the new mesh. 


Face Sets 
Reprojects Face Sets onto the new mesh. 


Color Attributes 
Reprojects the Color Attributes onto the new mesh. 


Voxel Remesh 
Performs the remeshing operation to create a new 
manifold mesh based on the volume of the current mesh. 
Performing this will lose all mesh object data layers 
associated with the original mesh. 


Quad 


The Quad remesh uses the Quadriflow algorithm to create a 
Quad based mesh with few poles and edge loops following 


the curvature of the surface. This method is relatively slow 
but generates a higher quality output for final topology. 


Warning 


Performing Quadriflow Remesh will lose all mesh object 
data layers associated with the original mesh. 


Quadriflow Remesh 


Opens a pop-up used to set parameters for the remesh 
operation. 


Use Paint Symmetry 
Generates a symmetrical mesh using the Mesh 
Symmetry options. 


Preserve Sharp 
Tells the algorithm to try to preserve sharp features of 
the mesh. Enabling this could make the operator slower 
depending on the complexity of the mesh. 


Preserve Mesh Boundary 
Tells the algorithm to try to preserve the original volume 
of the mesh. Enabling this could make the operator 
slower depending on the complexity of the mesh. 


Preserve Paint Mask 
Reprojects the Paint Mask onto the new mesh. 


Smooth Normals 


Applies the Smooth Normals operator to the resulting 
mesh. 


Mode 
How to specify the amount of detail for the new mesh. 


Ratio: Specify target number of faces relative 
to the current mesh. 

Edge Length: Input target edge length in the new 
mesh. 

Faces: Input target number of faces in the new 
mesh. 


Seed 
Random Seed to use with the solver; different seeds will 
cause the remesher to generate different quad layouts 
on the mesh. 


Curves 


Introduction 
Tools 
o Toolbar 
o lypes 
Structure 
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o Spline Types 
Primitives 
o Bézier Curve 
o Bézier Circle 
NURBS Curve 
NURBS Circle 
Path 
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Select Linked 
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Introduction 


Curves and Surfaces are particular types of Blender objects. 
They are expressed by mathematical functions 
(interpolation) rather than linear interpolation between a 
series of points. 


Blender offers both Bézier and NURBS. Both Bézier curves 
and NURBS curves and surfaces are defined in terms of a 
set of “control points” (or “control vertices”) which define a 
“control polygon”. 


blender, 


Blender logo made from Bézier curves. 


Both Bézier and NURBS curves are named after their 
mathematical definitions, and choosing between them is 
often more a matter of how they are computed behind the 
scenes than how they appear from a modeler’s perspective. 
Bézier curves are generally more intuitive because they 
start and end at the control points that you set, but NURBS 


curves are more efficient for the computer to calculate when 
there are many twists and turns in a curve. 


The main advantage to using curves instead of polygonal 
meshes is that curves are defined by less data and so can 
produce results using less memory and storage space at 
modeling time. However, this procedural approach to 
Surfaces can increase demands at render time. 


Certain modeling techniques, such as extruding_a profile 
along_a_path, are possible only using curves. On the other 
hand, when using curves, vertex-level control is more 
difficult and if fine control is necessary, mesh editing may 
be a better modeling option. 


Bézier curves are the most commonly used curves for 
designing letters or logos. 


They are also widely used in animation, both as for objects 
to move along (see constraints below) and as F-Curves to 
change the properties of objects as a function of time. 


See also 
Modifiers & Constraints 


e Curve Modifier 
e Follow Path Constraint 
e Clamp To Constraint 


Tools 
e Toolbar 
Types 


e Draw 
e Curve Pen 


Toolbar 


Curve Edit Mode tools: 


select 
Select or move. 


Select Box 
Select objects by dragging a box. 


All objects that intersect the box will be selected. 


Select Circle 


Select objects by dragging a circle. All objects that 
intersect the path of the circle will be selected. 


Select Lasso 
Select objects by drawing a lasso. 


Cursor 
Change the location of the 3D Cursor. 


Move 
Translation tool. 


Rotate 
Rotation tool. 


Scale 
Scale tool. 


Scale Cage 
Change the scale of an object by controlling its cage. 


Transform 
Tool to adjust the objects translation, rotations and scale. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Measure 
Measure distances in the scene. 


Draw 
Free-hand drawing of new curves. 


Curve Pen 
Construct and edit splines. 


Extrude 
Extrude the curve by adding new control points. 


Radius 
Control the radius value of the control points. 
Tilt 


Control the rotation value of the control points around 
the curve’s axis. 


Randomize 


Move selected control points in pseudo-random 
directions. 


Draw 


Reference 
Mode: Edit Mode 
Tool: Toolbar >» Draw 


The Curve draw tool allows you to free-hand draw curves. 


Tool Settings 


Type ¥ Active Tool 
Type of curve to use for Js Ore 
drawing. - 

Type 
Poly Method 
Bézier Curve with straight Tolerance 
line segments (auto Detect Comers 
handles). Taper Start 
lau End 

Bezier 
Radius Min 

Tolerance 


Max 


Lower values give a 
result that is closer to 
the drawing stroke, 
while higher values 
give more smoothed 
results. 


Use Pressure 


Depth Cursor Surface 


Offset 0.00 
Absolute Offset 


Only First 


Method Curve Stroke panel. 
Refit 


Incrementally refits the curve (gives best 
results). 


Split 
Splits the curve until the tolerance is met (gives 
a better drawing performance). 


Detect Corners 
Detects corners while drawing based on a specified 
angle; Any angles above the specified value are 
considered corners. If a corner is detected, the 
curve uses non-aligned handles for the corner 
resulting in a more crisp corner. 


Radius 
Min 
Minimum radius when the minimum pressure is 
applied (also the minimum when tapering). 


Max 
Radius to use when the maximum pressure is applied 
(or when a tablet is not used). 


Use Pressure 
Uses stylus pressure to control the radius of the curve. 


Depth 
Controls where and how the curves are drawn. 


Cursor 
Uses the depth under the cursor to draw curves. 


Surface 
Used to draw on top of other objects. 


Offset 


Distance to offset the curve from the surface. 


Absolute Offset 


Applies a fixed offset (does not scale by the curve 
radius). 


Only First 
Only uses the start of the stroke for the depth. 


Plane 


The orientation plane to draw on, available when 
Only First is enabled. 


Normal/View 
Draws perpendicular to the surface. 


Normal/Surface 
Draws aligned to the surface. 


View 
Draws aligned to the viewport. 


Options 


After the tool is run, these options are available in the Adjust 
Last Operation panel. 


Error 
Error distance in object units. This can be seen similar to 
a subdivision rate for the curve. Lower values give a 
result that is closer to the drawing stroke while higher 
values give more smoothed results. 


Fit Method 
Refit 
Incrementally refits the curve (gives best results). 


Split 
Splits the curve until the tolerance is met (gives a 
better drawing performance). 


Corner Angle 
Any angles above this are considered corners. 


Cyclic 
Toggles whether or not the curve is Cyclic. 


Curve Pen 


Reference 


Mode: Edit Mode 
Tool: Toolbar >» Curve Pen 


The Curve Pen tool allows you to construct and edit curves 
rapidly. 


Usage 


v 3D View Tool: Edit Curve, Curve Pen 


v Curve Pen Mouse Left Mouse 


curve.pen 


Ctrl 


VY Move Segment 
Select Point 


Y Move Point 


Extrude Point Close Splin.... On Click 


v Curve Pen Modal Map 


ad 


i< 


Free-Align Toggle Keyboard Left Shift 


Ld 


«| 


Move Adjacent Handle Keyboard Left Ctrl 


> Move Entire Point Keyboard Spacebar 


<< 


Lock Angle Keyboard Left Alt 
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Link Handles Keyboard Right Ctrl 
Add New 


Curve Pen Preferences 


The following preferences can be configured from: 
Preferences » Keymap » 3D View » Curve >» 3D View Tool: 
Edit Curve, Curve Pen. 


Extrude Point 
LMB click to add a new point connected to an existing 
point. 


Extrude Handle Type 
The handle type of the extruded points. Can be either 
Vector or Auto. However, the handle type switches to 
Align when handles are moved (See Move Point). 


Delete Point 
Ctrl-LMB click on an existing point to delete it. 


Insert Point 
Ctrl-LMB click on a Curve Segment to insert a new control 
point between the two adjacent control points. ctr1-LMB 
click and drag to control the handles of the inserted 
points. 


Move Segment 
LMB drag on a Segment in between two control points to 
adjust the handles, changing the shape of the curve 
without affecting the location of any control points. 


Select Point 
LMB click to select a single point or handle at a time. 


Move point 
LMB drag to move existing points or handles. With an 
endpoint of a spline selected, click and drag on empty 


space to Extrude Point and move the handle at the same 
time. 


Close Spline 
Make the spline Cyclic by clicking the endpoints 
consecutively. 


Close Spline Method 
The condition for Close Spline to activate. 


None: Turn off the Close Spline functionality. 

On Press: Close the spline on mouse down. With 
this option, you may click and drag to 
adjust the handles of the endpoint. 

On Click: Activate on mouse release. With this 
option, the Close Spline functionality 
will not be triggered on click and drag. 


Toggle Vector 
Double LmB click on a handle to switch handle between 
Vector and Auto handle types. Can be used to easily 
switch between sharp corners and smooth curves. 


Cycle Handle Type 
Double Los click on the control point to cycle through all 
handle types. 


Hotkeys 


Free-Align Toggle 
Hold LeftShift while dragging a handle to switch between 
Free and Align handle types. Can be used to create sharp 
corners along the curve. 


Move Adjacent Handle 


Hold Leftctrt while dragging a handle to move the closer 
handle of the adjacent control point. Can be helpful to 
make adjustments to newly created curve segments. 


Move Entire 
Hold Spacebar while dragging a handle to move the entire 
point. 


Link Handles 
Press Rightctrit while dragging a handle to mirror its 
movement on the opposite handle of the same point. 


Lock Handle Angle 
Hold Leftalt while dragging a handle to limit the 
movement of the handle to its current direction, so only 
its length can be adjusted. 


Structure 


Splines 


Splines are a substructure of curves and are the individual 
elements that make curve objects. A curve object can be 
composed of several different splines, just like mesh objects 
can have different discontinuous meshes under the same 
object. A spline defines the shape of the curve and can be 
transformed by altering its Control Points. Splines come in 
three distinct types, which are described in Spline Types. 
Each spline type has a slightly different algorithm for 
computing how bends in the spline are represented. 


Splines have their own separate properties from curves and 
can be altered by selecting the spline in Edit Mode and 
using the Active Spline panel. 


Control Points 


Similar to meshes splines have control points or vertices. 
Control points connect to other control points to form 
splines. Control points can be selected and transformed to 
alter the resulting shape of the spline. 


See also 


Curve Editing 


Spline Types 


Poly 


Poly splines are the most simple spline type as they do not 
interpolate the shape of the curve between control points. 


Poly Curves are used when converting_meshes to curves. 
Because they do not interpolate the shape, Poly splines are 
able to give an accurate representation of the original mesh 
object. 


This is the primary use case of splines, most of the time 
Bézier or NURBS splines are used instead; both of which 
interpolate the shape and give smooth results. 


Bezier 


The main elements used in editing Bézier curves are the 
control points and handles. A segment (the actual curve) is 
found between two control points. The handles define the 
curvature of the segment. 


In the image below, the control points can be found in the 
middle of the pink line, while the handles comprise the 
extensions from the control point. The arrows visualize the 
normals of the curve, which indicate i.e. the direction and 
the tilt. 
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Bézier Curve in Edit Mode. 


Handle Types 


There are four Bézier curve handle types. They can be 
accessed by pressing v and selecting from the list that 
appears. 


Automatic (yellow handles) 
This handle has a 
completely automatic 
length and direction 
which is set by Blender 
to ensure the smoothest 
result. These handles 
convert to Aligned 
handles when moved. 


Vector (green handles) 
Both parts of a handle 
always point to the 
previous handle or the 
next handle which 
allows you to create 
curves or sections 


thereof made of straight Bézier Curve Handle Types. 
lines or with sharp 

corners. Vector handles 

convert to Free handles when moved. 


Aligned (purple handles) 
These handles always lie in a straight line, and give a 
continuous curve without sharp angles. 


Free (black handles) 
The handles are independent of each other. 


NURBS 


N.U.R.B.S. is the abbreviation for Non-Uniform Rational B- 
Splines. One of the major differences between Bézier 
objects and NURBS objects is that Bézier curves are 
approximations. For example, a Bézier circle is an 
approximation of a circle, wnereas a NURBS circle is an 
exact circle. NURBS theory can be a very complicated topic. 
For an introduction, please consult the Wikipedia page. 


NURBS spline control points are different than other spline 
types because they have a special weight property. This 
weight property controls how much influence the control 
point has on the surface. This weight should not be 
confused with the Goal Weight, which is used only for soft 
body simulations. The NURBS control point weight can be 
adjusted in the W number field of the Transform panel. 


Note 


If all the control points have the same Weight then each 
effectively cancels each other out. It is the difference in 
the weights that cause the curve to move towards or away 
from a control point. 


Primitives 


Reference 

Mode: Object Mode and Edit Mode 
Menu: Add > Curve 

Shortcut: Shift-A 

See also 


When adding curves there are some common options like 
other Objects. 


Note 


Eventually all the primitive curves will be replaced to use 
the same curve system used for hair curves. Until this is 
done, their features will diverge. 


They can be converted interchangeably to access the full 
range of edit and sculpting functionalities. 


In Object/Edit Mode, the Add Curve menu, provides a few 
different curve primitives: 


Bezier Curve 


Adds an open 2D Bézier curve with two control points. 


Bezier Circle 


Adds a closed, circle-shaped 2D Bézier curve (made of four 
control points). 


NURBS Curve 


Adds an open 2D NURBS curve, with four control points, with 
Uniform knots. 


NURBS Circle 


Adds a closed, circle-shaped 2D NURBS curve (made of 
eight control points). 


Path 


Adds a NURBS open 3D curve made of five aligned control 
points, with Endpoint knots and the Curve Path setting 
enabled. 


Empty Hair 


Adds an empty high-performance curves object and 
automatically: 


e Assigns the active object as the Surface. 

e Set the surface object as the parent of the new object. 

e Adds a Geometry Nodes modifier to deform the curves 
on the surface. 


The curves can be edited via sculpting. 


Note 


Hair curves currently have the following limitations: 


e No Edit Mode. 
e Not supported in Wireframe viewport shading. 


Properties 


Hair Curves have different properties than regular Curve 
objects; these properties are documented below. 


Attributes 


The Attributes panel contains different hair characteristics 
such as the position and color of hair strands. 


Use the List View to manage attributes. 


See also 


See the Attribute Reference for details on attributes. 


Surface 


Surface 
The curve surface is an optional mesh that is used to 
anchor the curves, and behave as a scalp for hair 
grooming. When adding a new Curves object via the Add 
Menu the active object is automatically set as the 
surface. 


To set a new surface press Ctrl-P and select Object 
(Attach Curves to Surface) in the Set Parent To pop-up 


menu. This option can be seen as part of the Curves 
settings in the Properties Editor. 


¥ Surface 


Surface Beard Scalp 


UVMap UVMap 


Surface UV Map 
The name of the attribute on the surface mesh used to 
define the attachment of each curve. 


Note 


If the UV from the surface changed, run Snap to Nearest 
Surfaces to re-attach the curves. 


Selecting 


This page discusses specific selecting tools for curve objects 
in Edit Mode. The Curve Edit more also uses the general 
select tools used which are described in the interface 
section. 


Curve selection in Edit Mode has fewer options than with 
meshes. Mainly this is, because there is only one selectable 
element type, the control points (no select mode needed 
here...). These points are a bit more complex than simple 
vertices, however, especially for Bézier curves, as there is 
the central vertex, and its two handles... 


The basic tools are the same as with meshes, so you can 
select a simple control point with the LmB, add to current 
selection with Shift-LMB, Box Select B, and so on. 


One word about the Bézier control points: when you select 
the main central vertex, the two handles are automatically 
selected too, so you can move it as a whole, without 
creating an angle in the curve. However, when you select a 
handle, only this vertex is selected, allowing you to modify 
this control vector... 


Note that, unlike mesh edges, you cannot directly select a 


segment. Instead, select all of the control points that make 
up the segment you want to edit. 


Select Menu 


With curves, all “advanced” selection options are grouped in 
the Select menu of the 3D Viewport header. 


All A 
Select all. 


None Alt-A 
Select none. 


Inverse Ctrl-I 
Selects all the geometry that are not selected, and 
deselect currently selected components. 


Box Select B 
Interactive box selection. 


Circle Select c 
Interactive circle selection. 


Lasso Select 
Interactive free-form selection. 


Select Random 
Select random control points. 


Checker Deselect 
Select every Nth control point. 


Select Linked Ctr1-L 
Select control points that are connected to the current 
selection. 


Select Similar Shift-G 
Select control points that have similar properties to the 
current selection. 


(De)select First/Last 


Toggle the selection of the first or last control point(s). 


Select Next/Previous 
Selects the next or previous control points. 


Select More/Less 
Select objects based on their parent child relationships. 


Select Random 


Reference 
Mode: Edit Mode 
Menu: Select > Select Random 


Select Random control points. 


Percent 
Selects the defined percentage of control points. 


Random Seed 
Seed used by the pseudo-random number generator. 


Action 
Controls whether the operator Se/ects or Deselects 
control points. 


Checker Deselect 


Reference 


Mode: Edit Mode 
Menu: Select » Checker Deselect 


This tool applies an alternating selected/deselected checker 
pattern. This only works if you already have more than one 
control point selected. 


It works by changing the current selection so that only every 
Nth control points will remain selected, starting from the 
active one. 


Deselected 
The number of deselected elements in each pattern 
repetition. 


Selected 
The number of selected elements in each pattern 
repetition. 


Offset 
Offset from the starting point. 


Select Linked 


Reference 

Mode: Edit Mode 

Menu: Select >» Select Linked 
Shortcut: LCtrlek,-Shitt-k 


L (or ctri-L for all) will add to the selection the cursor’s 
nearest control point, and all the linked ones, i.e. all points 
belonging to the same curve. Note that for Bézier, using L 
with a handle selected will select the whole control point 
and all the linked ones. 


Select Similar 


Reference 


Mode: Edit Mode 
Menu: Select > Select Similar 
Shortcut: Shift-G 


Selects control points that have certain similar properties to 
the active one. The Adjust Last Operation panel provides 
several selection options: 


Type 
Type 
Selects splines that have the same spline Type i.e. 
Bézier, NURBS or Poly. 
Radius 
Selects control points that have a similar Radius 
value. 
Weight 
Selects all points that have a similar Weight value. 
Direction 
Selects control points that have a similar handles 
direction. 
Compare 


For quantitative properties, this property selects the type 
of comparison to between the two numerical values. 


Equal: Select items with the same value as 
the active item’s chosen property. 

Greater: Select items with a larger value as the 
active item’s chosen property. 

Less: Select items with a smaller value as the 


active item’s chosen property. 


Threshold 


For quantitative properties, this property controls how 
close the property’s values have to be in the comparison. 


(De)select First/Last 


Reference 

Mode: Edit Mode 

Menu: Select > (De)select First, Select > 
(De)select Last 


These operators will toggle the selection of the first or last 
control point(s) of the curve(s) in the object. This is useful to 


quickly find the start of a curve (e.g. when using it as 
path...). 


Select Next/Previous 


Reference 

Mode: Edit Mode 

Menu: Select >» Select Next, Select >» Select 
Previous 


These operators will select the next or previous control 
point(s), based on the current selection (i.e. the control 
points following or preceding the selected ones along the 


curve). In case of a cyclic curve, the first and last points are 
not considered as neighbors. 


Select More/Less 


Reference 


Mode: Edit Mode 
Menu: Select » More/Less 
Shortcut: Ctrl-NumpadPlus, Ctrl-NumpadMinus 


Their purpose, based on the currently selected control 
points, is to reduce or enlarge this selection. 


More 


For each selected control point, select a// its linked points 
(i.e. one or two...). 


Less 


For each selected control point, if a// points linked to this 


point are selected, keep this one selected. Otherwise, 
deselect it. 


This implies two points: 


1. When al/ control points of a curve are selected, nothing 
will happen (as for Less, all linked points are always 
selected, and of course, More cannot add any). 


Conversely, the same goes when no control points are 
selected. 


2. Second, these tools will never “go outside” of a curve 


(they will never “jump” to another curve in the same 
object). 


Pick Shortest Path 


Reference 


Mode: Edit Mode 
Menu: Menu Search » Pick Shortest Path 


Shortcut: Ctrl-LMB 


Selects the curve segments between two control points: the 
active and the one under the cursor. In the case of a closed 
curve, the shortest path will be selected. 


Editing 
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Subdivide 
Switch Direction 


e Other 


o Set Goal Weight 
o Add Vertex 


Transform Panel 


Reference 
Mode: Edit Mode 
Panel: Sidebar >» Transform 


When nothing is selected, the panel is empty. When more 
than one vertex is selected, the median values are edited 
and “Median” is added in front of the labels. 


Control Point, Vertex 
The first controls (X, Y, Z) show the coordinates of the 
selected point or handle (vertex). In case of a NURBS 
curve, there is a fourth component available (W), which 
defines the weight of the selected control point or the 
median weight. 


Space 
The Space radio buttons let you choose if those 
coordinates are relative to the object origin (local) or the 
global origin (global). 


Global, Local 


Weight 
Controls the “goal weight” of selected control points, 
which is used when a curve has Soft Body physics, 
forcing the curve to “stick” to their original positions, 
based on the weight. 


Radius 
Controls the width of the extrusion/bevel along the 
“spinal” curve. The radius will be interpolated from point 


to point (you can check it with the normals). 


Tilt 
Controls how the normals (visualized as arrows) twist 
around each control point - so it is only relevant with 3D 
curves! The tilt will be interpolated from point to point 
(you can check it with the normals). 


Curve 


This page covers the basics of curve editing. 


Transform 

Reference 

Mode: Edit Mode 

Menu: Curve > Transform 


A Bézier curve can be edited by transforming the locations 
of both control points and handles. NURBS curve on the 
other hand have only control points. 


Move, Rotate, Scale 
Like other elements in Blender, curve control points and 
handles can be moved, rotated, or scaled as described in 
Basic Transformations. 


To Sphere, Shear, Warp, Bend, Push/Pull, Warp, Randomize 
The transform tools are described in the Transformations 
sections. 


Move/Scale Texture Space 
Like other objects, curves have textures spaces which 
can be edited. 


Radius 


Reference 


Mode: Edit Mode 


Tool: Toolbar > Radius 
Menu: Curve > Transform > Radius 
Shortcut: AlLt-S 


The Radius allows you to directly control the width of the 
extrusion along the “spinal” curve. The radius will be 
interpolated from point to point (you can check it with the 
normals). The Radius of the points is set using the Radius 
transform tool. Or in the Sidebar Transform panel. 


® 


One control point radius set to zero. 


Mirror 

Reference 

Mode: Edit Mode 
Menu: Curve > Mirror 
Shortcut: Ctrl-M 


The Mirror tool is also available, behaving exactly as with 
mesh vertices. 


Snap 


Reference 


Mode: Edit Mode 
Menu: Curve > Snap 
Shortcut: Shift-S 


Mesh snapping also works with curve components. Both 
control points and their handles will be affected by 
Snapping, except for within itself (other components of the 
active curve). Snapping works with 2D curves but points will 
be constrained to the local XY axes. 


Spin 


Reference 
Mode: Edit Mode 
Menu: Curve > Spin 


The Spin operator only works for one dimensional surface 
objects. Its use for curves is currently not possible, the full 
feature is documented in Surface editing. 


Add Duplicate 


Reference 

Mode: Edit Mode 

Menu: Curve > Add Duplicate 
Shortcut: Shift-D 


This tool duplicates the selected control points, along with 
the curve segments implicitly selected (if any). If only a 


handle is selected, the full point will be duplicated too. The 
copy is selected and placed in select mode, so you can 
move it to another place. 


Split 


Reference 

Mode: Edit Mode 
Menu: Curve » Split 
Shortcut: Y 


The Split operator splits a selected segment of a curve from 
the rest of the curve. This curve can then be moved or 
altered without affecting the other curve. If a single control 
point is selected the Split operator will create a new singular 
loose control point; leaving the previously selected control 
point attached to the rest of the curve. 


Separate 

Reference 

Mode: Edit Mode 
Menu: Curve » Separate 
Shortcut: P 


Curve objects that are made of multiple distinct curves can 
be separated into their own objects by selecting the desired 
segments and pressing P. Note, if there is only one curve in 
a Curve object, Separate will create a new Curve object with 
no control points. 


Toggle Cyclic 


Reference 

Mode: Edit Mode 

Menu: Curve > Toggle Cyclic 
Shortcut: Alt-C 


This toggles between an open curve and closed curve 
(Cyclic). Only curves with at least one selected control point 
will be closed/open. The shape of the closing segment is 
based on the start and end handles for Bézier curves, and 
as uSual on adjacent control points for NURBS. The only time 
a handle is adjusted after closing is if the handle is an Auto 
one. Fig. Open and Closed curves. is the same Bézier curve 
open and closed. 


This action only works on the original starting control point 
or the last control point added. Deleting a segment(s) does 
not change how the action applies; it still operates only on 
the starting and last control points. This means that Alt-c 
may actually join two curves instead of closing a single 
curve! Remember that when a 2D curve is closed, it creates 
a renderable flat face. 
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Open and Closed curves. 


Set Spline Type 


Reference 
Mode: Edit Mode 
Menu: Curve > Set Spline Type 


Set Spline Type converts splines in a curve object between 
Bézier, NURBS, and Poly curves. Note, this is not a “smart” 
conversion, i.e. Blender does not try to keep the same 
Shape, nor the same number of control points. For example, 
when converting a NURBS to a Bézier, each group of three 
NURBS control points become a unique Bézier one (center 
point and two handles). 


See also 


Convert/from Mesh. 


Show/Hide 


Reference 

Mode: Edit Mode 

Menu: Curve >» Show/Hide 
Shortcut: Alt-H, H, Shift-H 


When in Edit Mode, you can hide and reveal elements from 
the display. You can only show or hide control points, as 
segments are always shown, unless all control points of the 


connected curve are hidden, in which case the curve is fully 
hidden. 


See Show/Hide in Object Mode. See also the Curve Display 
panel. 


Cleanup 


Decimate Curve 


Reference 
Mode: Edit Mode 
Menu: Curve > Clean Up >» Decimate Curve 


The Decimate Curve operator reduces the number of control 
points while trying to maintain the curves original shape. 
This operator works similar to its mesh counterpart. 


Ratio 
The percentage of control points to remove. 


Note 


This tool can only decimate Bézier curves. 


Delete 


Reference 


Mode: Edit Mode 
Menu: Curve > Delete... 


Shortcut: X, Delete; Ctrl-X 


Options for the Delete pop-up menu: 


Vertices 
This will delete the selected control points, without 
breaking the curve (i.e. the adjacent points will be 
directly linked, joined, once the intermediary ones are 
deleted). Remember that NURBS order cannot be higher 
than its number of control points, so it might decrease 
when you delete some control point. Of course, when 
only one point remains, there is no more visible curve, 
and when all points are deleted, the curve itself is 
deleted. 


Segment 
Deletes the segment that connects the selected control 
points and disconnecting them. 


Dissolve Vertices Ctrl-X 
Deletes the selected control points, while the remaining 
segment is fitted to the deleted curve by adjusting its 
handles. 


Before deleting. Deleting vertices. 


Deleting segment. Dissolve vertices. 


Control Points 


Extrude Curve and Move 


Reference 

Mode: Edit Mode 

Menu: Control Points » Extrude Curve and Move 
Shortcut: E 


Extrudes points by duplicating the selected points, which 
then can be moved, and connecting those points back to the 
Original curve creating a continuous curve. 


Make Segment 


Reference 

Mode: Edit Mode 

Menu: Control Points » Make Segment 
Shortcut: F 


Connects two disconnected control points. The selection 
must be loose points, or the first/last point of a curve, then 
press F. If the points belong to different curves, these are 
joined by a segment to become a single curve. 


Two curves before. Curve after joining. 


Note that you can only join curves of the same type (i.e. 
Bézier with Bézier, NURBS with NURBS). Additionally, you 
can close a curve by toggling cyclic. 


Tilt 


Reference 

Mode: Edit Mode 

Tool: Toolbar > Tilt 
Menu: Control Points > Tilt 
Shortcut: Ctrl-T 


This setting controls how the normals (visualized as arrows) 
twist around each control point - so it is only relevant with 
3D curves! The tilt will be interpolated from point to point 
(you can check it with the normals). 


30 degree Mean Tilt of all control points. 


Clear Tilt 


Reference 

Mode: Edit Mode 

Menu: Control Points » Clear Tilt 
Shortcut: Alt-T 


You can also reset the tilt to its default value (i.e. 
perpendicular to the original curve plane). With NURBS, the 
tilt is always smoothly interpolated. However, with Bézier, 
you can choose the interpolation algorithm. 


Set Handle Type 


Reference 

Mode: Edit Mode 

Menu: Control Points >» Set Handle Type 
Shortcut: V 


Handle types are a property of Bézier curves and can be 
used to alter features of the curve. For example, switching 
to Vector handles can be used to create curves with sharp 
corners. Read the Bézier curves page for more details. 


Toggle Free/Align 
Additionally, this operator can be used to toggle between 
Free and Aligned handle types. 


Recalculate Handles 


Reference 


Mode: Edit Mode 
Menu: Control Points » Recalculate Handles 
Shortcut: Shift-N 


The Recalculate Handles operator rotates the selected 
control point’s handle to be tangential to the curve. This can 
be used to make curves smoother and more consistent 
looking. 


Length 
Recalculates the length of the handles so they are all the 
same length. 


Smooth 

Reference 

Mode: Edit Mode 

Menu: Control Points » Smooth 


For Bézier curves, this smoothing operation reduces the 
distance between the selected control point(s) and their 
neighbors, while keeping the neighbors anchored. Does not 
effect control point tangents. 


Original, unsmoothed Curve. 


Entire curve smoothed over 20 times by holding 
Shift-R to repeat last step. 


Only three control points in the center smoothed 
over 20 times. 


Smooth Curve Tilt 


Reference 
Mode: Edit Mode 
Menu: Control Points » Smooth Curve Tilt 


The Smooth Curve Ti/t operator interpolates the Ti/t value 
for the selected control points. This will reduce sharp 
changes in the curve’s Ti/t and give a smooth transition 
between points. 


Smooth Curve Radius 


Reference 
Mode: Edit Mode 
Menu: Control Points » Smooth Curve Radius 


The Smooth Curve Radius operator interpolates the Radius 
value for the selected control points. This will reduce sharp 
changes in the curve’s Radius and give a smooth transition 
between points. 


Smooth Curve Weight 


Reference 


Mode: Edit Mode 
Menu: Control Points » Smooth Curve Weight 


The Smooth Curve Weight operator interpolates the Weight 
value for the selected control points. This will reduce sharp 


changes in the curve’s Weight and give a smooth transition 
between points. 


Hooks 

Reference 

Mode: Edit Mode 

Menu: Control Points » Hooks 
Shortcut: Ctrl-H 


Hooks can be added to control one or more points with 
other objects. 


Make Vertex Parent 


Reference 

Mode: Edit Mode 

Menu: Control Points » Make Vertex Parent 
Shortcut: Ctrl-P 


You can make other selected objects children of one or three 
control points, as with mesh objects. 


To select a mesh (that is in view) while editing a curve, ctrt- 
P click on it. Select either one or three control points, then 
Ctrl-LMB the object and use Ctri-P to make a vertex parent. 
Selecting three control points will make the child follow the 
median point between the three vertices. An alternative 


would be to use a Child Of constraint. See also the Curve 
modifier. 


Segments 
Subdivide 


Reference 
Mode: Edit Mode 
Menu: Curve >» Segments » Subdivide 


Curve subdivision simply subdivides all selected segments 
by adding one or more control points between the selected 
segments. 


Number of Cuts 
The number of subdivisions to perform. 


Switch Direction 


Reference 
Mode: Edit Mode 
Menu: Curve >» Segments » Switch Direction 


This tool will “reverse” the direction of any curve with at 
least one selected element (i.e. the start point will become 
the end one, and vice versa). This is mainly useful when 
using a curve as path, or using the bevel and taper options. 


Other 


This page describes other curve editing tools that are not 
accessible via the edit menus. 


Set Goal Weight 


Reference 
Mode: Edit Mode 
Menu: Context Menu » Set Goal Weight 


Sets the curve’s Weight for the selected control point to the 
specified value. If more than one control point is selected 
this will set the Mean Weight. 


Add Vertex 


Reference 
Mode: Edit Mode 
Shortcut: Ctrl-RMB 


Interactively places new points with ctrl-RMB at the cursor 
position. With the selection it deals in same manner as the 
Extrude Curve and Move tool. 


Properties 


e Shape 
« Geometry 
o Bevel 
o Start & End Mapping 
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Shape 


¥ Shape 


2D 
Resolution Preview U 


Render U 


Twist Method Minimum 


Smooth 


FillMode Full 


¥ Fill Deformed 


Y Radius 
Stretch 


Bounds Clamp 


Shape panel. 


Dimensions 
By default, new curves are set to be 3D, which means 
that control points can be placed anywhere in 3D space. 
Curves can also be set to 2D which constrain the control 
points to the curve’s local XY axis. 


Resolution Preview/Render U 
The resolution property defines the number of points that 
are computed between every pair of control points. 
Curves can be made more or less smooth by increasing 
and decreasing the resolution respectively. The Preview U 
setting determines the resolution in the 3D Viewport 
while the Render U setting determines the curve’s render 
resolution. If Render U is set to zero (0), then the Preview 


U setting is used for both the 3D Viewport and render 
resolution. 


Curves with a Curves with a 
resolution of 3. resolution of 12. 


Twist Method 


A 3D curve has control points that are not located on the 
curve’s local XY plane. This gives the curve a twist which 
can affect the curve normals. You can alter how the twist 
of the curve is calculated by choosing from Minimum, 
Tangent and Z-Up options from the select menu. 


Curves with a twist Curves with a twist 
of Minimum. of Tangent. 


Smooth 
Interactively removes twists from the curve. This is useful 
if a curve has noticeable “kinks” from over twisting; 
which can be possible when converting meshes to 
curves. 


Fill Mode 


Fill determines the way a curve is displayed when it is 
beveled (see below for details on Beveling). When set to 


Half the curve is displayed as half a cylinder. 


Curves with a fill of Curves with a fill of 
Half. Full. 


Fill Deformed 


Fills the curve after applying all modifications that might 
deform the curve (i.e. shape keys and modifiers). 


Curve Deform 
Radius 
Causes the deformed object to be scaled by the set 


curve radius. Utilized when using a curve as a path or 
when using the Curve Modifier. 


Stretch 
The Stretch curve option allows you to let the mesh 
object stretch, or squeeze, over the entire curve. To 
get the expected result, use this together with the 


Bounds Clamp option. Utilized when using the Curve 
Modifier. 


Bounds Clamp 
When this option is enabled, the object and mesh 
offset along the deformation axis is ignored. This can 
be useful with the Stretch option or when using a 
negative axis. Utilized when using the Curve Modifier. 


Geometry 


¥ Geometry 


Offset 
Extrude 


Taper Object 


Y Bevel 


Depth 
Resolution 


Object 


Geometry panel. 


Offset 
Moves the extrusion parallel to the curve normals. 


Bézier Circle -1 offset, 0.5 extrusion, 0.25 Bevel 
Depth, 10 Bevel resolution. 


Extrude 


Will extrude the curve along both the positive and 
negative local Z axes. Turns a one-dimensional curve into 
a two-dimensional curve by giving it height. With a scale 
is the sum of both directions, perpendicular to the 
curve’s normals. 


Bézier Circle 0.0 
extrude (Edit 
Mode). 


Extruded by 0.5 
(Object Mode). 


Taper Object 
Tapering a curve causes it to get thinner towards one 
end. You can also alter the proportions of the Taper 
throughout the tapered object by moving/scaling/rotating 
the control points of the Taper Object. The taper curve is 
evaluated along the local X axis, using the local Y axis for 
width control. In order for this to work the Taper Object 
can only be another open curve. 


The details are: 


e The taper is applied independently to all curves of 
the extruded object. 


Only the first curve in a Taper Object is evaluated, 
even if you have several separated segments. 

The scaling starts at the first control point on the left 
and moves along the curve to the last control point 
on the right. 

Negative scaling, (e.g. negative local Y on the taper 
curve) is possible as well. However, rendering 
artifacts may appear. 

You may need to increase the curve resolution to see 
more detail of the taper. 

The Taper Object is distributed by control points. 
Therefor unevenly spaced control points may likelier 
to stretch the shape of the taper. Subdividing 
segments causes those points to use a larger fraction 
of the overall taper shape. 

With closed curves, the taper curve in Taper Object 
acts along the whole curve (perimeter of the object), 
not just the length of the object, and varies the 
extrusion depth. In these cases, you want the relative 
height of the Taper Object Taper curve at both ends 
to be the same, so that the cyclic point (the place 
where the endpoint of the curve connects to the 
beginning) is a smooth transition. 


Hint 

Editing the handles and control points of the Taper 
Object will instantly change the shape of the original 
object. 


Taper Mode 
For curves using a Taper Object, this option defines how 
the effective curve radius is computed from the Taper 
Object. 


Override: The curve radius is ignored and the 
effective radius is equal to the taper 
radius. 

Multiply: The effective radius is computed by 
multiplying the taper radius with the 
curve radius. 

Add: The effective radius is computed by 
adding the taper radius to the curve 
radius. 


Examples of a curve with a radius of zero on one end and 
a radius of one on the other end. 


—_ | 
Override Multiply 
mode. mode. 
Map Taper 


For curves using a Taper Object and with modifications to 
the Start/End Bevel Factor the Map Taper option will 
apply the taper to the beveled part of the curve (not the 
whole curve). 


Bevel 


Round 


Depth 
Changes the size of the bevel. 


A curve with A curve with 

different Bevel different Bevel 

depths applied depths applied 

(Depth of 0.05). (Depth of 0.25). 
Resolution 


Alters the smoothness of the bevel. 


A curve with A curve with 
different different 
resolutions applied resolutions applied 
(Resolution of 1). (Resolution of 12). 

Fill Caps 

Seals the ends of a beveled curve. 
Object 
Object 


Here you can specify a curve object (opened or closed) 
which will be extruded along the curve. If your object’s 


shape is 3D, it will be projected to its local XY plane 
before the extrusion. You can check how the projected 
Object looks like by switching its shape to 2D. 


Important 

Make sure the shape you want to extrude is in the 
Object’s local XY plane. If it is in the local XZ or YZ 
plane, it will be reduced to a line when it is projected to 
the local XY plane. Because of this, the extruded shape 
will be a flat plane. 


A curve with a A curve with a 

Bézier curve as the Bézier circle as the 

Bevel Object. Bevel Object. 
Profile 


This Curve Widget allows the creation of a user-defined 
profile with more complexity than with the single profile 
parameter. The modal tool allows toggling the custom 
profile, but the shape of the profile is only editable in the 
options panel after the operation is confirmed. 


The profile starts at the bottom right of the widget and ends 
at the top left, as if it were between two edges intersecting 
at a right angle. Control points are created in the widget and 


then the path is sampled 
with the number of 
segments from the Bevel 
modifier. 


Note 


The Profile curve widget 
stays active when miters 
are enabled because it still 
controls the shape of the 
miter profiles. 


Presets A ASN? x 0.25000 Y 0.24986 x 
The Support Loops and Sample Straight Edges 
Steps presets are built Sample Even Lengths 
dynamically depending 
on the number of The custom profile widget. 


segments in the bevel. If 
the number of segments 
is changed, the preset will have to be re-applied. 


Sampling 
Samples will first be added to each control point, then if 
there are enough samples, they will be divided evenly 
between the edges. The Sample Straight Edges option 
toggles whether the samples are added to edges with 
sharp control points on either side. If there aren’t enough 
Samples to give each edge the same number of samples, 
they will just be added to the most curved edges. So it is 
recommended to use at least as many segments as there 
are control points. 


Start & End Mapping 


Factor Start, End 
These options determine where to start/end the 
geometry of the curve. This allows to make a curve which 
is not fully covered with geometry. 


Increasing the start value to 0.5 will start the geometry 
at 50% of the distance from the start of the curve (in 
effect shortening the curve). Decreasing the end value 
by 0.25 will start the geometry at 25% of the distance 
from the end of the curve (again, shortening the curve). 


A curve with no A curve with a 0.6 
Factor Start, End. End factor. 


Mapping Start, End 
Allows to control the relation between the Factor Start, 
End (number between 0 and 1) and the rendered start 
and end point of the spline’s geometry. 


Resolution: Maps the start and end factor to the 
number of subdivisions of a spline (U 
resolution). 

Segments: Maps the start and end factor to the 


length of its segments. Mapping to 

segments treats the subdivisions in 

each segment of a curve as if they 

would have all the same length. 
Spline: 


Maps the start and end factor to the 
length of a spline. 


Examples 


Open 2D Curve 


The extrusion will create a “wall” or “ribbon” following the 
curve shape. If using a Bevel Depth, the wall becomes a sort 
of slide or gutter. If your normals are facing the wrong way 
you can switch their direction as shown here. 


Open 2D Curve with ait-c, fill set to none, zero 
offset, 0.5 extrusion, 0.25 Bevel Depth, 10 Bevel 
resolution. 


Closed 2D Curve 


This is probably the most useful situation, as it will quickly 
create a volume, with (by default) two flat and parallel 
surfaces filling the two sides of the extruded “wall”. You can 
remove one or both of these faces by choosing the fill 
mode: both, front, back, or none. 


The optional bevel depth will always create a 90 degree 
bevels here. 


Closed 2D Curve, 0.5 extrude, 0.25 Bevel Depth, 10 
Bevel resolution, Fill: Both. 


3D Curve 


Here the fact that the curve is closed or not has no 
importance - you will never get a volume with an extruded 
3D curve, only a wall or ribbon, like with open 2D curves. 


However, there is one more feature with 3D curves: the Ti/t 
of the control points (see above). It will make the ribbon 
twist around the curve to create a Mobius strip, for example. 


Taper 


Let us taper a simple curve circle extruded object using a 
taper curve. Add a curve, then exit Edit Mode. Add another 
one (a closed one, like a circle); call it “BevelCurve”, and 
enter its name in the Bevel Object field of the first curve 
(Curve tab). We now have a pipe. Add a third curve while in 


Object Mode and call it “TaperCurve”. Adjust the left control 
point by raising it up about 5 units. 


Now return to the Object tab, and edit the first curve’s Taper 
Object field in the Geometry panel to reference the new 
taper curve which we called “TaperCurve”. When you hit 
enter the taper curve is applied immediately, with the 
results shown in Fig. Circle curve set as Bevel Object.. 


Circle curve set as Taper extruded 
Bevel Object. curve. 


You can see the taper curve being applied to the extruded 
object. Notice how the pipe’s volume shrinks to nothing as 
the taper curve goes from left to right. If the taper curve 
went below the local Y axis the pipe’s inside would become 
the outside, which would lead to rendering artifacts. Of 
course as an artist that may be what you are looking for! 


Taper example 1. 


In Fig. you can clearly see the effect the 
left taper curve has on the right curve object. Here the left 
taper curve is closer to the object origin and that results ina 
smaller curve object to the right. 


Taper example 2. 


In Fig. Taper example 2. a control point in the taper curve to 
the left is moved away from the origin and that gives a 
wider result to the curve object on the right. 


Taper example 3. 


In Fig. Taper example 3. we see the use of a more irregular 
taper curve applied to a curve circle. 


Bevel extrusion with Tilt example. 


Path Animation 


The Path Animation settings can be used to determine how 
child objects move along a certain path. 


Note 


This feature is deprecated, but still available. A more 
future-proof method is the Follow Path Constraint. 


¥ Path Animation 


Frames 100 
Evaluation Time 0.000 


Follow 


Path Animation panel. 


Frames 
The number of frames that are needed to traverse the 
path, defining the maximum value for the Evaluation 
Time setting. 


Evaluation Time 
Parametric position along the length of the curve that 
object following it should be at (the position is evaluated 
by dividing by the Path Length value). By default, it is 
linked to the global frame number, but could be 
keyframed to give more control over the path animation. 


Clamp 


Clamp the curve path children so they can’t travel past 
the start/end point of the curve. 


Follow 


Make the curve path children rotate along the curvature 
of the path. 


Example 


This example shows you how setup a Path Animation. 


1. 


Add an object you want to animate and a path along 
which this object will move. In this example it’s the 
Monkey and the Bézier Circle. 


. To parent the monkey to the Bézier circle, first select the 


monkey then the curve (so that the curve is the active 
object), press Ctri-P and select Follow Path. It will 
automatically animate Evaluation Time and activate 
Follow option in the Path Animation panel. 


. Select the monkey and Clear Origin to reset its offset. 
. You can change the orientation of the monkey by 


changing the Tracking Axis. 


Monkey parented to 


the Bézier Circle. The final result. 


Active Spline 


Reference 
Mode: Edit Mode 
Menu: Properties » Curve » Active Spline 


The Active Spline panel is used in Edit Mode to control 
properties of the currently selected spline. 


Common Options 


Cyclic U 
Closes the active spline. 


Default NURBS A NURBS curve 
curve. with Cyclic applied. 


Resolution U 


Alters the resolution of each segment by changing the 
number of subdivisions. 


Smooth 
Use Smooth Shading for any 3D geometry. 


Poly 


¥ Active Spline 


Cyclic U 


Smooth # « 


Active Spline panel: Poly Spline. 


Cyclic U 
See Common Options. 


Smooth 
See Common Options. 


4 I 
Bezier 
Y Active Spline 
Cyclic U 
Resolution U 12 
Interpolation Tilt Linear . 
Radius Linear 4 
Smooth @ « 
Active Spline panel: Bézier Spline. 
Cyclic U 


See Common Options. 


Resolution U 
See Common Options. 


Interpolation Tilt 
Alters how the tilt of a segment is calculated. 


Radius 
Alters how the radius of a beveled curve is calculated. 
The effects are easier to see after increasing the radius. 


Smooth 
See Common Options. 


NURBS 


One of the characteristics of a NURBS object is the knot 
vector. This is a sequence of numbers used to determine the 
influence of the control points on the curve. While you 
cannot edit the knot vectors directly, you can influence 
them through the Endpoint and Bézier options in the Active 
Spline panel. Note that, the Endpoint and Bézier settings 
only apply to open NURBS curves. 


¥ Active Spline 


Cyclic U 
Bezier U 
EndpointU 
Order U = 
Resolution U 12 


Smooth # « 


Active Spline: NURBS Spline. 


Cyclic U 
See Common Options. 


Bézier U 
Makes the NURBS curve act like a Bézier curve. The 
NURBS control points act like Free handles of Bézier 


curve. 


Endpoint U 
Makes the curve contact the end control points. 


A NURBS curve 
Default NURBS with Endpoint 
curve. 


enabled. 


Order U 
The order of the NURBS curve determines the area of 
influence of the control points over the curve. Higher 
order values means that a single control point has a 
greater influence over a greater relative proportion of the 
curve. The valid range of Order values is 2-6 depending 
on the number of control points present in the curve. 


NURBS curves with NURBS curves with 
orders of 4. orders of 2. 


Resolution U 
See Common Options. 


Smooth 
See Common Options. 


Curve Display 


Reference 
Mode: Edit Mode 
Panel: 3D Viewport » Viewport Overlays » Curve 


Edit Mode 


When in Edit Mode, curves have special overlays to control 
how curves are displayed in the 3D Viewport. 


Handles 
Toggles the option to display the Bézier handles. 


Normals 
Toggles the display of the curve normals. 


Normal Size 
Length of the axis that points the direction of the 
normal. 


Surfaces 
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o Visualization 
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o Control Points, Rows and Grid 
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Primitives 
o NURBS Curve 
o NURBS Circle 
NURBS Surface 
NURBS Cylinder 
NURBS Sphere 
NURBS Torus 
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o Select Menu 
o Select Random 
o Checker Deselect 
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o Select Similar 


Select Control Point Row 
Select More/Less 
Editing 
o Transform Panel 
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© Control Points 
o Segments 
Properties 
o Shape 
o Active Spline 


Introduction 


Curves are 2D objects, and surfaces are their 3D extension. 
Note however, that in Blender, you only have NURBS 
surfaces, no Bézier (you have the Bézier knot type, though; 
see below), nor polygonal (but for these, you have 
meshes!). Even though curves and surfaces share the same 
object type (with texts also...), they are not the same thing; 
for example, you cannot have in the same object both 
curves and surfaces. 


NURBS surface in Edit Mode. 


As surfaces are 2D, they have two interpolation axes, U (as 
for curves) and V. It is important to understand that you can 
control the interpolation rules (knot, order, resolution) 
independently for each of these two dimensions (the U and 
V fields for all these settings, of course). 


You may ask yourself “but the surface appears to be 3D, 
why is it only 2D?”. In order to be 3D, the object needs to 
have “Volume”, and a surface, even when it is closed, does 
not have volume; it is infinitely thin. If it had a volume the 
surface would have a thickness (its third dimension). Hence, 
it is only a 2D object, and has only two interpolation 
dimensions or axes or coordinates (if you Know a bit of 
math, think of non-Euclidean geometry - well, surfaces are 
just non-Euclidean 2D planes...). To take a more “real-world” 
example, you can roll a sheet of paper to create a cylinder; 
well, even if it becomes a “volume”, the sheet itself will 
remain a (nearly...) 2D object! 


In fact, surfaces are very similar to the results you get when 
extruding_a curve. 


Visualization 


There is nearly no difference from NURBS curves, except 
that the U direction is indicated by yellow grid lines, and the 
V one is materialized by pink grid lines, as you can see in 
Fig. NURBS surface in Edit Mode.. 


You can hide and reveal control points just as with curves. 


Conversion 


As there are only NURBS surfaces, there is no “internal” 
conversion here. 


However, there is an “external” conversion available, from 
surface to mesh, that only works in Object Mode. It 
transforms a surface object into a mesh one, using the 


surface resolutions in both directions to create faces, edges 
and vertices. 


Toolbar 


Surface Edit Mode tools: 


select 
Select or move. 


Select Box 
Select objects by dragging a box. 


All objects that intersect the box will be selected. 


Select Circle 


Select objects by dragging a circle. All objects that 
intersect the path of the circle will be selected. 


Select Lasso 
Select objects by drawing a lasso. 


Cursor 
Change the location of the 3D Cursor. 


Move 
Translation tool. 


Rotate 
Rotation tool. 


Scale 
Scale tool. 


Scale Cage 
Change the scale of an object by controlling its cage. 


Transform 
Tool to adjust the objects translation, rotations and scale. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Measure 
Measure distances in the scene. 


Structure 


Many of the concepts from curves, especially NURBS ones, 
carry directly over to NURBS surfaces, such as control 
points, Order, Weight, Resolution, etc. Here we will just talk 
about the differences. 


It is very important to understand the difference between 
NURBS curves and NURBS surfaces: the first one has one 
dimension, the latter has two. Blender internally treats 
NURBS surfaces and NURBS curves completely differently. 
There are several attributes that separate them but the 
most important is that a NURBS curve has a single 
interpolation axis (U) and a NURBS surface has two 
interpolation axes (U and V). 


However, you can have “2D” surfaces made of curves (using 
the extrusion tools, or, to a lesser extent, the filling of 
closed 2D curves). And you can have “1D” curves made of 
surfaces, like a NURBS surface with only one row (either in U 
or V direction) of control points produces only a curve... 


Visually you can tell which is which by entering Edit Mode 
and looking at the 3D Viewport header: either the header 
shows Surface or Curve as one of the menu choices. Also, 
you can extrude a whole NURBS surface curve to create a 
surface, but you cannot with a simple NURBS curve. 


Control Points, Rows and Grid 


Control points for NURBS surfaces are the same as for 
NURBS curves. However, their layout is quite constraining. 


The concept of “segment” disappears, replaced by “rows” 
and the overall “grid”. 


A “row” is a set of control points forming one “line” in one 
interpolation direction (a bit similar to edge loops for 
meshes). So you have “U rows” and “V rows” in a NURBS 
surface. The key point is that a// rows of a given type (U or 
V) have the same number of control points. Each control 
point belongs to exactly one U row and one V row. 


All this forms a “grid”, or “cage”, the shape of which 
controls the shape of the NURBS surface. A bit like a 
lattice... 


This is very important to grasp: you cannot add a single 
control point to a NURBS surface; you have to add a whole U 
or V row at once (in practice, you will usually use the 
Extrude tool, or perhaps the Duplicate one, to add those...), 
containing exactly the same number of points as the others. 
This also means that you will only be able to “merge” 
different pieces of surfaces if at least one of their rows 
matches together. 


Weight 


Similar to NURBS Splines NURBS Surface control points have 
a weight property. This weight property controls how much 
influence the control point has on the surface. This weight 
should not be confused with the Goal Weight, which is used 
only for soft body simulations. The NURBS control point 
weight can be adjusted in the W number field of the 
Transform panel. 


In Fig. One control point with a weight of 5. a single control 
point, labeled “C”, has had its We/ght set to 5.0 while all 


others are at their default of 1.0. As you can see, that 
control point pulls the surface towards it. 


Y Transform 


Global 


Weight: 
Radius: 
Tilt: 


One control point with a weight of 5. 


Note 


If all the control points have the same Weight then each 
effectively cancels each other out. It is the difference in 
the weights that cause the surface to move towards or 
away from a control point. 


Preset Weights 


NURBS can create pure shapes such as circles, cylinders, 
and spheres (note that a Bézier circle is not a pure circle). To 
create pure circles, soheres, or cylinders, you must set to 
specific values the weights of the control points. This is not 
intuitive, and you should read more on NURBS before trying 


this. 


To create a sphere with 2D surfaces, its the same principle 
as with a 2D circle. You will note that the four different 


weights needed for creating a sphere (1.0, 0.707 


sqrt(0.5), 0.354 = sqrt(2)/4, and 0.25). 


A sphere surface. 


Primitives 


Reference 

Mode: Object Mode and Edit Mode 
Menu: Add > Curve 

Shortcut: Shift-A 

See also 


When adding curves there are some common options like 
other Objects. 


In Object/Edit Mode, the Add Surface menu, provides six 
different surface primitives: 


NURBS surface NURBS curve 
primitives. primitives. 


NURBS Curve 


Adds a generic curve of four control points forming an arc. 


NURBS Circle 


Adds an a closed loop of control point forming a circle. Note, 
a circle NURBS surface is never filled, unlike its “real” curve 
counterpart... 


NURBS Surface 


Adds a generic surface patch consisting of a 4x4 grid plane 
with the center grid slightly raised. 


NURBS Cylinder 


Adds an open end cylinder, consisting of an extruded NURBS 
Circle. 


NURBS Sphere 


Adds a generic sphere constructed by revolving a grid of 
control points about an axis. 


NURBS Torus 


Adds a doughnut-shaped primitive created by rotating a 
circle around an axis. 


Selecting 


This page discusses specific selecting tools for surface 
objects in Edit Mode. The Surface Edit also uses the general 
select tools used which are described in the interface 
section. 


Surface selection in Edit Mode is very similar to NURBS 
curve selection. The basic tools are the same as with 
meshes, so you can select a simple control point with an 
LMB-click, add to current selection with Shift-LMB clicks, 
Border Select, and so on. 


Select Menu 


The Select menu (in the 3D Viewport header) is even 
simpler than for curves... 


All these options have the same meaning and behavior as in 
Object Mode and mesh Edit Mode. 


All A 
Select all. 


None Alt-A 
Select none. 


Inverse Ctrl-I 
Selects all the geometry that is not selected, and 
deselect currently selected components. 


Box Select B 


Interactive box selection. 


Circle Select c 
Interactive circle selection. 


Lasso Select 
Interactive free-form selection. 


Select Random 
Select random control points. 


Checker Deselect 
Select every Nth control point. 


Select Linked Ctr1-L 
Select control points that are connected to the current 
selection. 


Select Similar Shift-G 
Select control points that have similar properties to the 
current selection. 


Select Control Point Row 
Select a whole row of control points. 


Select More/Less 
Select objects based on their parent child relationships. 


Select Random 


Reference 


Mode: Edit Mode 


Menu: Select » Select Random 


Select random control points. 


Percent 
Selects the defined percentage of control points. 


Random Seed 
Seed used by the pseudo-random number generator. 


Action 
Controls whether the operator Se/ects or Deselects 
control points. 


Checker Deselect 


Reference 
Mode: Edit Mode 
Menu: Select >» Checker Deselect 


This tool applies an alternating selected/deselected checker 
pattern. This only works if you already have more than one 
control point selected. 


It works by changing the current selection so that only every 
Nth control points will remain selected, starting from the 
active one. 


Deselected 
The number of deselected elements in each pattern 
repetition. 


Selected 


The number of selected elements in each pattern 
repetition. 


Offset 
Offset from the starting point. 


Select Linked 


Reference 

Mode: Edit Mode 

Menu: Select > Select Linked 
Shortcut: L, Ctrl-L 


Select Linked will add to the selection the mouse cursor’s 
nearest control point, and all the linked ones, i.e. all points 
belonging to the same surface. 


Select Similar 


Reference 

Mode: Edit Mode 

Menu: Select > Select Similar 
Shortcut: Shift-G 


Selects control points that have certain similar properties to 
the active one. The Adjust Last Operation panel provides 
several selection options: 


Type 
Type 


Selects splines that have the same spline Type i.e. 
Bézier, NURBS or Poly. 


Radius 
Selects control points that have a similar Radius 
value. 


Weight 
Selects all points that have a similar Weight value. 


Direction 
Selects control points that have a similar handles 
direction. 


Compare 
For quantitative properties, this property selects the type 
of comparison to between the two numerical values. 


Equal: Select items with the same value as 
the active item’s chosen property. 

Greater: Select items with a larger value as the 
active item’s chosen property. 

Less: Select items with a smaller value as the 


active item’s chosen property. 


Threshold 
For quantitative properties, this property controls how 
close the property’s values have to be in the comparison. 


Select Control Point Row 


Reference 
Mode: Edit Mode 
Menu: Select >» Control Point Row 


Shortcut: Shift-R 


This option works a bit like edge loop selection for meshes, 
inasmuch it selects a whole row of control points, based on 
the active (the last selected) one. The first time you press 
Shift-R, the V row passing through (containing) the active 
point will be added to the current selection. If you use again 
this shortcut, you will toggle between the U and V row of 
this point, removing everything else from the selection. 


Select More/Less 


Reference 

Mode: Edit Mode 

Menu: Select >» More/Less 

Shortcut: Ctrl-NumpadPlus / Ctrl-NumpadMinus 


Expand or contract the selection based on current selected 
control points. 


More 
For each selected control point, select all its linked points 
(i.e. two, three or four). 


Less 
For each selected control point, if all points linked to this 
point are selected, keep it selected. For all other selected 
control points, deselect them. 


This implies two points: 


1. First, when all control points of a surface are selected, 
nothing will happen (as for Less, all linked points are 
always selected, and of course, More cannot add any). 


Conversely, the same goes when no control point is 
selected. 

2. Second, these tools will never “go outside” of a surface 
(they will never “jump” to another surface in the same 
object). 


Editing 


e Transform Panel 
e Surface 
Transform 
Mirror 
Snap 
spin 
Add Duplicate 
Split 
Separate 
Toggle Cyclic 
Set Spline Type 
Show/Hide 
Cleanup 
Delete 
e Control Points 
o Extrude Curve and Move 
o Make Segment 
°0 Smooth 
o Hooks 
o Make Vertex Parent 
e Segments 
o Subdivide 
0 Switch Direction 
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Transform Panel 


Reference 
Mode: Edit Mode 
Panel: Sidebar >» Transform 


When nothing is selected, the panel is empty. When more 
than one control point is selected, the median values are 
edited and “Median” is added in front of the labels. 


Control Point, Median 
The first controls (X, Y, Z) show the coordinates of the 
selected point or handle (vertex). The last control (W), 
defines the weight of the selected control point or the 
median weight. 


Space 
The Space radio buttons let you choose if those 
coordinates are relative to the object origin (local) or the 
global origin (global). 


Global, Local 


Weight 
Controls the “goal weight” of selected control points, 
which is used when a surface has Soft Body physics, 
forcing the surface to “stick” to their original positions, 
based on the weight. 


Radius 
Surface objects do not have a Radius property, this value 
has no effect. 


Tilt 
Surface objects do not have a Radius property, this value 
has no effect. 


Surface 


Surface editing has even fewer tools and options than its 
curve counterpart, but has many common points with it... 
So this page covers (or tries to cover) all the subjects, from 
the basics of surface editing to more advanced topics, like 
retopology. 


Transform 

Reference 

Mode: Edit Mode 

Menu: Surface > Transform 


A surface can be edited by transforming the locations of the 
control points. 


Move, Rotate, Scale 
Like other elements in Blender, control points can be 
moved, rotated, or scaled as described in Basic 
Transformations. 


To Sphere, Shear, Warp, Bend, Push/Pull, Warp, Randomize 
These transform tools are described in the 
Transformations sections. 


Move/Scale Texture Space 
Like other objects, surfaces have textures spaces which 
can be edited. 


Mirror 


Reference 


Mode: Edit Mode 
Menu: Curve > Mirror 
Shortcut: Ctrl-M 


The Mirror tool is also available, behaving exactly as with 
mesh vertices. 


Snap 


Reference 

Mode: Edit Mode 
Menu: Curve >» Snap 
Shortcut: Shift-S 


Mesh snapping also works with control points, except for 
within itself (other components of the active spline). 
Snapping works with 2D surfaces but points will be 
constrained to the local XY axes. 


Spin 


Reference 
Mode: Edit Mode 
Menu: Surface > Spin 


This tool is a bit similar to its mesh counterpart but with less 
control and options (in fact, there is none!). 


It only works on selected “surfaces” made of one U row (and 
not with one V row), so-called “surface curves”, by 
“extruding” this “cross section” in a square pattern. While 
automatically adjusting the weights of control points to get 
a perfect circular extrusion (this also implies closing the 
surface along the V axis), following exactly the same 
principle as for the NURBS Tube or NURBS Torus primitives. 


Add Duplicate 


Reference 

Mode: Edit Mode 

Menu: Surface » Add Duplicate 
Shortcut: Shift-D 


Similar as with meshes and curves, this tool duplicates the 
selection. The copy is selected and placed in move mode, so 
you can move it to another place. 


However, with surfaces there are some selections that 
cannot be duplicated, in which case they will just be placed 
in move mode... In fact, only selections forming a single 
valid sub-grid are copyable; let us see this in practice: 


e You can copy a single control point. From it, you will be 
able to “extrude” a “surface curve” along the U axis, 
and then extrude this unique U row along the V axis to 
create a real new surface. 

e You can copy a single continuous part of a row (ora 
whole row, of course). This will give you a new U row, 
even if you selected (part of) a V row! 

e You can copy a single whole sub-grid. 


Note 


Trying to duplicate several valid “sub-grids” (even being 
single points) at once will not work; you will have to do it 
one after the other... 


Split 


Reference 

Mode: Edit Mode 
Menu: Surface » Split 
Shortcut: Y 


The Split operator splits a selected segment of a surface 
from the rest of the surface. This segment can then be 
moved or altered without affecting the other surface. Ifa 
single control point is selected the Split operator will create 
a new singular loose control point; leaving the previously 
selected control point attached to the rest of the surface. 


Separate 

Reference 

Mode: Edit Mode 

Menu: Surface >» Separate 
Shortcut: P 


Surface objects that are made of multiple distinct parts can 
be separated into their own objects by selecting the desired 
segments and using Separate. Note, if there is only one 
surface in a surface object, Separate will create a new 
surface object with no control points. 


Toggle Cyclic 


Reference 

Mode: Edit Mode 

Menu: Surface >» Toggle Cyclic 
Shortcut: Alt=C 


As in curves, surfaces can be closed (cyclic) or open. 
However, as surfaces are 2D, you can control this property 
independently along the U and V axes. 


To toggle the cyclic property of a surface along one axis, use 
Toggle Cyclic and choose either Cyclic U or Cyclic V from the 
pop-up menu. The corresponding surface’s outer edges will 
join together to form a “closed” surface. 


Note 
Inner and Outer 


Surfaces have an “inner” and “outer” face, the first being 
black whereas the latter is correctly shaded. When you 
close a surface in one or two directions, you might get an 
entirely black object! In this case, just Switch Direction of 
the surface. 


Set Spline Type 


Reference 


Mode: Edit Mode 
Menu: Surface >» Set Spline Type 


This feature only works for Curves. 


Show/Hide 


Reference 

Mode: Edit Mode 

Menu: Curve >» Show/Hide 
Shortcut: Alt-H, H, Shift-H 


When in Edit Mode, you can hide and reveal elements from 
the display. You can only show or hide control points, as 
segments are always shown, unless all control points of the 
connected surface are hidden, in which case the surface is 
fully hidden. 


See also 


See Show/Hide in Object Mode. 


Cleanup 

Reference 

Mode: Edit Mode 

Menu: Surface > Cleanup 


This feature only works for Curves. 


Delete 


Reference 


Mode: Edit Mode 
Menu: Surface > Delete 
Shortcut: X, Delete 


The selection must abide by the following rules: 


e Whole rows, and only whole rows must be selected. 
e Only rows along the same axis must be selected (i.e. 
you cannot delete both U and V rows at the same time). 


Also remember that NURBS order cannot be higher than its 
number of control points in a given axis, so it might 
decrease when you delete some control points... Of course, 
when only one row remains, the surface becomes a “surface 
curve”; when only one point remains, there is no more 
visible surface; and when all points are deleted, the surface 
itself is deleted. 


Vertices 
This will delete the selected rows, without breaking the 
surface (i.e. the adjacent rows will be directly linked, 
joined, once the intermediary ones are deleted). 
Remember that NURBS order cannot be higher than its 
number of control points, so it might decrease when you 
delete some control point. Of course, when only one 
point remains, there is no more visible curve, and when 
all points are deleted, the curve itself is deleted. 


Segment 
Deletes the segment that connects the selected control 
points and disconnects them. 


Dissolve Vertices Ctrl-x 
This feature only works for Curves. 


Example 


In the image below (left), a row of control points has been 
selected by initially selecting the one control point and 
using Select Control Point Row to select the remaining 
control points. Then, using Delete Vertices, the selected row 
of control points is erased, resulting in the image below 
(right). 


Before and after. 


Control Points 


Extrude Curve and Move 


Reference 

Mode: Edit Mode 

Menu: Surface >» Extrude Curve and Move 
Shortcut: E 


Unlike meshes or curves, you cannot generally directly add 
new control points to a surface, as you can only extend a 
surface by adding a whole U or V row at once. The only 
exception is when working on a NURBS surface curve, i.e. a 
surface with only one control point on each U or V row. In 
this special case, all works exactly as with curves. 


Most of the time, only extrusion is available. As usual, once 
the tool is activated the extrusion happens immediately and 
you are placed into select mode, ready to drag the new 
extruded surface to its destination. 


There are two things very important to understand: 


1. Surfaces are 2D objects. So you cannot extrude 
anything inside a surface (e.g. “inner” row); it would not 
make any sense! 

2. The control “grid” must remain “squarish”, which means 
that you can only extrude a whole row, not parts of rows 
here and there... 


To summarize, the Extrude tool will only work, when one and 
only one whole border row is selected, otherwise nothing 


happens. 


Note 


As for curves, you cannot create a new surface in your 
object out of nowhere. However, unlike for curves, there is 
no “cut” option allowing you to separate a surface into 
several parts, So you only can create a new surface by 
Duplicating an existing one, or adding a new one with the 
Add menu. 


Examples 


Images Fig. Selecting control point. to Fig. Extruding. show a 
typical extrusion along the side of a surface. 


In Fig. Selecting_control point. and Select Control Point Row., 
a border row of control points were highlighted by selecting 
a single control point, and then using Select Control Point 
Row to select the rest of the control points. 


Selecting control Select Control Point 
point. Row. 


The edge is then extruded as shown in Fig. Extruding.. 
Notice how the mesh has bunched up next to the 
highlighted edge. That is because the new extruded surface 
section is bunched up there as well. 


Extruding. 


By moving the new section away from the area, the surface 
begins to “unbunch”. 


You can continue this process of extruding or adding new 


surface sections until you have reached the final shape for 
your model. 


Make Segment 


Reference 
Mode: Edit Mode 
Menu: Surface » Make Segment 


Shortcut: F 


Just like curves, merging two surfaces requires that a single 
edge, a border row of control points, from two separate 
surfaces is selected. This means that the surfaces must be 
part of the same object. For example, you cannot join two 
surfaces while in Object Mode - but you can of course, as 
with any objects of the same type, join two or more Surface 
objects - they just will not be “linked” or merged in a single 
one. 


This tool is equivalent to creating edges or faces for meshes 
(hence its shortcut). The selection must contain only border 
rows of the same resolution (with the same number of 
control points), else Blender will try to do its best to guess 
what to merge with what, or the merge will fail (either 
Silently, or stating that Resolution does not match if rows with 
different number of points are selected, or that there is Too 
few selections to merge if you only selected points in one 
surface...). To select control points of different surfaces, in 
the same object, you must use either box select or circle 
select; Ctri-LmB will not work. 


So to avoid problems, you should always only select border 
rows with the same number of points... Note that you can 
join a border U row of one surface with a border V row of 
another one, Blender will automatically “invert” the axis of 
one surface for them to match correctly. 


NURBS surface curves are often used to create objects like 
hulls, as they define cross sections all along the object, and 
you just have to “skin” them as described above to geta 
nice, smooth and harmonious shape. 


Examples 


Fig. Joining ready. is an example of two NURBS surface 
curves, not NURBS curves, in Edit Mode, ready to be joined. 


Fig. Joining complete. is the result of joining the two curves. 


Joining ready. Joining complete. 
Smooth 
Reference 
Mode: Edit Mode 
Menu: Surface > Control Points » Smooth 


Iteratively smooths the selected control points by reducing 
the distance between neighboring control points. 


Hooks 

Reference 

Mode: Edit Mode 

Menu: Surface > Control Points » Hooks 
Shortcut: Ctrl-H 


Hooks can be added to control one or more points with 
other objects. 


Make Vertex Parent 


Reference 

Mode: Edit Mode 

Menu: Surface > Control Points » Make Vertex 
Parent 

Shortcut: Ctrl-P 


You can make other selected objects children of one or three 
control points, as with mesh objects. 


To select a mesh (that is in view) while editing a surface, 
Ctri-P click on it. Select either one or three control points, 
then ctri-LmB the object and use ctri-P to make a vertex 
parent. Selecting three control points will make the child 
follow the median point between the three vertices. An 
alternative would be to use a Child Of constraint. See also 
the Curve modifier. 


Segments 
Subdivide 


Reference 
Mode: Edit Mode 
Menu: Surface >» Segments > Subdivide 


The Subdivision operator simply subdivides all selected 
segments by adding one or more control points between the 
selected segments. Selected grids will be split into four 
smaller ones. 


If used on a 1D Surface (a “Surface curve”), this tool works 
exactly as with curves. 


Number of Cuts 
The number of subdivisions to perform. 


Switch Direction 


Reference 
Mode: Edit Mode 
Menu: Surface >» Segments » Switch Direction 


This tool will “reverse” the direction of any curve with at 
least one selected element (i.e. the start point will become 
the end one, and vice versa). Mainly useful when using a 
curve as path, or the bevel and taper options... 


Properties 


e Shape 
e Active Spline 


Shape 


¥ Shape 


Resolution Preview U 
V 

Render U 

V 


Shape panel. 


Resolution Preview U/V 
Resolution to use in the 3D Viewport. 


Render U/V 
Just like NURBS curves, Resolution controls the detail of 
the surface. The higher the Resolution the more detailed 
and smoother the surface is. The lower the Resolution 
the rougher the surface. However, here you have two 
resolution settings, one for each interpolation axis (U and 
V). 


You can adjust the resolution separately for both preview 
and render, to not slow things down in the viewport, but 
still get good render results. 


Resolution 1x1. Resolution 3x3. 


Resolution of 1 for Resolution of 3 for 
both U and V. both U and V. 


See also 


The panels of the Curve and Surface tab are the same as 
for curves, just with fewer options... 


Active Spline 


Reference 

Mode: Edit Mode 

Menu: Properties » Curve > Active Spline 
See also 


Active Spline for curves. 


The Active Spline panel is used in Edit Mode to control 
properties of the currently selected spline. 


Y Active Spline 


Cyclic U 

V 

Bezier U 

V 

Endpoint U 

V 
Order U 
V 


4 

2 

Resolution U 4 
V 4 


Smooth # »« 


Active Spline panel. 


Cyclic U/V 


Like curves, surfaces can be closed (cyclical) or open, 
independently in both directions, allowing you to easily 
create a tube, torus or sphere shape, and they can be 
viewed as “solids” in Edit Mode. This can be set per 
interpolation axis. 


Bézier U 
Makes the surface act like a Bézier curve. The control 
points act like Free handles of a Bézier curve. Depending 
on the Order, 3 or 4 control points form one spline 
segment. This can be set per interpolation axis. 


Endpoint U/V 
Makes the surface contact the end control points. This 
can be set per interpolation axis. 


Endpoint U. 


In the image below, the U interpolation axis is labeled as 
“U” and the V interpolation axis is labeled as “V”. The U’s 
interpolation axis has been set to Endpoint and as such 
the surface now extends to the outer edges from E1 to 
E2 along the U interpolation axis. 


To cause the surface to extend to all edges, Endpoint 
would be set for the V’s axis as well. 


Order U/V 


This property is the same as with NURBS Curves; it 
specifies how much the control points are taken into 
account for calculating the curve of the surface shape. 
For high Orders 1 the surface pulls away from the control 
points, creating a smoother surface by assuming that the 
Resolution U/V is high enough. For lowest Orders 2 the 
surface follows the control points, creating a surface that 
tends to follow the grid cage. 


Order 2 and Order 4 surface. 


For illustration purposes, in both Fig. Order 2 and Order 4 
surface., the knot vectors were set to Endpoint, causing 
the surface to extend to all edges. 


You can set independently the order for each 
interpolation axis, and like curves, it cannot be lower 
than 2, and higher than 6 or the number of control points 
on the relevant axis. 


Resolution U/V 


Alters the resolution of each segment by changing the 
number of subdivisions. This can be set per interpolation 
axis. 


Smooth 
Use Smooth Shading for any 3D geometry. 
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Introduction 


Metaball objects (short meta) are implicit surfaces, meaning 
that they are not explicitly defined by vertices (as meshes 
are) or control points (as surfaces are): they exist 
procedurally. Meta objects are literally mathematical 
formulas that are calculated on-the-fly by Blender. 


A very distinct visual characteristic of metas is that they are 
fluid mercurial, or clay-like forms that have a “rounded” 
Shape. Furthermore, when two meta objects get close to one 
another, they begin to interact with one another. They 
“blend” or “merge”, as water droplets do, especially in zero- 
g (which, by the way, makes them very handy for modeling 
streams of water when you do not want to do a fluid 
Simulation). If they subsequently move away from one 
another, they restore their original shape. 


Each of these is defined by its own underlying mathematical 
structure, and you can at any time switch between them 
using the Active Element panel. 


Typically Meta objects are used for special effects or as a 
basis for modeling. For example, you could use a collection 
of metas to form the initial shape of your model and then 
convert it to a mesh for further modeling or sculpting. Meta 
objects are also very efficient for ray tracing. 


Warning 


Names of Meta objects are very important, as they define 
families, and only objects within a same family interact 
with each other. Unlike other object types, even edition 


(transformations) in Object Mode will affect the generated 
geometry within the edited families. 


Visualization 


In Object Mode, the calculated mesh is shown, along with a 
black “selection ring”. 


Influence 


Selection ring 


Meta Ball in Edit Mode. 


In Edit Mode (Fig. Meta Ball in Edit Mode.), a meta is 
displayed as a mesh (either shaded or as black wireframe, 
but without any vertex of course), with two colored circles: a 
red one for selection (pink when selected), and a green one 
for a direct control of the meta’s stiffness (light green when 
active). Note that except for the scale transformation, 
having the green circle highlighted is equivalent to having 
the red one. 


Toolbar 


Metaball Edit Mode tools: 


Tweak 
Select or move. 


Select Box 
Select objects by dragging a box. All objects that 
intersect the box will be selected. 


Select Circle 
Select objects by dragging a circle. All objects that 
intersect the path of the circle will be selected. 


Select Lasso 
Select objects by drawing a lasso. 


Cursor 
Change the location of the 3D Cursor. 


Move 
Translation tool. 


Rotate 
Rotation tool. 


Scale 
Scale tool. 


Scale Cage 
Change the scale of an object by controlling its cage. 


Transform 


Tool to adjust the objects translation, rotations and scale. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Measure 
Measure distances in the scene. 


Shear 
Shear selected items along a defined axis. 


Structure 


Technical Details 


A more formal definition of a meta object can be given as a 
directing structure which can be seen as the source of a 
Static field. The field can be either positive or negative and 
hence the field generated by neighboring directing 
structures can attract or repel. 


The implicit surface is defined as the surface where the 3D 
field generated by all the directing structures assume a 
given value. For example a meta ball, whose directing 
structure is a point, generates an isotropic (i.e. identical in 
all directions) field around it and the surfaces at constant 
field value are spheres centered at the directing point. 


Meta objects are nothing more than mathematical formula 
that perform logical operations on one another (AND, OR), 
and that can be added and subtracted from each other. This 
method is also called Constructive Solid Geometry (CSG). 
Because of its mathematical nature, CSG uses little 
memory, but requires lots of processing power to compute. 


See also 


The Wikipedia page about metaballs. 


Type 


Reference 


Mode: Edit Mode 

Panel: Sidebar region > Transform panel > Type, 
Metaball tab >» Active Element panel > 
Type 


Blender has five types of metas, each determined by its 
underlying (or directing) structure. 


In Edit Mode, you can change this structure, either using the 
relevant buttons in the Active Element panel, or the selector 
in the Transform panel in the Sidebar region. Depending on 
the structure, you might have additional parameters, 
located in both Transform panel and Active Element panel. 


Ball (point, zero-dimensional structure) 
This is the simplest meta, without any additional setting. 
As it is just a point, it generates an isotropic field, 
yielding a spherical surface (this is why it is called Meta 
Ball or Ball in Blender). 


Capsule (straight line, one-dimensional structure) 
This is a meta which surface is generated by the field 
produced by a straight line of a given length. This gives a 
cylindrical surface, with rounded closed ends. 


Size X 
The length of the line (and hence, of the capsule). 


Plane (rectangular plane, two-dimensional structure) 
This is a meta which surface is generated by the field 
produced by a rectangular plane. This gives a 
parallelepipedal surface, with a fixed thickness, and 
rounded borders. 


Size X/Y 
The length and width of the rectangle. 


Ellipsoid (ellipsoidal volume, three-dimensional structure) 


This is a meta which surface is generated by the field 
produced by an ellipsoidal volume. This gives an 
ellipsoidal surface. 


Size X/Y/Z 
The length, width and height of the ellipsoid. 


Cube (parallelepipedal volume, three-dimensional structure) 
This is a meta which surface is generated by the field 
produced by a parallelepipedal volume. This gives a 
parallelepipedal surface, with rounded edges. 


Size X/Y/Z 
The length, width and height of the parallelepiped. 


Primitives 


Reference 

Mode: Object Mode and Edit Mode 
Menu: Add > Metaball 

Shortcut: Shift-A 


There are five predefined metaball “primitives” (or 
configurations) available in the Add >» Metaball submenu: 


The five Metaball primitives. 


Options 


Primitive 
Ball 
Adds a meta with a point underlying structure. 


Capsule 
Adds a meta with a line segment underlying structure. 


Plane 

Adds a meta with a planar underlying structure. 
Ellipsoid 

Adds a meta with an ellipsoidal underlying structure. 


Cube 


Adds a meta with a volumetric cubic underlying 
structure. 


See also 


A more detailed explanation of each primitive in the 
Structure page. 


Radius, Align to View, Location, Rotation 
See Common Object Options. 


Editing 


In addition to having several meta objects in a same family, 
you can also have several meta primitives in a single object 
(just add some more while in Edit Mode). Each will be an 
element, with its own shape, editing rings (in the viewport), 
and settings. 


Deleting Elements 


Reference 


Shortcut: X, Delete 


You can only delete the active element, no fancy options 
here. 


Conversion 


To convert the meta to a real mesh, use Convert in Object 
Mode. 


Object Families 


A “family” is a way to regroup several meta objects, 
producing something very similar to having several metas 
inside the same object. 


It is defined by the left part of an object’s name (the one 
before the first dot). Remember, an object’s name is the one 


in the Object Name field, in most panels, not the Metaball 
Name field, which is the meta data-block’s name... For 
example, the family part of “MetaPlane.0O1” is MetaPlane. 
Each meta object in the same “family” is associated with 
one another as discussed below. 


Metaball family. 


Families of metas are controlled by a base meta object 
which is identified by an object name without a dot in it. 
For example, if we have three metas called MetaThing, 
MetaThing.001, MetaThing. round, the base meta object would be 
MetaThing. 


The base meta object determines the basis, the resolution, 
the threshold, and the transformations. It also has the 
material and texture area. In a way, the base meta is the 
“owner” of the other metas in the family (i.e. it is as if the 
other metas were “included” or joined into the base one). 


Hint 


When working with multiple scenes, take care naming your 
meta objects so the base is always in the same scene as 
other metas. 


Failing to do so will give confusing behaviors (like invisible 
meta objects). 


Examples 


Fig. Meta ball base. shows the base meta labeled “B”. The 
other two Meta objects are children. Children’s selection 
rings are always black, while the group’s mesh is orange. 
Because the metas are grouped, they form a unified mesh 
which can always be selected by selecting the mesh of any 


meta in the group. 


Meta ball base. 


For example, in Fig. Meta ball base., only the lower sphere 
(the parent) has been selected, and you see that both the 


parent’s mesh and all of the children’s meshes are now 
highlighted. 


Scaling the “base”. 


The base meta object controls the polygonalization (mesh 
structure) for the group, and as such, also controls the 
polygonalization for the children (non-base) metas. If we 
transform the base meta, the children’s polygonalization 
changes. However, if we transform the children, the 
polygonalization remains unchanged. 


Hint 


This discussion of “polygonalization” does not mean that 
the various meshes do not deform towards or away from 
each other (meta objects always influence one another in 
the usual way, within a same family). 


Rather, it means that the underlying mesh structure 
changes only when the base object transforms. For 
example, if you scale the base, the children’s mesh 
structure changes. 


In Fig. Scaling the “base”., the base has been scaled down, 
which has the effect of scaling the mesh structure of each 
of the children. As you can see, the children’s mesh 
resolution has increased, while the base decreased. The 
children did not change size! 


Properties 


All meta objects of a same family in a scene interact with 
each other. The settings in the Metaball section apply to all 
meta objects of the active family. In Edit Mode, the Active 


Element panel is shown for editing individual metaball 
elements. 


Metaball 


Reference 
Mode: Object and Edit Mode 
Panel: Properties >» Metaball » Metaball 


¥ Metaball 


Resolution Viewport 


Render 
Influence Threshold 


Update on Edit 


Family meta properties. 


Resolution Viewport 


Controls the resolution of the resultant mesh as 
generated by the Meta objects. The 3D Viewport 
resolution of the generated mesh; finest to coarsest. 


Render 


The rendered resolution of the generated mesh; finest to 
coarsest. 


Tip 


One way to see the underlying mathematical structure is 
to lower the Resolution, increase the Threshold and set the 
Stiffness (see below) a fraction above the Threshold. Fig. 
Underlying structure. is a meta cube with the above 
mentioned configuration applied as follows: Resolution of 
0.410, Threshold of 5.0 and Stiffness a fraction above at 
5.01. 


Underlying 


ee Meta cube shape. 


You can clearly see the underlying cubic structure that 
gives the meta cube its shape. 


Influence Threshold 
Defines how much a meta’s surface “influences” other 
metas. It controls the field level at which the surface is 
computed. The setting is global to a group of Meta 
objects. As the threshold increases, so does the influence 
that each meta has on each other. 


There are two types of influence: positive or negative. 


Update on Edit 


While transforming metas (move, scale, etc.), you have 
four “modes” of visualization. 


This should help you if you experience difficulties (metas 
are quite computationally intensive...), but with modern 
computers, this should not happen, unless you use many 
metas, or very high resolutions... 


Always: Fully display the meta during 
transformations. 

Half: During transformations, display the 
meta at half its Viewport resolution. 

Fast: Do not display meta during 
transformations. 

Never: Never show meta mesh (not a very 


recommended option, as the meta is 
only visible at render time!). 


Active Element 


Reference 
Mode: Edit Mode 
Panel: Properties >» Metaball » Active Element 


Y Active Element 


These settings apply only to 


the selected metaball Type © Ball 

element. Stiffness 2.000 
Radius 2m 

Ty p e Negative 


Hide 


Changes the primitive 
shape of the meta 
object. Active Element panel. 


Stiffness 
Controls the influence range for individual metaball 
elements, unlike /nfluence Threshold which controls the 
influence for the entire meta family. This essentially 
defines how sensitive a meta is to being affected by 
other metas. With a low stiffness, the meta will begin to 
deform from further away. A higher value means the 
meta needs to be close to another one to begin merging. 
The Stiffness is visualized by the green ring and can be 
selected and scaled to also change the Stiffness value. 


To be visible, the Stiffness must be slightly larger than 
the Threshold value. 


The left meta ball, has a smaller Stiffness value 
than the right one. 


Radius 
Controls the physical size of the metaball. This works the 
same as scaling the metaball in Object Mode. The Radius 
is visualized by the white ring and can be selected and 
scaled to also change the Radius value. 


Negative 
Controls whether the influence is positive or negative. 


A positive influence is defined as an attraction, meaning 
that the meshes will stretch towards each other as the 

rings of influence intersect. The opposite effect would be 
a negative influence where the objects repel each other. 


Note 

If a metaball has Negative influence the meta is not 
visible in the 3D Viewport, only the surrounding circles 
are shown. 


Negative influence 
of a meta ball; the 
first is negative 
and the second 
positive. 


Positive influence 
of three metaballs. 


Hide 
As in Show/Hide in Object Mode, you can hide the 
selected meta(s), and then reveal what was hidden. This 
is very handy for cleaning your views up a bit. 


Note 


e Hiding a meta does not only hide it, but also 
disables it from the meta computation, which will 


affect the final geometry. 

e The two red and green rings always remain visible 
in Edit Mode, as well as the select circle in Object 
Mode. 
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Introduction 


Reference 
Mode: Edit Mode 
Menu: Add >» Text 


Text objects contain some text, and are in the same object 
type family as curves and surfaces ones, as fonts are 
vectorial data (they are made of curves). 


Blender uses a “Font System” to manage mapping letter 
codes to geometry representing them in the 3D Viewport. 
This font system has its own built-in font, but it can use 
external fonts too, including PostScript Type 1, OpenType 
and TrueType fonts. And moreover, it can use any objects 
existing in the current blend-file as letters. 


OpensSans Font 


An example of an extruded text. 


Text objects allow you to create and render 2D or 3D text, 
with various advanced layout options, like justifying and 


frames. By default, letters are just flat filled surfaces, 
exactly like any closed 2D curve. But, just like curves, you 
can extrude them, and apply modifiers to them (e.g. to 
make them follow a curve). 


Text in Blender can be laid out in some relatively advanced 
ways, defining columns or blocks of text, using different 
alignments, and so on. 


Those features are similar in concept to what you can find in 


currently. 

Tip 

You can convert a text object, either to a curve, or directly 
to a mesh, using Convert in Object Mode. 

Note 


A maximum of 50,000 characters is allowed per text 
object. However, be forewarned that the more characters a 
single text object has, the slower the object will respond 
interactively. 


Selecting 


Text in Edit Mode. 


In Edit Mode, your text has a white cursor, and as in any 
text editor, it determines where new chars will be inserted. 


Select All ctr1l-A 
Selects the full text. 


Next/Previous Character Left/ Right 
You can move the cursor with the arrow keys. 


Next/Previous Word Ctrl-Left/ Ctrl-Right 
To move the cursor on a word’s boundary. 


Line Begin/End Home/ End 
Move the cursor to the beginning and end of a line 
respectively. 


Next/Previous Line Up/ Down 
To jump between lines. 


Next/Previous Block PageUp/ PageDown 
To jump back/forward ten lines at a time. 


Hold shift while using the arrow keys to select a part of the 
text. You can use it to specify different materials, the 
normal/bold/italic style... 


Editing 


Editing text is quite different from other object types in 
Blender, and happens mainly in two areas. First, the 3D 
Viewport, where you type your text, and have a few 
Shortcuts, e.g. for applying styles (see Font) - note however, 
that most Blender shortcuts you know in Edit Mode do not 
exist for texts. The second place is the Properties, especially 
the Font tab. 


Text 

Reference 

Mode: Edit Mode 

Menu: 3D Viewport > Text 


Editing text objects is similar to using a standard text editor 
but is not as full-featured and has some differences. The 
menu of the 3D Viewport header offers few options. You 
have no transform nor mirror tools, and so on. To leave Edit 
Mode use Tab as it does not insert a tab character in the 
text, but rather enters and exits Edit Mode, as with other 
object types. 


Cut Ctrl-x 
To cut and copy text to the buffer, use the shortcut or the 
matching entry in the Edit menu. 


Copy Ctrl-c 
To copy text to the buffer, use the shortcut or the 
matching entry in the Edit menu. 


Paste Ctrl-vV 


To paste text from the buffer, use the shortcut or the 
matching entry in the Edit menu. 


Paste File 


Inserts text from and external text file. This will bring up 
a File Browser for navigating to a valid UTF-8 file. As 
usual, be careful that the file does not have too many 
characters, as interactive response will slow down. 


To Uppercase 
Changes the case of the selected text to uppercase. 


To Lowercase 
Changes the case of the selected text to lowercase. 


Special Characters 


This is a limited character map to insert characters which 
aren’t available from the keyboard. Many other special 
characters can be “composed”, see Accent Characters. If 
you need others, you will have to copy-paste them from 
an external editor or character map program. 


Note 


The text buffer is in sync with the desktop clipboard. 
But if it is used within Blender the text formatting will 


be copied as well. For other ways of inserting a text, see 
Inserting Text. 


Toggle Bold, Italics, Underline, Small Caps 
To apply the Bold, Italics, Underline or Small Caps 
attribute to a set of characters, you either turn on the 
related setting prior to typing characters, or select 


existing text, and then toggle desired style from the 
menu. 


Warning 

Blender’s Bold and Italic buttons do not work the same 
way as in other applications, as they also serve as 
placeholders for you to load up other fonts manually. 


Kerning 
Font kerning is the space between individual characters. 


Decrease Kerning Alt-Left 
Decreases the spacing between the characters on 
either side of the cursor. 


Increase Kerning Alt-Right 
Increase the spacing between the characters on either 
side of the cursor. 


Reset Kerning 
Sets the spacing between the characters on either 
side of the cursor to their initial value. 


Delete 
Previous/Next Character 
Deletes the character before or after the cursor. 


Previous/Next Word 
Deletes the word before or after the cursor. 


Inserting Text 


You can insert text in two ways: from the internal text buffer 
(as described above), or from a text file. 


Using an existing text data-block, you can convert it to an 
object from the Text editor’s header, select Edit >» Text to 3D 


Object, One Object or One Object per Line depending on 
your needs. 


It is also possible to paste from the clipboard or a file from 
the Edit menu, while editing 3D text. 


Accent Characters 


Many special characters (Such as accented chars, which are 
not directly available on your keyboard) can be “composed” 
using a combination of two other characters. To do so, type 
the main char, press Alt-Backspace, and then press the 
desired “modifier” to produce the special character. Some 
examples are given below: 


e a: A, Alt-Backspace, ~ e @: 0, Alt-Backspace, / 
e a: A, Alt-Backspace,'  ¢ §: 5S, Alt-Backspace, S 
e a: A, Alt-Backspace, \_« Tt: |, Alt-Backspace, - 
e a: A, Alt-Backspace, * +: |, Alt-Backspace, = 
° a: A, Alt-Backspace,0 © ©: 0, Alt-Backspace, C 
e 2: A, Alt-Backspace,E e¢ ®: 0, Alt-Backspace, R 
e 9: A, Alt-Backspace, - e ™:T, Alt-Backspace, M 
e @: E, Alt-Backspace, " e 44: 1, Alt-Backspace, 2 
e ¢: C, Alt-Backspace, , e +: -, Alt-Backspace, : 
e ¢: C, Alt-Backspace, | e +: -, Alt-Backspace, + 


Converting to a Mesh or Curve 


In Object Mode, it is possible to convert a text object to a 
mesh or curve one, see Convert. 


Tip 


The topology of the result is usually a bit messy, so it may 
be useful to use a Limited Dissolve deletion, or apply a 
Remesh modifier at a low threshold, to clean up your 
mesh. 


Assigning Materials 


Reference 
Mode: Edit 
Panel: Properties >» Materials 


Each character can have a different Material index in order 
to have different materials on different characters. 


You can assign indices either as you type, or after by 
selecting blocks of text and clicking on the Assign button in 
the Materials panel. 


Red Green Blue text example. 


Properties 


Shape 


Reference 
Mode: All Modes 
Panel: Properties » Text >» Shape 


Most of the settings in the Shape panel are shared with those 
of Curves data-blocks, please refer to those for details. 


Fast Editing 
Does not fill the letters in Edit Mode, only show their 
outline. 


Texture Space 


Each Object can have an automatically generated UV map, 
these maps can be adjusted here. 


See Generated UV Properties for more information. 


Geometry 

Reference 

Mode: All Modes 

Panel: Properties » Font » Geometry 


Offset 


Offset the control points of the curves defining the letters, 
which will make them thinner or thicker. Use with care, it 
can quickly lead to artifacts... 


Extrusion, Taper & Bevel 


The remaining settings of that panel, which are used to give 
volume to the letters, are also shared with the Curves data- 
blocks, please refer to those for details. 


Note 


How the Taper object effect works depends on how the 
curves defining the letters are built. The results can often 
look quite random... 


Note 


Bevel is applied to the curves defining the letters, which 
means that usually it will follow their outlines (there will be 
two parallel beveled curves, and not a single one, as one 
might expect). 


Font 

Reference 

Mode: All Modes 

Panel: Properties » Font >» Font 


Blender comes with a built-in font by default that is displayed 
in each of the four font style data-block menus. The built-in 
font is always present and shows in this list as “Bfont”. The 


data-block menu contains a list displaying the currently 
loaded fonts. Select one for each font style. 


To load a different Font, click one of the Load buttons in the 
Font panel and navigate to a font file. The File Browser will 
give all valid fonts a capital “F” icon. 


If you select a font that is unsupported by Blender, you will 
get the error Not a valid font. 


Note 
Location of Fonts on Unix 


Fonts are typically located under /usr/lib/fonts, or some 
variant like /usr/lib/X11/fonts, but not always. They may be 
in other locations as well, such aS /usr/share/local or 
/usr/local/share, and possibly related sub-trees. 


Remember that the same font will be applied to all chars with 
same style in a text, but that a separate font is required for 
each style. For example, you will need to load an Italics font 
in order to make characters or words italic. Once the font is 
loaded you can apply that font “Style” to the selected 
characters or the whole object. In all, you would need to load 
a minimum of four different types of fonts to represent each 
style (Normal, Italics, Bold, Bold & Italics). 


It is important to understand, that Blender does not care 

what font you load for “normal”, “bold”, etc., styles. This is 
how you can have up to four different fonts in use in the 
same text, but you have to choose between different styles of 
a same font, or different fonts. Blender has a number of 
typographic controls for changing the style and layout of text, 
found in the Font panel. 


Bold 
Toggled with the Bold button before typing. Text can also 
be set to bold by selecting it then using the Bold entry in 
the Text menu of the 3D Viewport. 


Italics 
Toggled with the /talic button before typing. Text can also 
be set to italic by selecting it then using the /talic entry in 
the Text menu of the 3D Viewport. 


Underline 
Enables underlining, as controlled by the underline 
settings below. 


Small Caps 
Enable this option to type characters as small caps. 


The size of the Smal! Caps can be changed with the Small 
Caps Scale setting. 


Transform 


Size 
Controls the size of the whole text (no way to control each 
char size independently). Note however, that chars with 
different fonts (different styles, see below) might have 
different visible sizes. 


Shear 
Controls the inclination of the whole text. As similar as it 
may seem, this is not the same thing as italics style. 


Shear example. 


Object Font 
Allows individual objects to be used to render fonts, you 
can create/model your own complex font inside Blender! 
This field is used to select the objects prefix name (object 
“family”) to be used to locate the individual characters 
used for typing. This is quite a complex process, so here 
are detailed steps to follow: 


1. Create the font characters, each character can be any 
object type (mesh, curve, etc.). They must all have a 
name following the naming schema: “common prefix” 
followed by the “character name” (e.g. “ft.a”, “ft.b”, 
etc.). 

2. For the text object, enable Instancing Vertices. 

3. In the Font tab, fill the Object Font field with the 
“common prefix” of your “font” objects. Now, each 
time a character in your text matches the suffix part of 
a “font” object’s name, this object is duplicated on this 
character. 


Note 


The objects are duplicated so that their center is 
positioned at the lower right corner of the corresponding 
characters. 


Text on Curve 


Select a curve object for the text object to follow. 


Text on curve. 


Tip 
You should rather use the Curve modifier, which offers 


more control, and is the standard way to achieve such 
effects in modern Blender. 


Underline 
Toggled with the Underline button before typing. Text can 
also be set to Underlined by selecting it then using the 
Underline entry in the Text menu of the 3D Viewport. 


Underline Position 
This allows you to shift vertically the position of the 
underline. 


Underline Thickness 
This controls the thickness of the underline. 


Small Caps Scale 
The scaling applied to capital letters to turn them into 
Small caps. 


Paragraph 


Reference 
Mode: All 
Panel: Properties » Font >» Paragraph 


The Paragraph Panel has settings for the alignment and 
Spacing of text. 


¥ Alignment 


Horizontal 


Vertical 


¥ Spacing 


Character Spacing 


Word Spacing 


Line Spacing 


Offset X 


Y 


The Paragraph panel. 
Alignment 


Horizontal Alignment 


Left: Aligns text to the left of the frames when 
using them, else uses the origin of the 
text object as the starting point of the 
text (which grows to the right). 

Center: Centers text in the frames when using 
them, else uses the origin of the text 
object as the mid-point of the text 
(which grows equally to the left and 
right). 


Right: 


Justify: 


Flush: 


Note 


Aligns text to the right of the frames 
when using them, else uses the origin of 
the text object as the ending point of the 
text (which grows to the left). 

Only flushes a line when it is terminated 
by a word wrap (not by a newline), and 
uses whitespace instead of character 
spacing (kerning) to fill lines. 

Always flushes the line, even when it is 
still being typed-in. It uses character 
Spacing (kerning) to fill lines. 


Both Justify and Flush only work within frames. 


Vertical Alignment 
Top Baseline: 


Top: 


Center: 


e With text boxes, aligns the ‘top’ baselins 
of the text to the top of the frames. 

e With no text box, aligns the actual 
baseline of the text to the origin of the 
object, and grows to the bottom. 


Note 

That difference of reference point in 
the first line depending on usage of 
boxes or not is indeed confusing. 


e With text boxes, aligns the top of the 
text to the top of the frames. 

e With no text box, aligns the top of the 
text to the origin of the object, and 
grows to the bottom. 


Bottom: 


Bottom Baseline: 


Spacing 


Character Spacing 


With text boxes, centers the text in the 
frames. 

With no text box, centers the text on the 
origin of the object, and grows in both 
top and bottom directions equally. 


With text boxes, align the bottom of the 
text to the bottom of the frames. 

With no text box, align the bottom of th: 
text to the origin of the object, and 
grows to the top. 


With text boxes, aligns the baseline of 
the text to the bottom of the frames. 
With no text box, aligns the baseline of 
the text to the origin of the object, and 
grows to the top. 


A factor by which space between each character (kerning) 


is scaled in width. 


In Edit Mode in the 3D Viewport, you can also control 
individual kerning at text cursor position by pressing Alt- 
Left / Alt-Right to decrease/increase it. 


Word Spacing 


A factor by which whitespace between words is scaled in 


width. 


Line Spacing 


A factor by which the vertical space between lines is 


scaled. 


Offset X, Y 
These settings control the X and Y offset of the text 
position within the object. This applies relatively to the 
object’s origin, either to the whole text or, when using text 
boxes, to each frame. 


Text Boxes 


Reference 
Mode: All 
Panel: Properties » Font » Text Boxes 


Text boxes (or frames) allow you to distribute the text among 
rectangular areas within a single text object. An arbitrary 
number of freely positionable and re-sizable text frames are 
allowed per text object. 


The text flows continuously from the lowest-numbered frame 
to the highest-numbered frame with text inside each frame 
word-wrapped. It flows between frames when a lower- 
numbered frame cannot fit any more text. If the last frame is 
reached, text overflows out of it (by default, see options 
below). 


¥ Text Boxes 


ar Add Textbox 


Overflow 


Text Boxes panel. 


Add Textbox 


Inserts a new frame, just after the current one (in text flow 
order). The new frame will have the same size and 
position as the selected one. 


Delete x 
Delete the current frame. 


Overflow 


How to handle text overflowing available space in the 
defined boxes. 


Overflow: Just keep text running out of the last 
box. 

Scale to Fit: Scale text to fit into the available space. 

Truncate: Hide the end of the text that does not fit 


into the available space. 


Note 

It will only truncate in Object Mode, in 
Edit Mode the whole text remains 
visible (and overflows as needed). 


Size X, Y 
Specifies the width and height of the text box, if set to 
zero no word wrapping happens (it is ignored, and the 


whole text box system is disabled if all are set to a null 
size). 


Offset X, Y 
Controls the X and Y offset of the frame, i.e. its position. 


Lorem DSL N exercitation 
dolor sit t, ullamco laboris 


nisi ut aliquip ex 


cons 
idipisc ing elit, sed ea commodo 
do eiusmod consequatl 


tempor incididunt 
ut labore et 
dolore magna 
uliqua. Ut enim ad 
minim veniam, 
quis nostrud 


Multiple columns, text flowing between boxes. 
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Introduction 


Volume objects are containers used to represent OpenVDB 
files in Blender. OpenVDB is a library and file format for the 
interoperability and storage of volumetric data. OpenVDB 
files may be generated by other software such as Houdini, 
or from Blender’s fluid simulation cache. 


Volume objects can be created from the Add menu in the 3D 
Viewport, or by dragging and dropping vdb-files into 
Blender. For animations, a frame sequence of OpenVDB files 
can be imported. 


Workbench, and Cycles. 


Rendering 


Rendering volumes works the same as rendering smoke 
simulations. By default, the Principled Volume shader is 
used for rendering volume objects. It will use grids named 
density, color and temperature by default. If these are not 
available, another grid name must be chosen in the shader 
nodes. 


Limitations 


e OpenVDB excels at representing sparse volumes, that 
aren’t necessarily concentrated within a tight bounding 
box but may be spread out through space. However, in 
Blender, these are still rendered as dense volumes 
which is not ideal for performance and memory usage. 
This will be improved in future releases. 

e OpenvVDB files can also store level sets and points. 
While level set grids can be read, there is no current 
Support for rendering them as surfaces. Importing 
OpenVDB points is not supported. 


Properties 
Grids 


OpenVDB can contain multiple grids which represent 
different “layers” of volume. The List View shows all the 
grids in the OpenVDB-file along with its name and data type. 


OpenVDEB File 


File Path 
Volume sample file used by the volume data-block. 


Sequence 
Loads the OpenVDB-file as an animation loading separate 
files for individual frames. 


Frames 
Number of frames of the sequence to use. 


Start 
Global starting frame of the sequence, assuming the 
first frame has a 1 in the file name. 


Offset 
Offset the number of the frame to use in the 
animation. 


Mode 
Animation setting of the volume sequence before the 
start frame and after the end frame. 


Clip: Hides frames outside the specified 
frame range. 

Extend: Repeats the start frame before, and 
the end frame after the frame 
range. 

Repeat: Cycles the frames in the sequence; 
restarting at frame one. 

Ping-Pong: Repeats the frames, reversing the 
playback direction on every other 
cycle. 


Viewport Display 


Wireframe 
Method used to represent volumes in wireframe shading 
mode. For heavy volume data sets, it can be useful to set 
the object to always display as wireframe. This way the 
3D Viewport remains responsive but the volume still 
appears in the final render. 


None: The volume is not displayed in 
wireframe mode. 

Bounds: Displays the volume as Bounding Box 
for the entire volume grid. 

Boxes: Displays a bounding boxes for nodes in 
the volume tree. 

Points: Displays points for nodes in the volume 
tree. 

Detail 


The amount of detail to display for Boxes or Points 
wireframe mode. 


Coarse: Display one box or point for each 
intermediate tree node. 


Fine: Display a box or point for each leaf 
node containing 8x8 voxels. 


Density 
Thickness of the volume in the 3D Viewport. The density 
of the volume in the render is adjusted via Volume 
Shading. 


Interpolation 
Interpolation method to use for the visualization of the 
fluid grid. 


Linear: Linear interpolation between voxels. 
Gives good smoothness and speed. 
Cubic: Cubic interpolation between voxels. 


Gives smoothed high quality 
interpolation, but is slower. 

Closest: No interpolation between voxels. Gives 
raw voxels. 


Slice 


Renders only a single 2D section of the domain object. 


Axis 
Auto: Adjust slice direction according to the 
view direction. 
X/Y/Z: Slice along the X, Y, or Z axis. 
Position 


Position of the slice relative to the length of the 
respective domain side. 


Render 


Space 
Specifies how volume density and step size are 
computed relative either to the object or world. 


Object: Keeps volume Density and Detail the 
same regardless of object scale. 

World: Specify Step Size and Density in world 
space. 


Step Size Cycles Only 
Distance between volume samples. Lower values render 
more detail at the cost of performance. If set to zero, the 
step size is automatically determined based on voxel 
size. 


Clipping Cycles Only 
Value under which voxels are considered empty space to 
optimize rendering. 


Precision Cycles Only 
Specifies volume data precision, lower values reduce 
memory consumption at the cost of detail. 


Full: Full float (Use 32 bit for all data). 
Half: Half float (Use 16 bit for all data). 
Variable: Automatically vary the precision and 


use less precision for less noticeable 
areas. 


Empties 


The “empty” is a single coordinate point with no additional 
geometry. Because an empty has no volume and surface, it 
cannot be rendered. Still it can be used as a handle for 
many purposes. 


Primitives 


Single Arrow 


Sphere 


Plain Axes 


Empty Display Types. 


Plain Axes 


Displays as six lines, initially with one pointing in each of the 
+X, -X, +Y, -Y, +Z, and -Z axis directions. 


Arrows 


Displays as arrows, initially pointing in the positive X, Y, and 
Z axis directions, each with a label. 


Single Arrow 


Displays as a Single arrow, initially pointing in the +Z axis 
direction. 


Circle 

Displays as a circle initially in the XZ plane. 

Cube 

Displays as a cube, initially aligned to the XYZ axes. 
Sphere 


Displays as an implied sphere defined by three circles. 
Initially, the circles are aligned, one each, to the X, Y, and Z 
axes, 


Cone 
Displays as a cone, initially pointing in the +Y axis direction. 
Image 


Empties can display images. This can be used to create 
reference images, including blueprints or character sheets 


to model from. The image is displayed regardless of the 3D 
display mode. 


Empty Displays settings can be accessed from Properties > 
Object Data > Empty panel. 


Offset X, Y 


Offset the image origin (where 1.0 represents the 
width/height of the image). 


X=0.5, Y=0.5: Object origin at image center. 
X=0.0, Y=0.0: Object origin at image bottom, left. 
X=1.0, Y=1.0: Object origin at image top, right. 


Depth 
Default: Use normal depth behavior. 
Front: Always display on top of other objects. 
Back: Always display behind of other objects. 
Tip 


When using the image as a reference for modeling, it 


can be useful to set the depth to Front, with a low 
Opacity. 


Side 
Both: Display both the front and back of the 
empty. 
Front: Only display the front of the image. 
Back: Only display the back of the image. 
Tip 


This is useful if you are using an image as a reference 
where you have photos from both the front and back, so 
two empty images can be set only to show when 
viewed from the correct side. 


Show in 
Orthographic 
Show in orthographic view. 


Perspective 
Show in perspective view. 


Hint 
It’s often useful to disable this so reference images 
don’t get in the way when viewing a model. 


Only Axis Aligned 
Only displays the image contents when the view is 
aligned with the object’s local axis. 


Opacity 
Blends the image with the background. The value slider 
adjusts the opacity of the image, changing how much of 
the image is blended with the background. 


Editing 


An empty can only be edited in Object Mode, which includes 
its transformation and parenting properties. For other tools 
see the Object section. 


Apply Scale ctrl-a 
While empties don’t exactly have any object data 
attached to them which can be used for supporting 
“true” apply scale (i.e. with non-uniform scaling), they do 
have Display Size which controls how large the empties 
are displayed (before scaling). This works by taking the 
scale factor on the most-scaled axis, and combines this 


with the existing empty Display Size to maintain the 
correct dimensions on that axis. 


Properties 


Display As 
The Primitives empty type to display in the 3D Viewport. 


Size 


Controls the size of the empties visualization. This does 
not change its scale, but functions as an offset. 


Usage 


Empties can serve as transform handles. Some examples of 
ways to use them include: 


Parent object for a group of objects 


An empty can be parented to any number of other objects. 
This gives the user the ability to control a group of objects 
easily, and without affecting a render. 


Target for constraints 


An empty can also be used as a target for normal, or bone 
constraints. This gives the user far more control; for 
instance, a rig can easily be set up to enable a camera to 
point towards an empty using the Track to constraint. 


Array offset 


An empty can be used to offset an Array Modifier, meaning 
complex deformations can be achieved by only moving a 


single object. 


An example of an 
empty being used to 
An example of an control the Track To 
empty being used to constraint. 

control an array. 


Other common uses: 


Placeholders 
Rigging controls 
DOF distances 
Reference Images 


Modifiers 


Introduction 
o Interface 
o Example 
Common Modifier Options 
o Vertex Group 
o Texture 


Modify 


Data Transfer Modifier 

Mesh Cache Modifier 

Mesh Sequence Cache Modifier 
Normal Edit Modifier 

UV Project Modifier 

UV Warp Modifier 

Vertex Weight Edit Modifier 
Vertex Weight Mix Modifier 
Vertex Weight Proximity Modifier 
Weighted Normal Modifier 


Generate 


Array Modifier 

Bevel Modifier 

Boolean Modifier 

Build Modifier 

Decimate Modifier 

Edge Split Modifier 
Geometry Nodes Modifier 


Mask Modifier 

Mesh to Volume Modifier 
Mirror Modifier 
Multiresolution Modifier 
Remesh Modifier 

Screw Modifier 

Skin Modifier 

Solidify Modifier 
Subdivision Surface Modifier 
Triangulate Modifier 
Volume to Mesh Modifier 
Weld Modifier 
Wireframe Modifier 


Deform 


Armature Modifier 

Cast Modifier 

Curve Modifier 

Displace Modifier 

Hook Modifier 

Laplacian Deform Modifier 
Lattice Modifier 

Mesh Deform Modifier 
Shrinkwrap Modifier 
Simple Deform Modifier 
Smooth Modifier 

Smooth Corrective Modifier 
Smooth Laplacian Modifier 
Surface Deform Modifier 
Volume Displace Modifier 
Warp Modifier 

Wave Modifier 


Physics 


Cloth Modifier 

Collision Modifier 
Dynamic Paint Modifier 
Explode Modifier 

Fluid Modifier 

Ocean Modifier 

Particle Instance Modifier 
Particle System Modifier 
Soft Body Modifier 


Introduction 


Modifiers are automatic operations that affect an object’s 
geometry in a non-destructive way. With modifiers, you can 
perform many effects automatically that would otherwise be 
too tedious to do manually (such as subdivision surfaces) 
and without affecting the base geometry of your object. 


They work by changing how an object is displayed and 
rendered, but not the geometry which you can edit directly. 
You can add several modifiers to a single object to form 

and Apply a modifier if you wish to make its 
changes permanent. 
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Modifiers menu. 


They can be added to the active object using the Add 
Modifier drop-down menu at the top of their properties tab. 
New modifiers are always added at the bottom of the stack 
(i.e. will be applied last). 


There are four categories of modifiers: 


Modify 
These are tools similar to the Deform ones (see below), 
however, they usually do not directly affect the geometry 
of the object, but some other data, such as vertex 
groups. 


Generate 
These are constructive/destructive tools that will affect 
the whole Topology of the mesh. They can change the 
general appearance of the object, or add new geometry 
to it... 


Deform 
Unlike Generate ones above, these only change the 
shape of an object, without altering its topology. 


Simulate 
Those represent physics simulations. In most cases, they 
are automatically added to the modifiers stack whenever 
a Particle System or Physics simulation is enabled. Their 
only role is to define the position in the modifier stack 
from which is taken the base data for the simulation they 
represent. As such, they typically have no attributes, and 
are controlled by settings exposed in separate sections of 
the Properties. 


Interface 
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Panel layout (Subdivision Surface as an example). 


Each modifier’s interface shares the same basic 
components, see Fig. Panel layout (Subdivision Surface as 
an example).. 


At the top is the panel header. The icons each represent 
different settings for the modifier (left to right): 


Expand (down/right arrow icon) 
Collapse modifier to show only the header and not its 
options. 


Type 
An icon as a quick visual reference of the modifier’s type. 


Name 
Every modifier has a unique name per object. Two 
modifiers on one object must have unique names, but 
two modifiers on different objects can have the same 
name. The default name is based on the modifier type. 


Show on Cage (vertices triangle icon) - Meshes only 
Depends on the previous setting, if enabled, the modified 
geometry can also be edited directly, instead of the 


Original one. 


Warning 


While it shows edited items in their final, modified 
positions, you are still actually editing original data. This 
can lead to strong and unpredictable effects with some 
tools, and should be disabled whenever you need to 
perform complex or precise editing on the mesh. 


Show in Edit Mode (vertices square icon) 
Display the modified geometry in Edit Mode, as well as 
the original geometry which you can edit. 


Show in Viewport (Screen icon) 
Toggle visibility of the modifier’s effect in the 3D 
Viewport. 


Render (camera icon) 
Toggle visibility of the modifier’s effect in the render. 


Note 


The Square, Triangle and Surface icons may not be 
available, depending on the type of object and modifier. 


Apply On Spline Points (point surface icon) - Curves, 
surfaces and texts only 
Apply the whole modifier stack up to and including that 
one on the curve or surface control points, instead of 
their tessellated geometry. 


Note 


By default, curves, texts and surfaces are always 
converted to mesh-like geometry before that the 


modifier stack is evaluated on them. 


Extras 
Apply ctri-A 
Makes the modifier “real”: converts the object’s 


geometry to match the applied modifier’s results, and 
deletes the modifier. 


When applying a modifier to an object that shares 
Object Data between multiple objects, the object must 
first be made a Single User which can be performed 
by confirming the pop-up message. 


Warning 


Applying a modifier that is not first in the stack will 
ignore the stack order (it will be applied as if it was 
the first one), and may produce undesired results. 


Apply as Shape Key 
Stores the result of that modifier in a new relative 
shape key and then deletes the modifier from the 
modifier stack. This is only available with modifiers 


that do not affect the topology (typically, Deform 
modifiers only). 


Note 


Even though it should work with any geometry type 


that supports shape keys, currently it will only work 
with meshes. 


Save as Shape Key 


Stores the result of that modifier in a new relative 
shape key and keeps the modifier in the modifier 
stack. This is only available with modifiers that do not 
affect the topology (typically, Deform modifiers only). 


Duplicate Shift-D 
Creates a duplicate of the modifier just below current 
one in the stack. 


Copy to Selected 
Copies the modifier from the Active object to all 
selected objects. 


Move to First/Last 
Moves the modifier to the first or last position in the 
modifier stack. 


Delete xX, Delete 
Delete the modifier. 


Move :::: 
Move the modifier up/down in the stack, changing the 
evaluation order of the modifiers. 


Below this header, all of the options unique to each modifier 
will be displayed. 


The Modifier Stack 


Modifiers are a series of non-destructive operations which 
can be applied on top of an object’s geometry. You can be 
apply them in almost any order. This kind of functionality is 
often referred to as a “modifier stack” and is also found in 
several other 3D applications. 


In a modifier stack, the order in which modifiers are applied 
has an effect on the result. Therefore the modifiers can be 
re-arranged by clicking the grab widget (::::) in the top 
right, and moving the selected modifier up or down. For 
example, the image below shows Subdivision Surface and 
Mirror modifiers that have switched places. 


Modifier Stack example. 


The Subdivision 
Surface modifier is 


the stack and the the last item in the 


The Mirror modifier 
is the last item in 


stack and the result 
is a Single merged 
surface. 


result looks like two 
surfaces. 


Modifiers are calculated from top to bottom in the stack. In 
this example, the desired result (on right) is achieved by 
first mirroring the object, and then calculating the 
Subdivision surface. 


Active Modifier 


A modifier in the stack can be selected to mark in as Active, 
the active modifier displays an outline around the modifier’s 
panel. To set an active modifier, select an area of the 
modifier’s panel background, the modifier’s icon, or, select a 
modifier in the Outliner. 


The active modifier is used by the Geometry Node Editor to 
determine which node group is being modified. 


Example 


In this example a simple subdivided cube has been 
transformed into a rather complex object using a 
stack of modifiers. 


Download example file. 


Common Modifier Options 


Some options are commonly used by many modifiers, and 
share the same behavior across all of those. In particular, 
many offer ways to precisely mask and weight their effect 
on a vertex basis (using either vertex groups and/or 
textures). 


Vertex Group 


Vertex = 
Groups Vertex Group &#5 aS 
are an 
easy way 
to control 
which 
vertices 
are affected by a modifier, and to which extent (using their 
weights). They are available when modifying meshes or 
lattices. 


Typical modifier Vertex Group options. 


Tip 


Vertex groups can also be edited and even animated using 
the Vertex Weight modifiers. 


Vertex Group 
The vertex group name. 


Warning 


The group is referenced by its name. That means that if 
you rename it, the link to the renamed vertex group will 
be lost by all modifiers using it (their field will turn red), 
and you'll have to select the proper group again in all of 
them. 


Invert <-> 
Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 
Only available in some modifiers. 


Texture 

Those options allow Texture Mask Ey Texture er ee = 
to use any kind of Texture Coordinates: Use Channel: 

image (including via cf Hence 

parametric ones) to 

control the Typical modifier Texture options. 


modifier’s effect. 

Most of the time, 

only the value (grayscale) of the texture is used, but in 
some cases (like with some modes of the Displace modifier), 
the whole RGB color components might be exploited. 


Tip 


Textures can be animated (either using videos, or by 
animating the mapping coordinates...). 


Texture 


The texture data-block to use. 


Tip 

By clicking on the right-most button of this field (with 
the settings icon), you can go directly to the selected 
texture’s settings in the Texture Properties tab. 


Texture Coordinates 
The texture’s coordinates to get each vertex’ value: 


UV 
Take texture coordinates from face UV coordinates. 


UV Map 
The UV Map from which to take texture 
coordinates. If the object has no UV coordinates, it 
falls back to the Local coordinate system. If this 
field is blank, but there is a UV map available (e.g. 
just after adding the first UV map to the mesh), the 
currently active UV map will be used. 


Note 

Since UV coordinates are specified per face, the UV 
texture coordinate system currently determines the 
UV coordinate for each vertex from the first face 
encountered which uses that vertex. Any other faces 
using that vertex are ignored. 


This may lead to artifacts if the mesh has non- 
contiguous UV coordinates. 


Object 
Take the texture coordinates from another object’s 
coordinate system. 


Object 
The object from which to take texture coordinates. 
Moving the object will therefore alter the 
coordinates of the texture mapping. 


If this field is blank, it falls back to the Local 
coordinate system. 


Note 

Moving the original object will also result in a 
texture coordinate update. As such, if you need to 
maintain a displacement coordinate system while 
moving the modified object, consider parenting the 
coordinate object to the modified object. 


Global 


Take the texture coordinates from the global 
coordinate system. 


Local 


Take the texture coordinates from the object’s local 
coordinate system. 


Use Channel 


Which channel to use as value source (only available with 
a few modifiers currently, others follow the /ntensity 
behavior, unless otherwise specified). 


Intensity 
The average of the RGB channels (if RGB(1.0, 0.0, 0.0) 
value is 0.33). 


Red/Green/Blue/Alpha 
One of the color channels’ values. 


Hue 
The hue from the HSV color model (i.e; the color in the 
standard wheel, e.g. blue has a higher hue value than 
yellow). 


Saturation 
The saturation from the HSV color model (e.g. the 
value for pure red is 1.0, for gray is 0.0). 


Value 
The value from the HSV color model. 


Note 


All of the channels above are gamma corrected, except 
for Intensity. 


Data Transfer Modifier 


The Data Transfer modifier transfers several types of data 
from one mesh to another. Data types include vertex 
groups, UV maps, Color Attributes, custom normals... 


Transfer works by generating a mapping between source 
mesh’s elements (vertices, edges, etc.) and destination 
ones, either on a one-to-one basis, or mapping several 
source elements to a single destination one, using 
interpolation. 


Transferring normals between objects, see example 
blend-file. 


See also 


Transfer Mesh Data Operator 


Options 


Source yy! DataTransfer \7 FT iy x 
Mesh object to copy data oo. a xz 
from. 

Mix Mode Replace ve 
If the button to the right alge oa ee 
of the field is unset, both Vertex Group 5 
the source and the Generate Data Layers 
destination geometry is Sm Vers Dare 
considered in global . 
. Vertex Groups Bevel Weight 
Space when generating . 
the mapping, otherwise Mapping Nearest Vertex ve 
they are evaluated in > Vertex Groups 
local space (i.e. as if both > @ Edge Data 
object’s origins were at > Y Face Corner Data 
the same place). v @ Face Data 
Mix Mode Smooth Freestyle Mark 
' . M i N t Fi ve 
Controls how destination SIE lie te 
data are affected: Y Topology Mapping 
All Max Distance 


Ray Radius 


Replaces everything 
in destination (note 
that Mix Factor is still Data Transfer Modifier. 
used). 


Above Threshold 
Only replaces destination value if it’s above given 
threshold Mix Factor. How that threshold is interpreted 
depends on the data type, note that for Boolean 
values this option fakes a logical AND. 


Below Threshold 


Only replaces destination value if it’s below given 
threshold Mix Factor. How that threshold is interpreted 
depends on the data type, note that for Boolean 
values this option fakes a logical OR. 


Mix, Add, Subtract, Multiply 
Apply that operation, using mix factor to control how 
much of source or destination value to use. Only 
available for a few types (vertex groups, Color 
Attributes). 


Mix Factor 
How much of the transferred data gets mixed into 
existing one (not supported by all data types). 


Vertex Group 
Allows per-element fine control of the mix factor. Vertex 
group influence can be reverted using the small “arrow” 
button to the right. 


Generate Data Layers 
This modifier cannot generate needed data layers itself. 
Once the set of source data to transfer is selected, this 
button shall be used to generate matching destination 
layers, if needed. 


Selection of Data to Transfer 


To keep the size of the modifier reasonable, the kind of 
elements to be affected must be selected first (vertices, 
edges, face corners and/or faces). 


Mapping Type 
How is generated the mapping between those source and 
destination elements. Each type has its own options, see 
Geometry Mapping below for details. 


Data Types 
The left column of toggle buttons, to select which data 
types to transfer. 


Multi-layers Data Types Options 
In those cases (vertex groups, Color Attributes, UVs), one 
can select which source layers to transfer (usually, either 
all of them, or a single specified one), and how to affect 
destination (either by matching names, matching 
order/position, or, if a single source is selected, by 
specifying manually the destination layer). 


Islands Handling Refinement 
This setting only affects UV transfer currently. It allows to 
avoid a given destination face to get UV coordinates from 
different source UV islands. Keeping it at 0.0 means no 
island handling at all. Typically, small values like 0.02 are 
enough to get good results, but if you are mapping from 
a very high-poly source towards a very low-poly 
destination, you may have to raise it quite significantly. 


Usage 


First key thing to keep in mind when using this modifier is 
that it will not create destination data layers. Generate Data 
Layers button shall always be used for this purpose, once 
the set of source data to transfer has been selected. It 
should also be well understood that creating those data 
layers on destination mesh is not part of the modifier stack, 
which means e.g. that they will remain even once the 
modifier is deleted, or if the source data selection is 
modified. 


Geometry Mapping 


Geometry mapping is how a given destination mesh relates 
to a source mesh. In this process a destination 
vertex/edge/... gets a part of the source mesh assigned with 
functions as its data source. It is crucial to understand this 
topic well to get good results with this modifier. 


Topology 
The simplest option, expects both meshes to have 
identical number of elements, and match them by order 
(indices). Useful e.g. between meshes that were identical 
copies, and got deformed differently. 


One-To-One Mappings 
Those always select only one source element for each 
destination one, often based on shortest distance. 


Vertices 


Nearest Vertex 
Uses source’s nearest vertex. 


Nearest Edge Vertex 
Uses source’s nearest vertex of source’s nearest 


edge. 


Nearest Face Vertex 
Uses source’s nearest vertex of source’s nearest 


face. 


Edges 
Nearest Vertices 
Uses source’s edge which vertices are nearest from 
destination edge’s vertices. 


Nearest Edge 
Uses source’s nearest edge (using edge’s 
midpoints). 


Nearest Face Edge 
Uses source’s nearest edge of source’s nearest 
face (using edge’s midpoints). 


Face Corners 
A face corner is not a real element by itself, it’s some 
kind of split vertex attached to a specific face. Hence 
both vertex (location) and face (normal, ...) aspects 
are used to match them together. 


Nearest Corner and Best Matching Normal 
Uses source’s corner having the most similar split 
normal with destination one, from those sharing 
the nearest source’s vertex. 


Nearest Corner and Best Matching Face Normal 
Uses source’s corner having the most similar face 
normal with destination one, from those sharing 
the nearest source’s vertex. 


Nearest Corner of Nearest Face 
Uses source’s nearest corner of source’s nearest 
face. 


Faces 
Nearest Face 
Uses source’s nearest face. 


Best Normal-Matching 
Uses source’s face which normal is most similar 
with destination one. 


Interpolated Mappings 
Those use several source elements for each destination 
one, interpolating their data during the transfer. 


Vertices 
Nearest Edge Interpolated 
Uses nearest point on nearest source’s edge, 
interpolates data from both source edge’s vertices. 


Nearest Face Interpolated 
Uses nearest point on nearest source’s face, 
interpolates data from all that source face’s 
vertices. 


Projected Face Interpolated 
Uses point of face on source hit by projection of 
destination vertex along its own normal, 
interpolates data from all that source face’s 
vertices. 


Edges 
Projected Edge Interpolated 
This is a sampling process. Several rays are cast 
from along the destination’s edge (interpolating 
both edge’s vertex normals), and if enough of them 
hit a source’s edge, all hit source edges’ data are 
interpolated into destination one. 


Face Corners 


A face corner is not a real element by itself, it’s some 
kind of split vertex attached to a specific face. Hence 
both vertex (location) and face (normal, ...) aspects 
are used to match them together. 


Nearest Face Interpolated 
Uses nearest point of nearest source’s face, 
interpolates data from all that source face’s 
corners. 


Projected Face Interpolated 


Uses point of face on source hit by projection of 
destination corner along its own normal, 
interpolates data from all that source face’s 
corners. 


Faces 
Projected Face Interpolated 
This is a sampling process. Several rays are cast 
from the whole destination’s face (along its own 
normal), and if enough of them hit a source’s face, 
all hit source faces’ data are interpolated into 
destination one. 


Topology Mapping 


Max Distance 


When the “pressure stylus” icon button to the right is 
enabled, this is the maximum distance between source 
and destination to get a successful mapping. If a 
destination element cannot find a source one within that 
range, then it will get no transferred data. 


This allows to transfer a small sub-detailed mesh onto a 
more complete one (e.g. from a “hand” mesh towards a 
“full body” one). 


Ray Radius 


The starting ray radius to use when Ray Casting against 
vertices or edges. When transferring data between 
meshes Blender performs a series of ray casts to 
generate mappings. Blender starts with a ray with the 
radius defined here, if that does not return a hit then the 
radius is progressively increased until a positive hit ora 
limit is reached. 


This property acts as an accuracy/performance control; 
using a lower ray radius will be more accurate however, 
might take longer if Blender has to progressively increase 
the limit. Lower values will work better for dense meshes 
with lots of detail while larger values are probably better 
suited for simple meshes. 


Mesh Cache Modifier 


The Mesh Cache modifier main use is for animated mesh 


data to be applied to a mesh and played back, deforming 
the mesh. 


This works in a similar way to shape keys, but is aimed at 
playing back external files and is often used for interchange 
between applications. 


Tip 


Both MDD and PC2 depend on the vertex order on the 
mesh remaining unchanged. This is a limitation of this 
method, so take care not to add, remove or reorder 
vertices once this modifier is used. 


Options 


Format 
The input file format (currently .mdd and .pc2 are 
Supported). 

File Path 
Path to the cache file. 


Influence 


Factor to adjust the influence of the modifier’s 


deformation, useful for blending in/out from the cache 
data. 


Deform Mode 


This setting defaults to MeshCache [5 \milfol\ x 
Overwrite which will 
replace the vertex 
locations with those in 


Format MDD 


File Path 


the cache file. However, Ass 1.000 
you may Wa nt to use Deform Mode _ Overwrite 
sha pe keys, for example, Interpolation Linear 
and mix them with the Pe Roniecning 
mesh cache. In this case 

Frame Time Factor 
you can select the 
Deform option which Play Mode Scene Custom 
integrates deformations al teal 0.000 
with the mesh cache Frame Scale 1.000 
result. y Axis Mapping 

Forward +Y 

Note i 
This feature is limited to Flip Axis (x 


making smaller, isolated 
edits and will not work 
for larger changes such 
as re-posing limbs. 


Mesh Cache Modifier. 


Interpolation 


None, or Linear, which will blend between frames. Use 
linear when the frames in the cache file do not match up 
exactly with the frames in the blend-file. 


Vertex Group 
If set, restrict the effect to the only vertices in that vertex 
group. 
Invert <-> 


Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Time Remapping 


Time Mode 


Select how time is calculated. 


Frame: 


Time: 


Factor: 


Play Mode 


Allows you to control the frames, which 
will ignore timing data in the file but is 
often useful since it gives simple 
control. 

Evaluates time in seconds, taking into 
account timing information from the file 
(offset and frame-times). 

Evaluates the entire animation as a 
value in the [0, 1] range. 


Select how playback operates. 


Scene: 


Custom: 


Use the current frame from the scene 
to control playback. 
Frame Start 
Play the cache starting from this 
frame. 
Frame Scale 
Scale time by this factor (applied 
after the start value). 


Control animation timing manually. 
Evaluation Value 
Property used for animation time, 
this gives more control of timing 
(typically this value will be 
animated). 


Axis Mapping 


Forward/Up Axis 
The axis for forward and up used in the source file. 


Flip Axis 
In rare cases you may also need to flip the coordinates 
on an axis. 


Mesh Sequence Cache 
Modifier 


The Mesh Sequence Cache modifier loads data from Alembic 
and USD files. It supports static meshes, but is mostly used 
to load animated meshes. Despite its name, this modifier 
also supports curves. It also handles file sequences, as well 
as meshes and curves with varying topology (like the result 
of fluid simulations). 


When importing an Alembic or USD file, Mesh Sequence 
Cache modifiers are automatically added to time-varying 
meshes. For time-varying object transforms (so animation of 
rotation, location, or scale), the Transform Cache Constraint 
is used. Files other than Alembic or USD, like MDD and PC2 
files, can be loaded using the Mesh Cache modifier. 


Options 


Cache File v MeshSequenceCac... ff v xX 
Data-block menu to 
select the Alembic or 
USD file. 


f]v Alembic File.abc x 


8, 
File Path Alembic File.abc jg 


Sequence 


File Path Override Frame 
Path to Alembic or USD Frame Offset 
file. Object Path 


Read Data Verte |Faces' UV Color e 


Object Path 
The path to the Alembic 
or USD object inside the archive or stage. 


Read Data 
Type of data to read for a mesh object, respectively: 
vertices, polygons, UV maps, and Color Attributes. 


Vertices, Faces, UV, Color 
Time 


Sequence 
Whether or not the cache is separated in a series of files. 


Override Frame 
Whether to use a custom frame for looking up data in the 
cache file, instead of using the current scene frame. 


The Frame value is the time to use for looking up the 
data in the cache file, or to determine which to use ina 
file sequence. 


Frame Offset 
Subtracted from the current frame to use for looking up 
the data in the cache file, or to determine which file to 
use in a file sequence. 


Velocity 


Velocity Attribute 
The name of the Alembic attribute used for generating 
motion blur data; by default, this is .velocities which is 
standard for most Alembic files. 


Note 


The Velocity Attribute option is currently for Alembic 
files only. 


Velocity Unit 


Defines how the velocity vectors are interpreted with 
regard to time. 


Frame: The velocity unit was encoded in 
frames and does not need to be scale 
by scene FPS. 

Second: The velocity unit was encoded in 
seconds and needs to be scaled by the 
scene FPS (1 / FPS). 


Note 


The Velocity Unit option is currently for Alembic files 
only. 


Velocity Scale 
Multiplier used to control the magnitude of the velocity 


vector for time effects such as motion blur. 
Note 


The Velocity Scale option is currently for Alembic files 
only. 


Normal Edit Modifier 


The Normal Edit modifier affects (or generates) custom 
normals. It uses a few simple parametric methods to 
compute them (quite useful in game development and 
architecture areas), and mixes back those generated 
normals with existing ones. 


Note 


This modifier requires custom normals to be enabled, 
which can be done by enabling Auto Smooth in the 
Properties » Object Data >» Normals. 


Options 


Radial y -K Normaledt WE mimy x 
Aligns normals with the 
(origin, 
vertex coordinates) 
vector, in other words all 
normals seems to radiate ia 
from the given center Mix Mode 
point, as if they were 
emitted from an ellipsoid 
surface. 


Radial Directional 


Target ‘a Vs 


Mix Factor 


Vertex Group & 


Max Angle 

Directional Y Offset 
Makes all normals point Offset X 
(converge) towards a Y 


given target object. - 


Target Normal Edit Modifier. 
Uses this object’s origin 
as reference point when 
generating normals. 


Optional in Radial mode, mandatory in Directional one. 


Parallel Normals 


Makes all normals parallel to the line between both 
objects’ origins, instead of converging towards target’s 
origin. 


Only relevant in Directional mode. 
Mix 


Mix Mode 


How to affect existing normals with newly generated 
ones. 


Note that the Multiply option is not a cross product, but a 
faster component-by-component multiplication. 


Mix Factor 
How much of the generated normals get mixed into 
existing ones. 


Vertex Group 
Allows per-item fine control of the mix factor. The vertex 
group influence can be inverted by using the arrow 
button to the right. 


Max Angle 
Forbids new generated normals to have an angle to the 
Original normal above that given threshold. This is useful 
to prevent extreme changes, that can even lead to 


inverting the front/back sides of a face, and consequently 
to shading artifacts. 


Lock Polygon Normals (padlock icon) 
Prevents flipping (reversing front/back sides) of 
polygons which normal does not match anymore the 
side to which point its corners’ custom normals. Can 
also help to avoid shading issues. 


Offset 


Gives modified object’s origin an offset before using it to 
generate normals. 


Only relevant in Radial mode if no Target Object is set, and 
in Directional mode when Parallel Normals is set. 


Usage 


This modifier can be used to quickly generate radial normals 
for low-poly tree foliage or “fix” shading of toon-like 
rendering by partially bending default normals... 


Tip 
More complex normal manipulations can be achieved by 
copying normals from one mesh to another, see the Data 


Transfer Modifier. Some shading effects can also make use 
of the Weighted Normals modifier. 


Example 


Editing custom normals to point towards a given 
direction (blend-file). 


The left tree mesh has unmodified normals, while on the 
right one a Normal Edit modifier is used to bend them 
towards the camera. This shading trick is often used in 
games to fake scattering in trees and other vegetation. 


UV Project Modifier 


Projecting the Blender logo onto Suzanne. 


The UV Project modifier acts like a slide projector. It emits a 
UV map from the negative Z axis of a controller object (Such 
as an empty object), and applies it to the object as the 
“light” hits it. 


Download an example. 
Options 
UV Map 


Which UV map to modify. Defaults to the active rendering 
layer. 


Aspect X/Y 


Changes the image’s #] UVProject SP imi. x 
aspect ratio. Only apply 


when a camera is used ae UV Map x 
as projector object. Aspect X 1.000 
\¢ 1.000 
Scale X/Y Scale X 1.000 
Scales the image. Only Y 1.000 
apply when a camera is Projectors 2 
used as projector object. Object ‘mw Camera 
Object ‘a 
Projectors 7 
Up to ten projector 
objects are supported. The UV Project modifier. 


Each face will choose the 

closest and aligned 

projector with its surface normal. Projections emit from 
the negative Z axis (i.e. straight down a camera or light). 
If the projector is a camera, the projection will adhere to 
its perspective/orthographic setting. 


Object 
Specify the projector object(s). 


Usage 


General 


UV Project is great for making spotlights more diverse, and 
also for creating decals to break up repetition. 


Usually, an Image Texture node mapped to the UV map that 
the modifier targets is added to the object’s material. 


Known Limitations 


Vertices Behind the Camera 


When projecting geometry in a perspective view, vertices 
behind the camera are not properly mapped. You can 
workaround this by subdividing geometry so that faces in 
front of the camera have correctly mapped UVs. 


UV Warp Modifier 


The UV Warp modifier transforms an object’s UV map based 
on values or two objects. Its purpose is to give you direct 
control over the object’s UVs in the 3D Viewport, allowing 
you to directly move, rotate, and scale existing UV 
coordinates using defined values or a controller object or 
bone. 


Options 
UV Layer se] UV Warp mmo. x 


Which UV map to modify; 
if not set it defaults to 


UV Layer e UVMap 


the active rendering hE ell cere 

layer. : 
UV Center 

The center point of the Object From (ml) Cube 

UV map to use when To ‘mi Cylinder 

applying scale or Vertex Group #82 

rotation. With (0, 0) at aera 


the bottom left and (1, 1) 
at the top right. 


Offset 


Axis U/V 
The axes to use when 
mapping the 3D 
coordinates into 2D. 


Rotation 


Object From, To 


The two objects used to define the transformation. See 
Usage below. 


Vertex Group 


The vertex group can be used to scale the influence of 
the transformation per vertex. 


Invert <-> 


Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Transform 


Offset 
Amount to move the UV map. 


Scale 
Amount to scale the UV map. 


Rotate 
Amount to rotate the UV map. 


Usage 


How the UVs are warped is determined by the difference 
between the transforms (location, rotation and scale) of the 
from and to objects. 


If the to object has the same transforms as the from object, 
the UVs will not be changed. 


Assuming the UV Axis of the modifier is X/Y and the scale of 
the objects is (1, 1, 1), if the to object is one unit away from 
the from object on the X axis, the UVs will be transformed 
on the U axis (horizontally) by one full UV space (the entire 
width of the image). 


Vertex Weight Edit 
Modifier 


This modifier is intended to edit the weights of a vertex 
group. 


The general process is the following, for each vertex: 


e (Optional) It does the mapping, either through one of 
the predefined functions, or a custom mapping curve. 

e It applies the influence factor, and optionally the vertex 
group or texture mask (0.0 means original weight, 1.0 
means fully mapped weight). 

e It applies back the weight to the vertex, and/or it might 
optionally remove the vertex from the group if its weight 
is below a given threshold, or add it if it is above a given 
threshold. 


Important 


This modifier does implicit clamping of weight values in 
the standard (0.0 to 1.0) range. All values below 0.0 will be 
set to 0.0, and all values above 1.0 will be set to 1.0. 


Note 


You can view the modified weights in Weight Paint Mode. 
This also implies that you will have to disable the Vertex 
Weight Edit modifier if you want to see the original weights 
of the vertex group you are editing. 


Options 


Vertex Group vy is} Vertex Wei.. VP ESM x 
The vertex 
Vertex Group §s5 Group x 
group to affect. : 
Default Weight 0.000 
Default Weight Group Add 
The default Group Remove 
weight to assign Normalize Weights 
to all vertices Se 
not in the given 
vertex group. Type /\ Linear 
v Influence 
Group Add 
Adds vertices Global Influence: 
with - final Mask Vertex Gr... 3s 
weight over Add Mask Texture Pv + 
Threshold to the 
vertex group. The Vertex Weight Edit modifier panel. 
Group Remove 
Removes 


vertices with a final weight below Remove Threshold 
from the vertex group. 


Normalize Weights 
Scale the weights in the vertex group to keep the relative 
weight but the lowest and highest values follow the full 0 
- 1 range. 


Falloff 


Falloff Type 
Type of mapping. 


Linear 
No mapping. 


Custom Curve 
Allows you to manually define the mapping using a 
curve. 


Sharp, Smooth, Root and Sphere 
These are classical mapping functions, from spikiest to 
roundest. 


Random 
Uses a random value for each vertex. 


Median Step 
Creates binary weights (0.0 or 1.0), with 0.5 as cutting 
value. 


Invert <--> 
Inverts the falloff. 


Influence 


Those settings are the same for the three Vertex Weight 
modifiers. 


Global Influence 
The overall influence of the modifier (0.0 will leave the 
vertex group’s weights untouched, 1.0 is standard 
influence). 


Important 

Influence only affects weights, adding/removing of 
vertices to/from vertex group is not prevented by 
setting this value to 0.0. 


In addition, a per-vertex fine control of the effect is possible 
using either a vertex group or a texture (both are mutually 
exclusive). The per-vertex values from those will be 
multiplied with the Global Influence. 


See common masking options for a complete reference. 


Example 


Here is an example of various effects achieved using Vertex 
Weight Edit modifier (together with the Vertex Weight 
Proximity modifier) to generate weights used by the 
Displace modifier. 


Curve Map variations. 


Concave-type mapping curve. 


No mapping curve (linear). 


Convex-type mapping curve. 


Vertices with a computed weight below 0.1 removed 
from the vertex group. 


The blend-file, TEST _2 scene. 


Vertex Weight Mix 
Modifier 


This modifier mixes a second vertex group (or a simple 
value) into the affected vertex group, using different 
operations. 


Important 


This modifier does implicit clamping of weight values in 
the standard (0.0 to 1.0) range. All values below 0.0 will be 
set to 0.0, and all values above 1.0 will be set to 1.0. 


Note 


You can view the modified weights in Weight Paint Mode. 
This also implies that you will have to disable the Vertex 
Weight Mix modifier if you want to see the original weights 
of the vertex group you are editing. 


Options 


Vertex Group A, B 

e A: The vertex group to affect. 

e B: The second vertex group to mix into the affected 
one. Leave it empty if you only want to mix ina 
simple value. 

Invert Weights A/B 
Invert the influence of the vertex group. 


Default Weig ht A,B v VertexWeightMix £7 f(y. x 
e A: The 


Vertex Group A = ao 
default fF are 
weight to ; 
assign to all Default Weight A 0.000 
vertices not B 0.000 
in the given 
vertex Vertex Set VGroup A andB 
group. Mix Mode’ Replace 

e B: The Normalize Weights 
default V Influence 
weight rc Global Influence: 
assign to all 
vertices not Mask Vertex Gr... 3s 
in the given Mask Texture fey + 
second 
vertex The Vertex Weight Mix modifier panel. 
group. 
Vertex Set 


Choose which vertices will be affected. 


All: Affects all vertices, disregarding the 
vertex groups content. 

Vertex Group A: 
Affects only vertices belonging to the 
affected vertex group. 

Vertex Group B: 
Affects only vertices belonging to the 
second vertex group. 

Vertex Group A or B: 
Affects only vertices belonging to at 
least one of the vertex groups. 

Vertex Group A and B: 
Affects only vertices belonging to both 
vertex groups. 


Important 


When using All vertices, Vertices from group B or 
Vertices from one group, vertices might be added to the 
affected vertex group. 


Mix Mode 


How the vertex group weights are affected by the other 
vertex group’s weights. 


Replace: 


Add: 
Subtract: 


Multiply: 
Divide: 
Difference: 
Average: 
Minimum: 


Maximum: 


Normalize Weights 


Replaces affected weights with the 
second group’s weights. 

Adds the values of Group B to Group A. 
Subtracts the values of Group B from 
Group A. 

Multiplies the values of Group B with 
Group A. 

Divides the values of Group A by Group 
B. 

Subtracts the smaller of the two values 
from the larger. 

Adds the values together, then divides 
by 2. 

Uses the smallest weight value of 
VGroup A’s or VGroup B’s weights. 
Uses the largest weight value of 
VGroup A’s or VGroup B’s weights. 


Scale the weights in the vertex group to keep the relative 
weight but the lowest and highest values follow the full 0 


- 1 range. 


Influence 


Those settings are the same for the three Vertex Weight 
modifiers, see the Vertex Weight Edit modifier page. 


Example 


Here is and example of using a texture and the mapping 
curve to generate weights used by the Wave modifier. 


Texture channel variations. 


¥ cre | 

1 Akl 
Using Using 
intensity. Pain Bed. Saturation. 


Custom mapping curve with a Vertex Weight Edit modifier. 


A Custom Custom 
customized ae ee 
mapping isabled. enabled. 


curve. 


The blend-file, TEST_4 scene. 


Vertex Weight Proximity 
Modifier 


This modifier sets the weights of the given vertex group, 
based on the distance between the object (or its vertices), 
and another target object (or its geometry). 


Warning 


This modifier does implicit clamping of weight values in 
the standard (0.0 to 1.0) range. All values below 0.0 will be 
set to 0.0, and all values above 1.0 will be set to 1.0. 


Note 


You can view the modified weights in Weight Paint Mode. 
This also implies that you will have to disable the Vertex 
Weight Proximity modifier if you want to see the original 
weights of the vertex group you are editing. 


Options 
Vertex Group 


The vertex group to affect. 


Target Object 
The object from which to compute distances. 


Proximity Mode 
Object Distance 


Use the 
distance 
betwee 
n the 
modifie 
d mesh 
object 
and the 
target 
object 
as 
weight 
for all 
vertices 
in the 
affected 
vertex 


group. 


Geometry 
Distance 


VertexWeightPr.. [7 iv x 


Vertex Group &s 


Target Object ‘ms Val 


Proximity Mode Object ve 


Lowest Om 


Highest 1m 


Normalize Weights 
v Falloff 
Type /\ Linear 
v Influence 


Global Influence: 


Mask Vertex Gr... is 


Mask Texture fRjy + 


The Vertex Weight Proximity modifier panel. 


Use the distance between each vertex and the target 
object, or its geometry. 


Vertex 


This will set each vertex’s weight from its distance 
to the nearest vertex of the target object. 


Edge 


This will set each vertex’s weight from its distance 
to the nearest edge of the target object. 


Face 


This will set each vertex’s weight from its distance 
to the nearest face of the target object. 


Note 


If you enable more than one of them, the shortest 
distance will be used. If the target object has no 
geometry (e.g. an empty or camera), it will use the 
location of the object itself. 


Lowest 
Distance mapping to 0.0 weight. 


Highest 
Distance mapping to 1.0 weight. 


Tip 


Lowest can be set above Highest to reverse the mapping. 


Normalize Weights 
Scale the weights in the vertex group to keep the relative 
weight but the lowest and highest values follow the full 0 
- 1 range. 


Falloff 


Type 
Type of mapping. 


Linear 
No mapping. 


Custom Curve 
Allows you to manually define the mapping using a 
curve. 


Sharp, Smooth, Root and Sphere 
These are classical mapping functions, from spikiest to 
roundest. 


Random 
Uses a random value for each vertex. 


Median Step 
Creates binary weights (0.0 or 1.0), with 0.5 as cutting 
value. 


Invert <--> 
Inverts the falloff. 


Influence 


Those settings are the same for the three Vertex Weight 
modifiers, see the Vertex Weight Edit modifier page. 


Example 


This example shows the usage of distance from a target 
object to dynamically control a Wave modifier with a 
modified vertex group: 


The blend-file, TEST_1 scene. 


Weighted Normal Modifier 


This modifier changes the custom normals of a mesh, using 
various selectable methods. This can be useful to make 
some faces appear very flat during shading, among other 
effects. See Normals for a description of normals and 
custom normals. 


Note 


This modifier requires custom normals to be enabled, 
which can be done by enabling Auto Smooth in the 
Properties » Object Data >» Normals. 


Options 
Weighting Mode y ck Weighted v.. 57 Sm YS x 
The normals around a Weighting Mode Face Area ve 


vertex will be combined 
to create a custom (per 
face corner) normal 
using various weights for 
each. The Weighting 
Mode defines how to 
compute the weights. 


Weight 50 


Threshold 0.01 


Keep Sharp 


Face Influence 


Vertex Group gs 


Face Area 
Weight according to the area of the face that the 
normal originates. A larger area means that the 
normal from that face will get a higher weight in final 
result. 


Corner Angle 
Weight according to the angle each face forms at the 
vertex. This is the method Blender uses by default 
when combining face normals to compute a vertex 
one. 


Face Area and Angle 
Weights are obtained by multiplying the face area and 
corner angle ones. 


Weight 
Determines how strongly the weights are biased 
according to the face areas and/or corner angles, a bit 
like a contrast setting for a picture. 


A value of 50 means all faces are weighted uniformly. 
More than 50 means faces with higher area or angles are 
given even more weight (more “contrast”). Less than 50 
means faces with higher area or angles are given lesser 
weights (less “contrast”). 


Threshold 
A weight-rounding threshold which means that, if two 
angles or areas differ by less than that threshold, they 
will get equal weights. 


Keep Sharp 
Preserve sharp edges, though smoothing will still happen 
if there are multiple faces between any two sharp edges. 


Face Influence 
Use face weights (weak, medium, or strong) as assigned 
by the Set Strength tool or by the Set Strength mode of a 
Bevel modifier. 


For example, if three faces meet at a vertex and have the 
face weights weak, medium, and strong, then only the 
normal associated with the strong face will be used to set 
the final result. 


Vertex Group 
If a vertex group is specified, the modifier will only affect 
those vertices. The “arrow” button to its right will invert 
the selection (only affect the vertices not in the vertex 


group). 


Array Modifier 


The Array modifier creates an array of copies of the base 
object, with each copy being offset from the previous one in 
any of a number of possible ways. Vertices in adjacent 
copies can be merged if they are nearby, allowing smooth 
Subdivision Surface frameworks to be generated. 


This modifier can be useful when combined with tileable 
meshes for quickly developing large scenes. It is also useful 
for creating complex repetitive shapes. 


Multiple Array modifiers may be active for an object at the 
same time (e.g. to create complex three-dimensional 
constructs). 


Options 


Fit Type 
Controls how the length of the array is determined. There 
are three choices, activating respectively the display of 
the Curve, Length or Count settings explained below: 


Fit Curve 
Generates enough copies to fit within the length of the 
curve object specified in Curve. 


Fit Length 
Generates enough copies to fit within the fixed length 
given by Length. 


Fixed Count 
Generates the number of copies specified in Count. 


Note y gol) Array Vitmm. x 


Fit Type Fixed Count ve 
e Both Fit Curve and Fit Eee 5 

Length use the local 

coordinate system size eee Sree 

of the base object, Factor X 

which means that Y 

scaling the base object Z 

in Object Mode will not Constant Offset 


change the number of 
copies generated by 
the modifier. 

Fit Curve uses the local 
coordinate system 
length of the curve, 
which means that 
scaling the curve in 
Object Mode will not 
change the number of 
copies generated by ae 

the modifier. Offset U 
Applying the scale can v 
be useful for both. 


Object Offset 


Caps 


Cap Start 
End @ 


The Array modifier. 


Relative Offset 


Factor X/Y/Z 


Adds a translation equal to the object’s bounding box 
size along each axis, multiplied by a scaling factor, to the 


offset. X, Y and Z scaling factors can be specified. 


Relative offset (0.5, 1.0 and 1.5) examples. 


Constant Offset 


Distance X/Y/Z 
Adds a constant translation component to the duplicate 
object’s offset. X, Y and Z constant components can be 
specified. 


Object Offset 


Adds a transformation taken from an object (relative to the 
current object) to the offset. It is good practice to use an 
empty object centered or near to the initial object. E.g. by 
rotating this empty a circle or helix of objects can be 
created. 


Object offset example. 


Merge 


If enabled, vertices in each copy will be merged with 
vertices in the next copy that are within the given Distance. 


First and Last Copies 
If enabled and Merge is enabled, vertices in the first 
copy will be merged with vertices in the last copy, again 
if they are within Distance range. This is useful for 
circular objects. 


First and Last Copies merge example. 


Subdivision Subdivision 


discontinuity discontinuity 
caused by not eliminated by 
merging vertices merging vertices 
between first and between first and 
last copies (First last copies (First 
and Last Copies and Last Copies 
off). on). 

Distance 


Controls the merge distance for Merge and First and Last 
Copies. 


UVs 


Offset U/V 
Shifts UVs of each new duplicate by a settable amount. 


Caps 


Cap Start, End 


This allows either endpoints of the array to have a 
different mesh subsisted. 


For the start: as if it was in position -1, i.e. one “array 
step” before the first “regular” array copy. For the end: as 


if it was in position n + 1, i.e. one “array step” after the 
last “regular” array copy. 


When Merge is activated, the cap vertices within the 
Distance threshold will be merged. 


Note 


The start/end cap objects currently do not support the 
First and Last Copies option. 


Hints 


Offset Calculation 


The transformation applied from one copy to the next is 
calculated as the sum of the three different components 
(Relative, Constant and Object), each of which can be 
enabled/disabled independently of the others. This allows, 
for example, a relative offset of (1.0, 0.0, 0.0) anda 
constant offset of (0.1, 0.0, 0.0), giving an array of objects 
neatly spaced along the X axis with a constant 0.1 unit 
between them, whatever the original object’s size. 


Examples 


A chain created from a single link. Sample blend-file. 


A tentacle created with an Array Modifier followed 
by a Curve Modifier. 


The segment in the foreground is the base mesh for 
the tentacle; the tentacle is capped by two 


specially-modeled objects deformed by the same 
Curve object as the main part of the tentacle. 
Sample blend-file. 


Fractal 


er 2 
e 2 ‘ei 
+ Va 


Multi-level array Fractal created with 
animated with multiple arrays. 
motion blur. Sample blend-file. 


Bevel Modifier 


The Bevel modifier bevels the edges v2] _ Bevel 

of the mesh it is applied to, with some Vertices 
control of how and where the bevel is Width Type 
applied to the mesh. on 


Segments 


It is a non-destructive alternative to PR erate 
the Bevel Operation in Edit Mode. 


Y Profile 


Superellipse Custom 


Side views of a cube. 


Shape 0.50 
vy Geometry 


Miter Outer Sharp 


Inner Sharp 


Intersections Grid Fill 


¥Y Clamp Overlap 


Not ¥ Loop Slide 


Beveled. 


vy Shading 


beveled. 


Harden Normals 


Seam 


Sharp 
Material Index 


Face Strength 


The Bevel modifier. 


Options 
Affect 
Vertices: Only the areas near vertices are beveled, 
the edges remain unchanged. 
Edges: Bevel the edges, creating intersections at 


vertices. 


Three cubes with 0.1, 0.3 and 0.5 bevel widths, with 
Vertices option selected. 


Width Type 


Defines how Width will be 
interpreted to determine the 


amount of bevel. 


Offset: 


Width: 


Depth: 
Percent: 


Absolute: 


The distance from the new edge to the 
Original. 

The distance between the two new edges 
formed by the bevel (or the edges on either 
side of the bevel if there is more than one 
segment). 

Value is the perpendicular distance from the 
new bevel face to original edge. 

The percentage of the length of adjacent 
edge length that the new edges slide along. 


Width 


The exact distance along edges adjacent to 
the beveled edge. A difference from Offset 
is visible when the unbeveled edges 
attached to beveled edges meet at an angle 
besides a right angle. 


The size of the bevel effect. See Width Method below. 


Three Cubes with 0.1, 0.3 and 0.5 bevel widths. 


Segments 


The number of edge loops added along the bevel’s face. 


Limit Method 


Used to control where a bevel is applied to the mesh. 


None: 
Angle: 


Weight: 


Vertex Group: 


No limit, all edges will be beveled. 


Only bevels edges whose angle of adjacent 
face normals plus the defined Angle is less 
than 180 degrees. Intended to allow you to 
bevel only the sharp edges of an object 
without affecting its smooth surfaces. 


Use each edge’s bevel weight to determine 
the width of the bevel. When the bevel 
weight is 0.0, no bevel is applied. See here 
about adjusting bevel weights. 


Use weights from a vertex group to 
determine the width of the bevel. When the 
vertex weight is 0.0, no bevel is applied. An 
edge is only beveled if both of its vertices 
are in the vertex group. See here about 
adjusting vertex group weights. 
Invert <-> 
Inverts the influence of the selected 
vertex group, meaning that the group 
now represents vertices that will not be 
deformed by the modifier. 
The setting reverses the weight values of 
the group. 


Profile 
Superellipse 


Creates a bevel with a uniform concave or convex curve. 


Shape 
The shape of the bevel, from concave to convex. It has no 
effect if Segments is less than 2. 


Custom Profile 


This widget allows the creation of a user-defined profile with 
more complexity than with the single profile parameter. The 
modal tool allows toggling the custom profile, but the shape of 
the profile is only editable in the options panel after the 
operation is confirmed. 


The profile starts at the bottom right of the widget and ends at 
the top left, as if it were between two edges meeting at a right 
angle. Control points are created in the widget and then the path 
is sampled with the number of segments from the Bevel modifier. 


Miter Shape 


The shape of the miter patterns, 
from concave to convex. It has 
no effect if Segments is less than 
2. 


Note 


The Miter Shape slider stays 
active when miters are enabled 
because it still controls the 
shape of the miter profiles. 


Presets C\ AYN 7\ X__(0.25000 Y 0.24986 xX 
Sample Straight Edges 
The Support Loops and Steps Sample Even Lengths 
presets are built dynamically 


depending on the number of The custom profile widget. 
segments in the bevel. If the 


number of segments is changed, 
the preset will have to be re-applied. 


Sampling 
Samples will first be added to each control point, then if there 
are enough samples, they will be divided evenly between the 
edges. The Sample Straight Edges option toggles whether the 
Samples are added to edges with sharp control points on 
either side. If there aren’t enough samples to give each edge 
the same number of samples, they will just be added to the 
most curved edges, so it is recommended to use at least as 
many segments as there are control points. 


Geometry 


Miter Inner/Outer 


A miter is formed when two beveled edges meet at an angle. 
On the side where the angle is greater than 180 degrees, if 
any, it is called an outer miter. If it is less than 180 degrees, 
then it is called an inner miter. The outer and inner miters can 
each be set to one of these patterns: 


Sharp: 


Patch: 


Arc: 


Spread 


Edges meet at a sharp point, with no extra 
vertices introduced on the edges. 


Edges meet at a sharp point but in addition, 
two extra vertices are introduced near the 
point so that the edges and faces at the 
vertex may be less pinched together than 
what occurs in the Sharp case. This pattern 
does makes no sense for inner miters, so it 
behaves like Arc for them. 


Two vertices are introduced near the 
meeting point, and a curved arc joins them 
together. 

The Spread slider controls how far the new 
vertices are from the meeting point. 

The Profile curve widget controls the shape 
of the arc. 


Diagrams of the miter patterns. 


Sharp 
outer 
miter. 


Sharp 
inner miter. 


Patch outer Arc outer 
miter. miter. 


Arc inner 
miter. 


The value used to spread extra vertices apart for non-sharp 
miters. This option is available when Miter Inner is set to Arc. 


Intersections 
When more than two beveled edges meet at a vertex, a mesh 
is created as a way to complete the intersection between the 
generated geometry. This option controls the method used to 
create that mesh. 


Grid Fill: The default method for building 
intersections, useful when a smooth 
continuation of the bevel profile is desired. 
Without Custom Profile enabled, the curve 
of the profile continues through the 
intersection, but with a custom profile it just 
creates a smooth grid within the boundary 
of the intersection. 


Cutoff: Creates a cutoff face at the end of each 
beveled edge coming into the vertex. This is 
most useful for custom profiles when the 
new intersection is too complex for a 
smooth grid fill. 

With a three way intersection, when the 
inner corners of the cutoff profiles faces 
meet at the same location, no center face Is 
created. 

The direction of the cutoff faces depends on 
the original vertex’s normal. 


Intersection method options. 


Grid fill Three way Cutoff 
intersection cutoff intersection 


method. intersection method 


where the with a 
inner center 
vertices are face. 
merged. 


Clamp Overlap 


Limits the width of each beveled edge so that edges cannot 
cause overlapping intersections with other geometry. 


Loop Slide 
If there are unbeveled edges along with beveled edges into a 
vertex, the bevel tries to slide along those edges when 


possible. Turning the option off can lead to more even bevel 
widths. 


Shading 


Harden Normals 
When enabled, the per-vertex face normals of the bevel faces 
are adjusted to match the surrounding faces, and the normals 
of the surrounding faces are not affected. This will keep the 
surrounding faces flat (if they were before), with the bevel 
faces shading smoothly into them. For this effect to work, you 
need custom normals data, which requires Auto Smooth 
option to be enabled (see Normals). 


Mark 
Seam 
If aseam edge crosses a non-seam one and you bevel all 
of them, this option will maintain the expected propagation 
of seams. 


Sharp 
Similar to Mark Seams, but for sharp edges. 


Material Index 


The index of the material slot to use for the bevel. When set 
to -1, the material of the nearest original face will be used. 


Face Strength 
Set Face Strength on the faces involved in the bevel, 
according to the mode specified here. This can be used in 
conjunction with a following Weighted Normals modifier (with 
the Face Influence option checked). 


None: Do not set face strength. 

New: Set the face strength of new faces along 
edges to Medium, and the face strength of 
new faces at vertices to Weak. 

Affected: In addition to those set for the New case, 
also set the faces adjacent to new faces to 
have strength Strong. 

All: In addition to those set for the Affected 
case, also set all the rest of the faces of the 
model to have strength Strong. 


Boolean Modifier 


The Boolean modifier performs operations on meshes that 
are otherwise too complex to achieve with as few steps by 
editing meshes manually. It uses one of the three available 


Boolean operations to create a single mesh out of two mesh 
objects: 


The Union, Intersection and Difference between a 
Cube and a UV Sphere, with the modifier applied to 
the sphere and using the cube as target. 


This modifier needs a second mesh object, or collection of 


mesh objects, to be the target (the second operand) of the 
operation. 


Warning 


Only Manifold meshes are guaranteed to give proper 
results, other cases (especially “opened” meshes, Non- 
manifold but without any self-intersections) will usually 


work well, but might give odd glitches and artifacts in 
some cases. 


Tip 


If you have marked your objects to show the edges (in 
Properties » Object Properties » Viewport Display, enable 
Wireframe), you will see the edge creation process while 
you are moving your objects around. Depending on your 
mesh topology, you can also enable X-Ray and 
Transparency and see the topology being created in real- 
time. 


Options 
Boolean r7moOew x 
Intersect Union Difference 
Operand Type Object ve 
Object ‘a Vl 
Solver Fast Exact 
Self 
The Boolean modifier. 
Operation 
Intersect: Everything inside both the target mesh 


and the modified mesh is kept. If the 
target is a collection, then only the 
inside of a// meshes is kept. 

Union: The target mesh or collection is added 
to the modified mesh, removing any 
interior faces. 

Difference: 


Operand Type 


The target mesh, or collection of 
meshes, is subtracted from the 
modified mesh (everything outside of 
the target mesh or collection is kept). 


Choose the type of the operand (target). 


Object: 
Collection: 


Object 


The target is a mesh object. 

The target is a collection. When the 
target is a collection and the Solver is 
Fast, the Intersect operation is not 
allowed. 


The name of the target mesh object. 


Collection 


The name of the target collection (may be empty if 
Solver is Exact, which can be useful in combination with 


the Self option). 


Solver 


Algorithm used to calculate the Boolean intersections. 


Fast: 


Exact: 


Uses a mathematically simple solver 
which offers the best performance; 
however, this solver lacks support for 
overlapping geometry. 

Uses a mathematically complex solver 
which offers the best results and has 
full support for overlapping geometry; 
however, this solver is much slower 
than the Fast Solver. 


Solver Options 


Materials Exact Solver 
Method for setting materials on the new faces. 


Index Based: Set the material on new faces based on 
the order of the material slot lists. If a 
material doesn’t exist on the modifier 
object, the face will use the same 
material slot or the first if the object 
doesn’t have enough slots. 

Transfer: Transfer materials from non-empty 
slots to the result mesh, adding new 
materials as necessary. For empty 
slots, fall back to using the same 
material index as the operand mesh. 


Self Intersection Exact Solver 
Correctly calculates cases when one or both operands 
have self-intersections, this involves more calculations 
making it slower. 


Hole Tolerant Exact Solver 
Optimizes the Boolean output for Non-manifold geometry 
at the cost of increased computational time. Because of 
the performance impact, this option should only be 
enabled when the Exact solver demonstrates errors with 
non-manifold geometry. 


Overlap Threshold Fast Solver 
Maximum distance between two faces to consider them 
as overlapping. This helps solve the limitation of this 
solver, if the Boolean result seems unexpected try using 
the exact solver. 


Build Modifier 


The Build modifier causes the faces of the mesh object to 
appear or disappear one after the other over time. 


By default, faces appear in the order in which they are 
stored in memory (by default, the order of creation). The 
face/vertex order can be altered in Edit Mode by using Sort 
Mesh Elements. 


Options 

Start Frame ¥ Ba Build mim. x 
The start frame of the hae FOB 
building Process. Length 100.000 

Le n g t h Reversed 
The number of frames Sales 


over which to rebuild the 
object. 


Reversed The Build modifier. 


The modifier will operate 

in reverse, essentially 

allowing it to be used as a “deconstruction” effect. This is 
useful for making a set of instancing objects gradually 
disappear. 


Randomize 


Randomizes the order in which the faces are built. 


Seed 


The random seed. Changing this value gives a different 
“random” order when Randomize is checked. This order 
is always the same for a given seed/mesh set. 


Example 


The Build modifier can be used to make a large number of 
items to progressively appear, without resorting to 
animating the visibility of each one by one. Examples of this 
include a mesh containing vertices only, which is used as an 
Instancing Vertex emitter, and has the Build modifier on it. 
Such a setup is a workaround/technique for being able to 
art-direct a semi-random layout of a collection of objects 
(e.g. leaves/balls forming a carpet). This can be preferable 
to particles e.g. due to undesirable distribution of items 
leaving random gaps and overlapping in other places. 


Decimate Modifier 


The Decimate modifier allows you to reduce the vertex/face 
count of a mesh with minimal shape changes. 


This is not usually used on meshes which have been created 
by modeling carefully and economically (where all vertices 
and faces are necessary to correctly define the shape). But 
if the mesh is the result of complex modeling, sculpting 
and/or applied Subdivision Surface/ Multiresolution 
modifiers, the Decimate one can be used to reduce the 
polygon count for a performance increase, or simply remove 
unnecessary vertices and edges. 


Unlike the majority of existing modifiers, this one does not 
allow you to visualize your changes in Edit Mode. 


The modifier displays the number of remaining faces as a 
result of the Decimate modifier. 


Options 


Collapse 


Merges vertices together progressively, taking the shape of 
the mesh into account. 


Ratio 
The ratio of faces to keep after decimation. 


e On 1.0: the mesh is unchanged. 
e On 0.5: edges have been collapsed such that half the 
number of faces remain (see note below). 


e On 0.0: vy | __ Decimate _) © ae 
all faces 
have 
been 
removed. symmetry 


Collapse Un-Subdivide Planar 


Ratio 1.0000 


Triangulate 


Note 


Although the 
Ratio is 
directly 
proportional 
to the The Decimate modifier in Collapse mode. 
number of 

remaining 

faces, 

triangles are used when calculating the ratio. 


Vertex Group a3 


Face Count: 6 


This means that if your mesh contains quads or other 
polygons, the number of remaining faces will be larger 
than expected, because those will remain unchanged if 
their edges are not collapsed. 


This is only true if the Triangulate option is disabled. 
Symmetry 
Maintains symmetry on a single axis. 


Triangulate 
Keeps any resulting triangulated geometry from the 
decimation process. 


Vertex Group 
A vertex group that controls what parts of the mesh are 
decimated. 


Factor 


The amount of influence the Vertex Group has on the 
decimation. 


Un-Subdivide 


It can be vy | __ Decimate I) © Ze 
thought of 
as the 
reverse of 
subdivide. It Face Count: 4 
attempts to 
remove 
edges that 
were the 
result of a 
subdivide operation. It is intended for meshes with a mainly 
grid-based topology (without giving uneven geometry). If 
additional editing has been done after the subdivide 
operation, the results may be unexpected. 


Collapse Un-Subdivide Planar 


Iterations 2 


The Decimate modifier in Un-Subdivide mode. 


Iterations 
The number of times to perform the un-subdivide 
operation. Two iterations is the same as one subdivide 
operation, so you will usually want to use even numbers. 


Planar 


It reduces details on forms comprised of mainly flat 
Surfaces. 


Angle Limit 
Dissolve geometry which form angles (between surfaces) 
higher than this setting. 


Delimit 


Prevent v Y Decimate mov x 
dissolving 


‘ Collapse Un-Subdivide Planar 
geometry In 
certain places. su ale 2 
Delimit | Normal 

Normal Material 

Does not Seam 

dissolve Sharp 

edges on the Se 

borders of All Boundaries 

areas where Face Count: 6 

the face 

normals are oo, 

The Decimate modifier in Planar mode. 

reversed. 

Material 


Does not dissolve edges on the borders of where 
different materials are assigned. 


Seam 
Does not dissolve edges marked as seams. 


Sharp 
Does not dissolve edges marked as sharp. 


UVs 
Does not dissolve edges that are part of a UV map. 


All Boundaries 
When enabled, all vertices along the boundaries of faces 
are dissolved. This can give better results when using a 
high Angle Limit. 


Edge Split Modifier 


The Edge Split modifier splits, duplicates edges within a 
mesh, breaking ‘links’ between faces around those split 
edges. 


The edges to split can be determined from the edge angle 
(i.e. angle between faces forming that edge), and/or edges 
marked as sharp. 


Splitting an edge affects vertex normal generation at that 
edge, making the edge appear sharp. Hence, this modifier 
can be used to achieve the same effect as Auto Smooth, 
making edges appear sharp when their angle is above a 
certain threshold. It can also be used for manual control of 
the smoothing process, where the user defines which edges 
should appear smooth or sharp (See Mesh Smoothing for 
other ways to do this). If desired, both modes can be active 
at once. 


Note 

This modifier is kept mostly for historical/compatibility 
reasons. Everything it can do in shading, and much more, 
can now be achieved using custom normals. 

Unless you really need the topology changes it generates, 
it is not advised to use it in new projects. 


Note 


Splitting edges can also be performed manually in Edit 
Mode. 


Options 


Edge Angle Y |X) _— EdgeSpiit VYHmeei. x 
When enabled, an edge Edge angie: a 30° 
will be split if the angle Sharp Edges 
between its two adjacent 
faces is greater than the 
Split Angle. 


The Edge Split modifier. 


Split Angle 
On 0: all edges are split. On 180: no edges are split. 


Sharp Edges 


When enabled, edges will be split if they were marked as 
Sharp. 


Note 


Non-manifold edges will always be split. 


Examples 


Flat shading. Smooth shading. 


Smooth shading with 
Edge Split and 
Subdivision Surface. 


Smooth shading with 
Edge Split. 


Geometry Nodes Modifier 


The Geometry Nodes modifier creates a modifier with a 
node group which defines its functionality. 


¥ &) GeometryNodes [i v & 


&)» Geometry Nodes UO (G x 


A new Geometry Nodes modifier with a new node 
group. 


This modifier is supported by mesh, curve, text, and volume 
objects. 


Options 


Node Group 


A Node Group with the geometry input and output. Those 
are respectively what is received and passed to the 
previous and next modifier in the stack. See Nodes for all 
available nodes. 


Inputs 


A list of the node group’s inputs which can have unique 
values even if the group is shared among multiple 
modifiers. 


If the input is connected to a Field socket, there will be a 
toggle to switch between using a single value for the 
input or using an attribute on the input geometry. Using 
an attribute for input means the value can be different 
for every element. 


The attribute name used by default when using the node 
group in a modifier for the first time is defined in the 
node group inputs panel. 


Note 


The attribute domain and the used to access the 
attribute is defined by the node the input is connected 
to. 


Output Attributes 


By connecting a field socket to the group output node, you 
can create custom Attributes from a Field output of any 
node in the node tree. The domain of the attribute must be 
specified in the group node’s output properties. Note, this 
does not work with Instanced Data. 


The attribute name used by default when using the node 
group in a modifier for the first time is defined in the node 


Internal Dependencies 


This panel displays information about all custom named 
attributes used by the node group. More information is 
available in the geometry nodes inspection page. 


Mask Modifier 


The Mask modifier allows vertices of an object to be hidden 
dynamically based on vertex groups. 


Options 


Mode 
The Mask Modifier can hide parts of a mesh based on two 
different modes, selectable from this select menu. 


Vertex Group 
Hides all vertices not included in the chosen vertex 
group. 


The Mask modifier in Vertex Group mode. 


Armature 
When in Pose Mode, vertices belonging to the vertex 
group associated with the active bone (same names) 
will be visible. Vertices not in that group will be 
hidden. 


The Mask modifier in Armature mode. 


Smooth 
When using Vertex Group Mode, use weights to cut faces 
at the weight contour. This option will result in a mask 
that has smoother removing the sharp edges along the 
mask edges. 


Weights Smooth Mask Normal Mask 


oh 


Invert 
Normally, vertices belonging to the selected vertex group 
(or group associated with the active pose bone) will be 
Shown. The /nvert toggle allows you to reverse this 
behavior, instead only showing vertices which do not 
belong to the vertex group. 


Threshold 
Hides vertices with weights less than or equal to this 
value. 


Mesh to Volume Modifier 


The Mesh to Volume modifier uses a mesh to create a new 
volume grid. All previously existing volume grids on the 
volume object are discarded. So this modifier is usually 
added to an empty volume object. The new volume grid is 
called “density”. 


Tip 


To copy and move the generated volume separately from 
the mesh object, use a collection instance. 


Options 


Object y £3 Mesh to Volume i v x 
The mesh object that Object 
determines where the Density 1.000 
volume data will be ¥ Fill Volume 
gene rated. Exterior Band Width 0.100 


D ens ity Resolution Mode Voxel Amount 
Makes the generated Voxel Amount #5 
volume appear denser or 
less dense when The Mesh to Volume modifier. 


rendering. 


Fill Volume 
The entire enclosed volume or otherwise only the voxels 
close to the surface will get a density greater than zero. 


This setting is only used when the mesh object is 
Manifold. 


Exterior Band Width 


The maximum distance of the included voxels to the 
surface on the outside of the mesh. 


Interior Band Width 


The maximum distance of the included voxels to the 
surface on the inside of the mesh. Activating Fill Volume 
is similar to increasing the interior band width to a high 
number. 


Resolution Mode 
Mode for how the voxel size is specified. 


Voxel Amount 
This allows setting an approximate number of voxels 
that will be used to represent mesh along its diagonal. 
When the dimensions of the mesh changes, the voxel 
size will change as well. For final rendering of 
animations, it’s better to specify the voxel size 
explicitly to avoid artifacts. 


Voxel Size 
This allows setting the exact voxel size that will be 
used. This is idea for rendering when the voxel size 
should not change between frames. 


Example 


Converting Suzanne to a volume. 


Mirror Modifier 


The Mirror modifier mirrors a mesh along its local X, Y 
and/or Z axes, across the Object Origin. It can also use 
another object as the mirror center, then use that object’s 
local axes instead of its own. 


Options 


Axis y $3 Mirror 
The X, Y, Z axis along fee 
which to mirror, i.e. the Bisect 
axis perpendicular to the Flip 


mirror plane of Mirror Object ‘mt 
symmetry. Clipping 

Merge 4 0.001 m 
To understand how the 
axis applies to the mirror 
direction, if you were to 
mirror on the X axis, the 
positive X values of the 
original mesh would 
become the negative X 
values on the mirrored 
side. 


v Data 
Mirror U 
Vv 


Offset U 0.0000 
Vv 0.0000 


¥ Vertex Groups 


Flip UDIM 


The Mirror modifier. 
You can select more than 
one of these axes. And 
will then get more mirrored copies. With one axis you get 
a single mirror, with two axes four mirrors, and with all 
three axes eight mirrors. 


Bisect 


If the mesh is already on both sides of the mirror plane, it 
is cut by that plane, and only one side (the “negative” 
one by default) is kept to perform the mirror process. 


Flip 
When Bisect is enabled on an axis, you can use this 
setting to switch the side kept and mirrored (i.e. when it 
is enabled, the “positive” side will be kept, instead of the 
“negative” one). 


Mirror Object 
An Object Selector to select an object (usually an empty), 
which position and rotation will be used to define mirror 
planes (instead of using the ones from the modified 
object). 


You can animate it to move the mirror axis. 


Clipping 
Prevents vertices from moving through the mirror 
plane(s) when you transform them in Edit Mode. 


If it is enabled but vertices are beyond the mirror plane 
and outside of the Merge Distance, the vertices will not 
be merged. But as soon as the vertices are within Merge 
Distance they are snapped together and cannot be 
moved beyond the mirror plane. 


Note 


Vertices on the mirror plane will be unable to move 
away from the mirror plane as long as Clipping is 
enabled. You must disable it to be able to move the 
vertices along the mirror axis again. 


Merge 


Where a vertex is in the same place (within the Merge 
Distance) as its mirror it will be merged with the mirrored 
vertex. 


Merge Distance 
The maximum distance between a vertex and its 
mirror copy at which they are merged together (being 
Snapped on the mirror plane). Needs Merge to be 
enabled. 


Bisect Distance 


Distance from the bisect plane within which vertices are 
removed. 


Data 


Flip UV 


With this option you can mirror the UV texture 
coordinates across the middle of the image. 


E.g. if you have a vertex with UV coordinates of (0.3, 
0.9), its mirror copy will have UV coordinates of (0.7, 
0.1). 


UV Offsets 


Amount to shift mirrored UVs on the U/V axes. 


It’s useful for baking (as overlapping UVs can cause 
artifacts to appear in the baked map), so the UVs can be 
moved outside the image and not used for baking, but 
still be used for display. 


Vertex Groups 


Try to mirror existing vertex groups, with the following 
specific prerequisites: 


e The vertex groups you want to mirror must be named 
following the usual left/right pattern (i.e. with suffixes 
like “.R”, “.right”, “.L’, etc.). 

e The mirror side vertex group must already exist (it 
will not be created automatically). It must also be 
completely empty (no vertices assigned to it). 


Flip UDIM 
Mirror the texture coordinates around each tile center. 


Hints 


Many modeling tasks involve creating objects that are 
symmetrical. This modifier offers a simple and efficient way 
to do this, with real-time update of the mirror as you edit it. 
Once your modeling is completed you can either click Apply 
to make a real version of your mesh, or leave it as-is for 
future editing. 


Accurately Positioning the Mirror Plane 


To apply a Mirror modifier, it is common to have to move the 
Oobject’s origin onto the edge or face that is to be the axis 
for mirroring. This can be tricky when attempted visually. 


A good technique to achieve an exact position is to select 
the edge, then snap Cursor to Selection. This will position 
the 3D Cursor in the center of the edge. Finally, use the Set 
Origin menu, and select Origin to 3D Cursor. This will move 
the object’s origin (and thus, the mirror plane) to where the 
3D cursor is located, and the mirroring will be exact. 


An alternative is to use an empty as a Mirror Object that you 
move to the correct position. 


Multiresolution Modifier 


The Multiresolution modifier (often shortened to “Multires”) 
gives you the ability to subdivide a mesh similarly to the 
Subdivision Surface modifier, but also allows you to edit the 
new subdivision levels in Sculpt Mode. 


Note 


Multiresolution is the only modifier that cannot be 
repositioned in the stack after any modifier that will 
change geometry or other object data (i.e. all Generate, 
some Modify and some Simulate modifiers cannot come 
before the Multiresolution one). 


Options 


Levels Viewport 
Set the level of subdivisions to show in Object Mode. 


Sculpt 
Set the level of subdivisions to use in Sculpt Mode. 


Render 
Set the level of subdivisions to show when rendering. 


Sculpt Base Mesh 
Makes sculpt-mode tools deform the base mesh instead 
of the displaced mesh, while previewing the 
displacement of higher subdivision levels. This allows you 
to see the propagation of strokes in real-time, which 
enables to use complex tools like Cloth or Pose in much 


higher resolutions 
without surface noise 
and artifacts. 


Optimal Display 
When rendering the 
wireframe of this object, 
the wires of the new 
subdivided edges will be 
Skipped (only displays 
the edges of the original 
geometry). 


Subdivisions 


Subdivide 


vy WH! Multires 


Level Viewport 
Sculpt 


Render 
¥ Optimal Display 
¥ Subdivisions 
Subdivide 
Simple Linear 
Unsubdivide 
Delete Higher 
v Shape 
Reshape Apply Base 
y Generate 
Rebuild Subdivisions 
Save External... 
vy Advanced 


Subdivision Type Catmull-Clark 
Quality 4 

UV Smooth Smooth, keep corners 
¥ Use Creases 


Use Custom Normals 


The Multiresolution modifier. 


Creates a new level of subdivision using the type 
specified by Subdivision Type (see below). 


Simple 


Creates a new level of subdivision using a simple 
interpolation by subdividing edges without any 
smoothing. 


Linear 
Creates a new level of subdivision using linear 
interpolation of the current sculpted displacement. 


Unsubdivide 
Rebuild a lower subdivision level of the current base 
mesh. 


Delete Higher 
Deletes all subdivision levels that are higher than the 
current one. 


Shape 


Reshape 
Copies vertex coordinates from another mesh. 


To use it, first select a different mesh object with 
matching topology and vertex indices, then Shift select 
the object you wish to copy vertex coordinates to, and 
click Reshape. 


Apply Base 
Modifies the original unsubdivided mesh to match the 
form of the subdivided mesh. 


Generate 


Rebuild Subdivisions 
Rebuilds all possible subdivisions levels to generate a 
lower resolution base mesh. This is used to create an 


optimized multiresolution version of a pre-existing sculpt. 
This option is only available when no subdivision level 
have been created through the modifier. 


Save External 


Saves displacements to an external .btx file. 


Advanced 


Quality 


How precisely the vertices are positioned (relatively to 
their theoretical position), can be lowered to get a better 
performance when working on high-poly meshes. 


UV Smooth 


How to handle UVs during subdivision. 


None: UVs remain unchanged. 

Keep Corners: UV islands are smoothed, but their 
boundary remain unchanged. 

Keep Corners, Junctions: 
UVs are smoothed, corners on 
discontinuous boundary and junctions 
of three or more regions are kept 
sharp. 

Keep Corners, Junctions, Concave: 
UVs are smoothed, corners on 
discontinuous boundary, junctions of 
three or more regions and darts and 
concave corners are kept sharp. 

Keep Boundaries: 
UVs are smoothed, boundaries are kept 
sharp. 

All: UVs and their boundaries are 
smoothed. 


Boundary Smooth 
Controls how open boundaries (and corners) are 
smoothed. 


All: Smooth boundaries, including corners. 
Keep Corners: Smooth boundaries, but corners are 
kept sharp. 


Use Creases 
Use the Weighted Edge Creases values stored in edges to 
control how smooth they are made. 


Use Custom Normals 
Interpolates existing Custom Split Normals of the 
resulting mesh. 


Remesh Modifier 


The Remesh modifier is a tool for generating new mesh 
topology. The output follows the surface curvature of the 
input, but its topology contains only quads. 


Options 


Mode vy (fh Remesh ism™Ooy~ x 
There are three basic 
modes available in the 
Remesh modifier. The 
output topology is almost 
identical between the 
three modes, what 
changes is the The Remesh modifier. 
Smoothing. 


Blocks Smooth Sharp Voxel 


Voxel Size 0.1m 
Adaptivity Om 


Smooth Shading 


Blocks 
There is no smoothing at all. 


Smooth 
Output a smooth surface. 


Sharp 


Similar to Smooth, but preserves sharp edges and 
corners. 


Sharpness 
Higher values produce edges more similar to the 
input, while lower values filter out noise. 


Voxel 


Uses an OpenVDB to generate a new manifold mesh 
from the current geometry while trying to preserve 
the mesh’s original volume. 


Adaptivity 
Reduces the final face count by simplifying 
geometry where detail is not needed. This 
introduce triangulation to faces that do not need as 
much detail. 


Smooth Shading 
Outputs faces with Smooth Shading instead of flat 
Shading. 


Octree Depth 
Sets the resolution of the output. Low values will 
generate larger faces relative to the input, higher values 
will generate a denser output. 


Scale 
The result can be tweaked further by this, lower values 
effectively decrease the output resolution. 


Remove Disconnected 
Filter out small disconnected pieces of the output. 


Thin parts of the input mesh can become lose, and 
generate small isolated bits of mesh. This option will 
remove those. 


Threshold 
Use this to control how small a disconnected 
component must be to be removed. 


Smooth Shading 


Output faces with smooth shading rather than flat 
Shading. The smooth/flat shading of the input faces is not 
preserved. 


Note 


The input mesh should have some thickness to it. If the 
input is completely flat, add a Solidify Modifier above the 
Remesh one. 


Examples 


Blocks Smooth 
Unmodified mode with mode with 
mesh. Octree Octree 

Depth 3. Depth 3. 


] 


Sharp Sharp Sharp 
mode with mode with mode with 
Octree Octree 


Depth 3. Depth 4. 


Octree 
Depth 2. 


The Remesh Modifier applied to a text to improve its 
topology. 


Animated Example 


Screw Modifier 


The Screw modifier is similar to the Screw tool in the 
Toolbar, in that it takes a profile object, a mesh or a curve, 
to create a helix-like shape. 


Properly aligning the profile object is important. 


The profile should be properly aligned to the cardinal 
direction of the object rather than to the screw axis. 


Options 
Angle 
Degrees for a single helix revolution. 


Screw 
Offsets the revolution along its axis. 


Iterations 
Number of revolutions. 


Axis 
The axis along which the 
helix will be built. 


Screw 
The height of one 
helix iteration. 


Axis Object 


The name of an object to 
define the axis direction. 


Object Screw 
Use the distance from 
the Axis Object to 
define the height of 
one helix iteration. 


Steps Viewport 
Number of steps used for 
a single revolution 
displayed in the 3D 
Viewport. 


Render 


Screw 


Angle 
Screw 


Iterations 


Axis 


Axis Object 


Steps Viewport 
Render 


Merge 


Stretch UVs 


vy Normals 


Y Smooth Shading 


Calculate Order 


Flip 


The Screw modifier. 


As above, but used during render time. Increase to 


improve quality. 


Merge 


Merge vertices that lie on the axis of rotation. Use this to 
close off end points with a triangle fan. 


Merge Distance 


Vertices under this distance to the axis are merged. 


Stretch UVs 


Stretch the UV coordinates from (0.0 to 1.0) when UVs 
are present. 


Normals 


Smooth Shading 
Output faces with smooth shading rather than flat 
Shading. The smooth/flat shading of the input geometry 
is not preserved. 


Calculate Order 
Order of edges is calculated to avoid problems with 
normals and shading. Only needed for meshes, not 
curves. 


Flip 
Flip normals direction. 


Skin Modifier 


The Skin modifier uses vertices and edges to create a 
Skinned surface, using a per-vertex radius to better define 
the shape. The output is mostly quads, although some 
triangles will appear around intersections. 


It is a quick way to generate base meshes for sculpting 
and/or smooth organic shapes with arbitrary topology. 


Note 


Faces in the original geometry are ignored. 


Options 


Branch Smoothing v SD skin 
A branch point is a 
vertex with three or 
more connected edges. 
These areas tend to 
produce more 
complicated topology, 
some of which may 
overlap. This setting 
relaxes the surface 
around these points, with The Skin modifier. 
the side effect of 
Shrinking it. 


Branch Smoothing 
Symmetry 


Smooth Shading 


Mark Loose Clear Loose 


Mark Root 


Equalize Radii 


Symmetry 


These checkboxes are used to keep the output topology 
symmetrical in their respective axes. In other words, 
using it avoids merging triangles across an axis unless 
the triangles form a symmetric quad. 


Note 


They do not add geometry flipped across an axis. For 
that, the Mirror modifier should be used, typically 
placed above the Skin one. 


Smooth Shading 
Output faces with smooth shading rather than flat 
Shading. The smooth/flat shading of the input geometry 
is not preserved. 


Create Armature 


Create an armature on top of the object. Each edge 
becomes a bone. 


Note 


If the root vertex has more than one adjacent edge, an 
extra bone will be created to serve as the root. 


This tool does the following: 


1. A new armature object is added with bones matching 
the input mesh. The active selection is switched to 
the new armature. 

2. Weight groups are added to the input mesh. The Skin 
modifier propagates these weights to the output as 
well. 

3. An Armature modifier is added directly below the 
Skin one. Note that the Armature modifier is being 
applied after the Skin one because it should only 


deform the output, whereas if it were above, it might 
change the resulting topology. 


Add Skin Data 
This modifier uses a custom set of data in the mesh, that 
is generated automatically when you add the modifier 
the first time. 


However, you may remove that data, or loose it some 
way or the other. That operator will generate it again. 


Mark/Clear Loose 


By default, a branch vertex (vertex with three or more 
connected edges) will generate extra edge loops along 
adjacent edges in order to keep the output tight. 
Branches can be made loose by clicking Mark Loose, 
which will allow the output to stretch between all 
adjacent vertices. This can be disabled again by clicking 
Clear Loose. 


Mark Root 
Marking a vertex as root causes that vertex to be used 
for calculating rotations for connected limbs. Root 
vertices also affect the armature output, they will be 
used as the origin for the root bones. 


Each set of connected vertices should have one root 
node (one is selected by default if you do not assign any 
manually). Mark Root enforces the one-root per set rule, 
so it is not necessary to manually unmark roots. 


Equalize Radii 


Makes the skin radii of selected vertices equal on each 
axis. 


Skin Mesh Data 


That modifier needs a set of specific data in the original 
mesh to work properly. This data allows you to define the 
root vertices of each tree, which ones are loose, and the size 
(radius) of the skin at each vertex. The radii of input vertices 
can be individually scaled in Edit Mode with the Skin Resize. 


Examples 


Simple creature, made with only the Skin and 
Subdivision Surface modifiers. 


External Links 


e Skin Modifier Development at Blender Nation - An early 
demonstration of the Skin Modifier by Nicholas Bishop 
(March 2011). 

e Ji, Zhongping; Liu, Ligang; Wang, Yigang (2010). B-Mesh: 
A Fast Modeling System for Base Meshes of 3D 
Articulated Shapes, Computer Graphics Forum 29(7), pp. 
2169-2178. - The work this modifier is based on (DOI 
10.1111/j.1467-8659.2010.01805.x). 

e Related thread on Blender artists. 


Solidify Modifier 


The Solidify modifier takes the surface of any mesh and 
adds depth, thickness to it. 


Options 


¥ (J Solidify 


YEEBey x 7 Eig. x 


y¥ (J  Solidify 


Mode 
Thickness 


Offset 


Rim 


Vertex Group 


y Normals 


v Materials 
Material Offset 

Rim 
v Edge Data 


Crease Inner 
Outer 
Rim 


Bevel Convex 


Simple 
0.01 m 
-1.0000 
Even Thickness 


V Fill 
Only Rim 


Flip 
High Quality 


Y Thickness Clamp 


Clamp 


¥Y Output Vertex Groups 


Shell 


Rim 


v 


Mode 

Thickness Mode 
Boundary 
Thickness 
Offset 


Merge Threshold 


Complex 
Constraints 
None 
0.01 m 
-1.0000 


0.0001 m 


Rim @ Fill 


Only Rim 


Vertex Group gm 


y¥ Normals 


¥ Materials 
Material Offset 
Rim 


v Edge Data 


Bevel Convex HP ahooo 


¥ Thickness Clamp 


Clamp 


¥ Output Vertex Groups 


Shell 


Rim 


The Solidify modifier 


The Solidify modifier 
in complex mode. 


in simple mode. 


Mode 
Simple 


This is the default solidify algorithm, which simply 
extrudes the geometry. This algorithm does not work 


on geometry where edges have more than two 
adjacent faces. 


Important 


If the normals of adjacent faces don’t point into the 
Same general direction, simple mode will not be able 
to solidify the boundary between those. This 
happens if the normals are not recalculated or for 
example on one-sided surfaces like a Mobius strip. 


Complex 


This is a solidify algorithm which can handle every 
geometric situation to guarantee a manifold output 
geometry. This algorithm is able to solidify shapes like 
Mobius strips, Klein bottles, architectural wall layouts 
and many more which the Simple Mode isn’t able to 
do. If the special cases are not present it is 
recommended to choose Simple because the extra 
logic makes this algorithm much slower. 


Note 


There are no options for crease in the Modifier tab 
because crease is handled in a dynamic way. The 
modifier will transfer the creases of the original 
mesh in a smart way to the output mesh to work 
with the Subdivision Surface modifier. 


Thickness Mode Complex Mode 
Choose the kind of thickness handling (thickness solver). 


Simple -> Complex, Fixed -> Complex, Even -> Complex, Constraints 
self-intersecting manifold perfect 


Different thickness options on a non-manifold 
mesh. 


Fixed 
This is similar to Simple Mode without Even Thickness. 


The new vertices are always in a fixed distance to the 
old ones. 


Even 
This is similar to Simple Mode with Even Thickness 
and High Quality Normals. |t adjusts for sharp corners, 
but may not always work when more than three faces 


come together. 


Constraints 
This is a more advanced model to try to always get 
the optimal thickness everywhere. For up to three 
faces it is always guaranteed to find an optimal 
solution. 


Boundary Complex Mode 
Choose the kind of boundary that suits the model the 
most. 


Different boundary options with a matCap. 


None 
No boundary fix is applied. Results are stable. 


Round 
Adjusts the boundary for an opening to face inwards 


(like a hole in an egg). 


Flat 
Adjusts the boundary of a planar opening to be a flat 


(like a cut sphere). 


Thickness 
The depth to be solidified. 


Important 

The modifier thickness is calculated using local vertex 
coordinates. If the object has a non-uniform scale, the 
thickness will vary on different sides of the object. 


To fix this, either Apply or Clear the scale. 
Offset 


A value between (-1 to 1) to locate the solidified output 
inside or outside the original mesh. The inside and 


outside is determined by the face normals. Set to 0.0, the 
solidified output will be centered on the original mesh. 


Even Thickness Simple Mode 


Maintain thickness by adjusting for sharp corners. 
Sometimes improves quality but also increases 
computation time. 


Merge Threshold Complex Mode 
Distance within which degenerated geometry is merged. 


Rim 

Fill 
Fills the gap between the inner and outer edges. 

Only Rim 
In Simple Mode: Will not extrude surfaces parallel to 
the original one, but instead will only add the 
perpendicular rim. 
In Complex Mode: Will only leave the generated 
perpendicular rim. 

Note 


Fill and Only Rim only make a difference on Non- 
manifold objects, since the rims are generated from the 
borders of the original geometry. 


Vertex Group 
The weights of the selected vertex group are multiplied 
onto the Thickness, so vertices with lower weights will be 
less thick. The vertices which are not part of the vertex 
group will be used as if their weight was zero. 


Invert 


Reverses the vertex group weights, so that the used 
weight is one minus the actual weight. 


Factor 
How much the vertex weights are taken into account. 


e On 0.0 , vertices with zero weight will have no 
thickness at all. 
e On 0.5 , vertices with zero weight will be half as 
thick as those with full weight. 
e On 1.0 , the weights are ignored and the 
Thickness value is used for every vertex. 
Flat Faces Complex Mode 
Use the minimal vertex weight assigned to the 
vertices of a face to make sure that new faces stay 
parallel to their original ones. This is slow, so disable it 
when it is not needed. 


Note 

If the final thickness of a vertex is zero, it will still be 
solidified. Therefore creating duplicate geometry, which 
sometimes needs extra care. 


Normals 


Flip Normals 
Reverse the normals of all geometry (both the inner and 
outer surfaces). 


High Quality Normals Simple Mode 
Normals are calculated to produce a more even 
thickness. Sometimes improves quality but also increases 
computation time. 


Materials 


Material Offset 
Choose a different material slot index to use for the new 
geometry. This is applied as an offset from the original 
material of the face from which it was solidified. 


e A value of 0 means it will use the same material. 

e A value of 1 means it will use the material 
immediately below the original material. 

e A value of -2 means the material two positions above 
the original material will be used. 


These are clamped to the top-most and bottom-most 
material slots. 


Rim 


Similarly, you can give another material to the rim faces. 


Edge Data 


Inner Simple Mode 
Set a crease to the inner edges. 


Outer Simple Mode 
Set a crease to the outer edges. 


Rim Simple Mode 
Set a crease to the rim. 


Bevel Convex 
Edge bevel weight to be added to outside edges. 


Edges which will get creases marked. 


Thickness Clamp 


Clamp 
A value between (0 to 2) to clamp offsets to avoid self- 
intersection. The amount is determined by the length of 
the shortest adjacent edge. 


No Clamp Simple/Complex 


= 


st JT 


Simple + Complex + 
Angle Clamp Angle Clamp 


Clamp Offset. 


Angle Clamp 


If enabled clamping will also consider angles in the 
geometry, not only lengths. 


Output Vertex Groups 


Shell 
Vertex group that the generated shell geometry will be 
weighted to. This allows you to use other modifiers to 
only affect the shell geometry by using a that modifier’s 
vertex group influence control. 


Rim 
Same as Shell Vertex Group, but for the generated rim 
geometry. 


Known Limitations 


Even Thickness 


Solidify thickness is an approximation. While Even Thickness 
and High Quality Normals should yield good results, the final 
wall thickness is not guaranteed and may vary depending 
on the mesh topology. Especially for vertices with more than 
three adjacent faces. 


In order to maintain a precise wall thickness in every case, 
we would need to add/remove faces on the offset shell, 
something this modifier does not do since this would add a 
lot of complexity. The best option to preserve wall thickness 
is complex mode with constraints thickness mode, but it is 
also not guaranteed to work perfect in every case. 


Subdivision Surface 
Modifier 


The Subdivision Surface modifier (often shorten to “Subdiv”) 
is used to split the faces of a mesh into smaller faces, giving 
it a smooth appearance. It enables you to create complex 
smooth surfaces while modeling simple, low-vertex meshes. 
It avoids the need to save and maintain huge amounts of 
data, and gives a smooth “organic” look to the object. 


As with any modifier, order of execution (position in the 
modifier stack) has an important bearing on the results. 


Keep in mind that this is a different operation than its 
companion, Smooth Shading. You can see the difference 
between the two in the grid image below. 


: 


Subdivision levels 0 to 3, without and with Smooth 
Shading. 


Tip 


The Subdivision Surface modifier does not allow you to edit 
the new subdivided geometry without applying it, but the 
Multiresolution modifier does (in Sculpt Mode). 


Note 


This modifier uses the OpenSubdiv library as a backend. 


Options 

Catmull-Clark vy [O|__ Subdivision Vitmmoey,y x 
Subdivides and Catmull-Clark Simple 
smooths the surfaces Pea 7 
to create a more Render 2 
pleasant looking Y Optimal Display 


mesh. According to 
its Wikipedia page, 
the “arbitrary-looking 
formula was chosen 


vy Advanced 


Quality 3 


UV Smooth Smooth, keep corners ve 


by Catmull and Clark Y Use Creases 
based on the Use Custom Normals 
aesthetic appearance 

of the resulting The Subdivision Surface modifier. 


surfaces rather than 
on a mathematical 
derivation.” 


Simple 
Only subdivides the surfaces, this often does not provide 
any smoothing unless the surface is non-coplanar (the 
same as the Subdivide operator, in Edit Mode). To work 
around this behavior for non-coplanar geometry, 
triangulate to ensure all geometry is coplanar. 


Simple mode can be used, for example, to increase the 
base mesh resolution when using displacement maps. 


Levels Viewport, Render 


The number of subdivision levels shown in the 3D 
Viewport or the final render. 


Warning 


Higher levels of subdivisions results in more vertices, 
which means higher memory consumption (both system 
RAM, and video memory for display). This can cause 
Blender to hang or crash if not enough memory is 
available. 


Tip 

The right combination of these settings will allow you to 
keep a fast and lightweight approximation of your 
model when interacting with it in the 3D Viewport, but 
use a higher quality version when rendering. 


Be careful not to set the Viewport subdivisions higher 
than the Render subdivisions, this would mean that the 
quality in the 3D Viewport will be higher than the 
rendered. 


Optimal Display 
When rendering the wireframe of this object, the wires of 
the new subdivided edges will be skipped (only displays 
the edges of the original geometry). 


Advanced 


Use Limit Surface 


Places vertices at the surface that would be produced 
with infinite levels of subdivision (smoothest possible 
shape). 


Quality 
When Use Limit Surface is enabled this property controls 
how precisely vertices are positioned on the limit surface 
(relatively to their theoretical position of an infinitely 
subdivided mesh). It can be lowered to get a better 
performance. 


Using higher values does not necessarily mean real 
improvement in quality, ideal results might be reached 
well before the maximum Quality value. 


Note 


This value can affect the accuracy of Edge Creases; 
using a higher Quality value will allow for a wider range 
of crease values to work accurately. 


UV Smooth 
Controls how subdivision smoothing is applied to UVs. 


None: UVs remain unchanged. 

Keep Corners: UV islands are smoothed, but their 
boundary remain unchanged. 

Keep Corners, Junctions: 
UVs are smoothed, corners on 
discontinuous boundary and junctions 
of three or more regions are kept 
Sharp. 

Keep Corners, Junctions, Concave: 


UVs are smoothed, corners on 
discontinuous boundary, junctions of 
three or more regions and darts and 
concave corners are kept sharp. 

Keep Boundaries: 
UVs are smoothed, boundaries are kept 
Sharp. 

All: UVs and their boundaries are 
smoothed. 


Boundary Smooth 
Controls how open boundaries (and corners) are 
smoothed. 


All: Smooth boundaries, including corners. 
Keep Corners: Smooth boundaries, but corners are 
kept sharp. 


Use Creases 
Use the Weighted Edge Creases values stored in edges to 
control how smooth they are made. 


Use Custom Normals 
Interpolates existing Custom Split Normals of the 
resulting mesh. Otherwise, new faces will have the 
overall normal orientation of that original face. 


Keyboard Shortcuts 


To quickly add a Subdivision Surface modifier to one or more 
objects, select the object(s) and press ctri-1. That will add a 
Subdivision Surface modifier with Viewport subdivisions set 
to 1. You can use other numbers too, such as Ctrl-2, Ctrl-3, 
etc, to add a modifier with that number of subdivisions. 


Adding a Subdivision Surface modifier in this fashion will not 
modify the Render subdivisions. 


If an object already has a Subdivision Surface modifier, 
doing this will simply change its subdivision level instead of 
adding another modifier. 


Control 


Catmull-Clark subdivision rounds off edges, and often this is 
not what you want. There are several solutions that allow 
you to control the subdivision. 


Weighted Edge Creases 


Weighted edge creases for subdivision surfaces allows you 
to change the way the Subdivision Surface modifier 
subdivides the geometry to give the edges a smooth or 
sharp appearance. 


Y Transform 


Median: 


IZ 
Global 
Vertices Data: 


Mean Bevel Weight 0.00 


Edges Data: 
Mean Bevel Weight 0.00 


Mean Crease O10) 


A subdivided cube with creased edges. 


The crease weight of selected edges can be changed in the 

Transform panel, Sidebar of the 3D Viewport. The scale-like 

dedicated tool Shift-E can also be used to adjust the crease 

weight. A higher value makes the edge “stronger” and more 
resistant to the smoothing effect of subdivision surfaces. 


Edge Loops 


Subdivision Level 2 cube, the same with an extra 
Edge Loop, and the same with six extra Edge Loops. 


The Subdivision Surface modifier demonstrates why good, 
clean topology is so important. As you can see in the figure, 
it has a drastic effect on a default cube. Until you add in 
additional loops (with e.g. Loop Cut and Slide), the shape is 
almost unrecognizable as a cube. 


A mesh with deliberate topology has good placement of 
edge loops, which allow the placement of more loops (or 
their removal) to control the sharpness/smoothness of the 
resultant mesh. 


Known Limitations 


Non-Contiguous Normals 


Abrupt normal changes will prevent portions of the mesh 
from producing a smooth subdivision. Instead, these 
portions with non-contiguous normals will be subdivided 
using the “Simple” subdivision method. 


Comparison of good Side view of image 
normals and bad on the left. 
normals. 


A quick way to fix this is to Recalculate Normals. If this does 
not work you may have to manually flip the normals. 


Triangulate Modifier 


The Triangulate modifier converts all faces in a mesh (quads 
and n-gons) to triangular faces. It fulfills the exact same 
function as the Triangulate tool in Edit Mode. 


Mesh before 
Triangulate modifier. 


Options 


Quad Method 
Beauty 
Split the quads in nice 
triangles, slower 
method. 


Fixed 
Split the quads on 
their 1st and 3rd 
vertices. 


Fixed Alternate 


Mesh after 
Triangulate modifier. 
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Quad Method Shortest Diagonal ve 


y¥{ __ Triangulate 


Polygon Method Beauty ve 


Minimum Vertices 4 


Keep Normals 


The Triangulate modifier. 


Split the quads on their 2nd and 4th vertices. 


Shortest Diagonal 
Split the quads along their shortest diagonal. 


Longest Diagonal 
Split the quads along their longest diagonal. This is 
the preferred mode for cloth simulations. 


N-gon Method 
Beauty 
Arrange the new triangles nicely, slower method. 


Clip 
Splits n-gons using an ear-clipping algorithm (gives 
similar results to the tessellation used for the viewport 
rendering). 


Minimum Vertices 
Minimum number of vertices a face must have to be 
triangulated. For example, setting this value to 5, will 
prevent triangulation of Quads and only triangulate N- 
gons. 


Keep Normals 
When using custom normals, try to preserve the same 
Shading as before triangulation. 


Volume to Mesh Modifier 


This modifier is the inverse of the Mesh to Volume modifier. 
It takes an existing volume object and converts one of its 


grids to a mesh. Only scalar grids (Such as the density grid) 
can be converted. 


Tip 


To copy and move the generated mesh separately from the 
volume object, use a collection instance. 


Options 
Object y £3 Volumeto Mesh 
The source volume Object ‘wr 
O bj ect. GridName density 
Resolution Mode Grid 
Grid Name Threshold 0.10000 
The name of the grid Perle ey 
that will be converted. mbes 


This has to be a scalar 
grid. 


The Volume to Mesh modifier. 


Resolution Mode 


Mode for how the resolution of the final mesh is 
controlled. 


Grid 
This makes the resolution dependent on the resolution 
of the grid that is converted. Higher resolution grids 


result in a higher resolution mesh. In many cases, that 
is the most efficient mode. 


Voxel Amount 
Specifies the approximate resolution of the final mesh. 
The voxel size is adapted to the size of the entire 
volume. 


Voxel Size 
Use a fixed resolution that does not change when the 
volume changes. 


Threshold 


Voxels with a larger value are considered to be inside the 
mesh and all other voxels outside. The mesh will be 
generated on the boundary of inside and outside voxels. 
This is sometimes also called the “iso value”. 


Adaptivity 
This is similar to decimating the final to reduce resolution 
where it is not needed. 


Smooth Shading 
Enables smooth shading on the generated mesh. 


Example 


Converting a cloud-shaped volume to a mesh. 


Weld Modifier 


The Weld modifier looks for groups of vertices within a 
threshold and merges them, collapsing the surrounding 
geometry. 


Options 
Weld VYitm@moy x 
Mode Connected ve 
Distance 0.001 m 
Only Loose Edges 
Vertex Group &s 
The Weld modifier. 
Mode 
Method for choosing which vertices are merged. 
All: Merge includes all geometry including 
loose parts. 
Connected: Merge only includes attached geometry 


il.e. the modifier will not merge loose 
parts together. 


Distance 


Maximum distance that the vertices must have each 
other to be merged. 


Only Loose Edges Connected Mode 
Only collapse short edges which are not adjacent to any 
face. This is useful for example to stitch the seams used 


in cloth simulations. 


Vertex Group 


When the Vertex Group option is selected, only vertices 
with weight above zero will be affected by the modifier. 


Invert <-> 


Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be merged by the modifier. 


The setting reverses the weight values of the group. 


Wireframe Modifier 


The Wireframe modifier transforms a mesh into a wireframe 
by iterating over its faces, collecting all edges and turning 
those edges into four-sided polygons. Be aware of the fact 
that your mesh needs to have faces to be wireframed. You 
can define the thickness, the material and several other 
parameters of the generated wireframe dynamically via the 
given modifier options. 


Options 


Thickness y Wireframe i*mo~r x 
The depth or size of the 
wireframes. 


Thickness 0.02 m 


Offset 0.0000 


Offset = sel 
A value between (-1 to 1) niger 
to change whether the 
wireframes are 
generated inside or 
outside of the original 
mesh. Set to zero, Offset v Vertex Group 
will center the 
wireframes around the 
Original edges. 


Thickness 4 Even 


Relative 
Crease Edges 


Material Offset 


Vertex Group &8 


Boundary The Wireframe modifier. 
Creates wireframes on 
mesh island boundaries. 


Replace Original 


If this option is enabled, the original mesh is replaced by 
the generated wireframe. If not, the wireframe is 
generated on top of it. 


Thickness 
Even 
Maintain thickness by adjusting for sharp corners. 


Sometimes improves quality but also increases 
computation time. 


Relative 


Determines the edge thickness by the length of the 
edge. Longer edges will be thicker. 


Crease Edges 


This option is intended for usage with the Subdivision 
modifier. Enable this option to crease edges on their 
junctions and prevent large curved intersections. 


Crease Weight 


Define how much crease (0 to 1, nothing to full) the 
junctions should receive. 


Material Offset 


Uses the chosen material index as the material for the 


wireframe; this is applied as an offset from the first 
material. 


Warning 


Wireframe thickness is an approximation. While Even 
Thickness should yield good results in many cases, skinny 
faces can cause ugly spikes. In this case you can either 
reduce the extreme angles in the geometry or disable the 
Even Thickness option. 


Vertex Group 


The weights of the selected vertex group are multiplied onto 
the Thickness, so vertices with lower weights will be less 
thick. The vertices which are not part of the vertex group 
will be used as if their weight was zero. 


Invert 
Reverses the vertex group weights, so that the used 
weight is one minus the actual weight. 


Factor 
How much the vertex weights are taken into account. 


e On 0.0 , vertices with zero weight will have no 
thickness at all. 

e On 0.5 , vertices with zero weight will be half as thick 
as those with full weight. 

e On 1.0 , the weights are ignored and the Thickness 
value is used for every vertex. 


Note 
If the final thickness of a vertex is zero, it will still generate 


a wireframe. Therefore creating duplicate geometry, which 
sometimes needs extra care. 


Examples 


Wireframes on a displaced plane. 


In this example, the wireframes carry a second (dark) 
material while the displaced plane uses its original one. 


Vertex group weighting. 


The weights of the vertex group gradually change from 0 to 
1. 


Wireframe and Subdivision Surface modifier. 


Cube with enabled Crease Edges option. The Crease Weight 
is set to 0, 0.5 and 1. 


Armature Modifier 


The Armature modifier is used for building skeletal systems 
(rigs) for animating the poses of characters and anything 
else which needs to be posed. 


By adding an armature system to an object, that object can 
be deformed accurately so that geometry does not have to 
be animated by hand. 


See also 


For more details on armatures usage, see the armature 
section. 


Options 


Object 
The name of the 
armature object used by 
this modifier. 


vy X Armature ‘Vf ES Mey x 


Object |™@, Armature Xx 
Vertex Group #82 o 
Preserve Volume 

Vertex Group Multi Modifier 

A vertex group of the Bindto W Vertex Groups 

object, which weights will 

be used to determine the 

influence of this The Armature modifier. 

modifier’s results when 

mixing it with the results 

from other Armature ones. 


Bone Envelopes 


Only meaningful when having at least two of these 
modifiers on the same object, with Multi Modifier 
activated. 


Invert <-> 
Inverts the influence set by the vertex group defined 
In previous setting (i.e. reverses the weight values of 
this group). 


Preserve Volume 


Use quaternions for preserving volume of object during 
deformation. It can be better in many situations. 


Without it, rotations at joints tend to scale down the 
neighboring geometry, up to nearly zero at 180 degrees 
from rest position. With it, the geometry is no longer 
scaled down, but there is a “gap”, a discontinuity when 
reaching 180 degrees from rest position. 


Example of Preserve Volume effects. Note that the 
icosphere is deformed using the envelopes weights. 


100° 180° 
es rotation, rotation, 
Initial 
Preserve Preserve 
state. 
Volume Volume 
disabled. disabled. 


100° 179.9° 


rotation, rotation, 

Preserve Preserve 

Volume Volume 

enabled. enabled. 180.1° 
rotation, 
Preserve 
Volume 
enabled. 

Multi Modifier 


Use the same data as a previous modifier (usually also 
an Armature one) as input. This allows you to use several 
armatures to deform the same object, all based on the 
“non-deformed” data (i.e. this avoids having the second 
Armature modifier deform the result of the first one...). 


The results of the Armature modifiers are then mixed 
together, using the weights of the Vertex Group as 
“mixing guides”. 


Tip 
Armature modifiers can quickly be added to objects by 
parenting them to an armature. 


Bind to 
Methods to bind the armature to the mesh. 


Vertex Groups 
Meshes and lattices only. When enabled, bones of a 
given name will deform vertices which belong to 
vertex groups of the same name. E.g. a bone named 


“forearm”, will only affect the vertices in the 
“forearm” vertex group. 


The influence of one bone on a given vertex is 
controlled by the weight of this vertex in the relevant 
group. A much more precise method than Bone 
Envelopes, but also generally longer to set up. 


Bone Envelopes 


When enabled, bones will deform vertices or control 
points near them, defined by each bone’s envelope 
radius and distance. This lets bone envelopes control 
the deformation (i.e. bones deform vertices in their 
neighborhood). 


Example of skinning methods. 


The weights of The weights of 
the “arm” vertex the “forearm” 
group. vertex group. 


The result when The same pose, 
posing the but using 
armature. envelopes 


method rather 


that vertex 
groups. 


Tip 

When envelopes are disabled, Blender uses the set 
of existing vertex group names to determine which 
bones are actually necessary to evaluate the 
modifier. Removing empty vertex groups helps to 
reduce dependencies, and can be essential if the 
mesh is used during evaluation of other bones in the 


Same armature, e.g. as the target of a Shrinkwrap 
constraint. 


Cast Modifier 


The Cast modifier shifts the shape of a mesh, curve, surface 


or lattice, towards any of a few predefined shapes (sphere, 
cylinder, cuboid). 


It is equivalent to the To Sphere tool in Edit Mode, and what 
other programs call “Spherify” or “Spherize”, but, as written 
above, it is not limited to casting to a sphere. 


Tip 
The Smooth Modifier is a good companion to Cast, since 


the cast shape sometimes needs smoothing to look nicer 
or even to fix shading artifacts. 


Note 


For performance reasons, this modifier only works with 
local coordinates. If the modified object looks wrong, you 


may need to apply its transformations, especially when 
casting to a cylinder. 


Options 


Shape 


Menu to choose target shape of the projection: Sphere, 
Cylinder or Cuboid. 


Axis 


Toggle buttons to ¥@ Cast Pei, x 
enable/disable the 


modifier in the X, Y, Z Seales (Gildiihe “ie 

axes directions (X and Y xs ui 

only for Cylinder cast poe =° 

type, since the Z axis Radius Om 

remains unaffected). Size 0.00 

¥ Size from Radius 

Factor Vertex Group Sar 

The factor to control eee (O 


blending between 


original and cast vertex 
positions. The Cast modifier. 


It is a linear 
interpolation: 0.0 gives original coordinates (i.e. modifier 
has no effect), 1.0 casts to the target shape. 


Values below 0.0 or above 1.0 exaggerate the 
deformation, sometimes in interesting ways. 


Radius 
If nonzero, this radius defines a sphere of influence. 
Vertices outside it are not affected by the modifier. 


Size 
Alternative size for the projected shape. If zero, it is 
defined by the initial shape and the control object, if any. 


Size from Radius 
If activated, calculate Size from Radius, for smoother 
results. 


Vertex Group 
If set, restrict the effect to the only vertices in that vertex 
group. This allows selective, real-time casting, by 


painting vertex weights. 


Invert <-> 


Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Object 


The name of an object to control the effect. The location 
of this object’s origin defines the center of the projection. 
Also, its size and rotation transform the projected 
vertices. 


Hint 


Animating (keyframing) this control object also 
animates the modified object’s casting deformation. 


Example 


> pe 
eS a 


& 1G p PF) 


ee Py — op 


Top: Suzanne without modifiers. Middle: Suzanne 
with each type of Cast Modifier (Sphere, Cylinder 
and Cuboid). Bottom: Same as above, but now only 
X axis is enabled. Sample blend-file. 


Curve Modifier 


The Curve modifier provides a simple but efficient method 
of deforming a mesh along a curve object. 


It works on a (global) dominant axis, X, Y, or Z. This means 
that when you move your mesh in the dominant direction 
(by default, the X axis), the mesh will traverse along the 
curve, as if it was a train following and deforming along 
rails. Moving the mesh perpendicularly to this axis, the 
object will move closer or further away from the curve. 


When you move the object beyond the curve’s ends, the 
object will continue to deform based on the direction vector 
at those ends. 


Note 


This modifier works in global space, in other words, the 
actual position of the geometry relative to the curve is 
determinant to get a correct result. 


Typically, you'll want your object’s origin to be at the 
center of your geometry (not offset far away from it, you 
can e.g. Set Origin to Geometry). 


And then you'll want to start with your object’s origin at 
the same location as your curve object’s origin (you may 
use snap tools for that...). 


If the curve is 3D, the Ti/t value of its control points will be 
used to twist the deformed object. And the Radius property 


controls the size of the object as well. Those options are in 
the Shape panel, under Path/Curve-Deform. 


Options 


Curve Object y > Curve Vimy x 
The name of the curve 
object that will affect the 
deformed object. 


Curve Object ‘m) BezierCurve x 


Deform Axis X ve 


Vertex Group #83 o 


Deformation Axis 


This is the axis that the The Curve modifier. 
curve deforms along. 


X/Y/Z/-X/-Y/-Z 


Vertex Group 
If set, restrict the effect to the only vertices in that vertex 
group. 


Invert <-> 


Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Example 


Monkey 
ona 
curve. 


Monkey 
deformations. 


Displace Modifier 


The Displace modifier displaces vertices in a mesh based on 
the intensity of a texture. Either procedural or image 
textures can be used. 


The displacement can be along a particular local axis, along 
the vertex normal, or the separate RGB components of the 
texture can be used to displace vertices in the local X, Y and 
Z directions simultaneously (Sometimes referred to as 
Vector Displacement). 


Options 


Texture vy 2 | Displace VYitm@oy x 
The name of the texture 
from which the 
displacement for each 
vertex is derived. If this Direction Normal ve 
field is empty, the 
modifier defaults to 1.0 
(white). Midlevel 


Vertex Group gs 


jv Texture ry) fe es 


Coordinates Local ve 


Strength 


Coordinates 
The texture The Displace modifier. 
coordinate system to 
use when retrieving 
values from the texture for each vertex. 


See common masking options for a complete 
reference. 


Direction 


The direction along which to displace the vertices. Can 
be one of the following: 


X,Y, Z 
Displace along an axis. 


Normal 
Displace along the vertex normal. 


Custom Normal 
Displace along (averaged) custom normals, instead of 
vertex normals. 


RGB to XYZ 
Displace along local XYZ axes individually using the 
RGB components of the texture (Red values displaced 
along the X axis, Green along the Y, Blue along the Z). 


Space 
With a direction set to X, Y, Z, or XYZ the modifier can 
either displace along local or global axes. 


Strength 


The strength of the displacement. After offsetting by the 
Midlevel value, the displacement will be multiplied by the 
Strength value to give the final vertex offset. 


\(vertex_offset = displacement x Strength\) 


A negative strength can be used to invert the effect of 
the modifier. 


Midlevel 
The texture value which will be treated as no 
displacement by the modifier. Texture values below this 
threshold will result in negative displacement along the 


selected direction, while texture values above it will 
result in positive displacement. 


\(displacement = texture_value - Midlevel\) 


Recall that color/luminosity values are typically between 
(0.0 to 1.0) in Blender, and not between (0 to 255). 


Vertex Group 


The name of a vertex group which is used to control the 
influence of the modifier. If left empty, the modifier 
affects all vertices equally. 


Invert <-> 


Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Example 


Three different objects created with the Displace 
modifier. Sample blend-file. 


A slime animation created with the Displace 
modifier. Sample blend-file. 


Hook Modifier 


The Hook modifier is used to deform a mesh, curve or lattice 
using another object (usually an empty or a bone but it can 
be any object). As an object specified as hook moves, it 
pulls vertices or control points from the geometry with it. 
You can think of it as animated Proportional Editing. 


While hooks do not give you the fine control over vertices 
movement that shape keys do, they have the advantage 
that you can select vertices directly for manipulation. 


To assign selected vertices (in Edit Mode) you can use the 
Assign button on the modifier panel or use the Add Hook 
menu. 


Options 


Object y Hook Vitm@oe,y x 
The name of the object 
to hook vertices to. 


Object ‘mg’ Empty 


Vertex Group &§ 


Vertex Group Suen. 
Allows you to define the  Falloff 
influence per vertex. Be smooth 


Radius Om 


Useful when you want 
something other than a 
spherical field of 


influence. The Hook modifier. 


Uniform Falloff 


Invert <-> 


Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Strength 
Adjust this hooks influence on the vertices, were (0.0 to 
1.0) (no change to fully follows the hook). 


Since multiple hooks can work on the same vertices, you 
can weight the influence of a hook using this property. 


The following settings are only available in Edit Mode: 


Reset 
Recalculate and clear the offset transform of the hook. 


Recenter 
Set the hook center to the 3D cursor position. 


Select 
Select the vertices affected by this hook. 


Assign 
Assigns selected vertices to this hook. 


Warning 


The Hook Modifier stores vertex indices from the original 
mesh to determine what to affect. This means that 
modifiers that generate geometry, like Subdivision 
Surface, should always be put after the Hook one in the 
stack. Otherwise, the generated geometry will be left out 
of the hook’s influence. 


Falloff 


Type 
This can be used to adjust the kind of influence curve 
that the hook has on the mesh. You can also define a 
custom curve to get a much higher level of control. 


Radius 
The size of the hooks influence. 


Uniform Falloff 


This setting is useful when using hooks on scaled objects, 
especially in cases where non-uniform scale would 
stretch the result of the hook. 


This is especially useful for lattices, where it is common 
to use non-uniform scaling. 


Example 


Empty used as Hook to deform a subdivided cube. 


Laplacian Deform Modifier 


The Laplacian Deform modifier allows you to pose a mesh while 
preserving geometric details of the surface. 


The user defines a set of “anchor” vertices, and then moves some of 
them around. The modifier keeps the rest of the anchor vertices in 
fixed positions and calculates the optimal locations of all the 
remaining vertices to preserve the original geometric details. 


This modifier captures the geometric details with the use of 
differential coordinates. The differential coordinates capture the local 
geometric information, the curvature and direction of a vertex based 
on its neighbors. 


Note 


You must define an Anchors Vertex Group. Without it the modifier 
does nothing. 


Options 


Repeat v LaplacianD.. \7 EW v x 
How many iterations to do to 
improve the found solution. The 
objective is to find the rotation of 
the differential coordinates Bind 
preserving the best possible 
geometric details. Details are 
retained better if more iterations 
are used, however, it will take 
longer to calculate. 


Repeat 1 


Anchor Weights #83 Group 


The Laplacian Deform modifier. 


Deform horse example blend-file. 


Original 
Model. 


cuss A 


Original 
Model. 


Anchor Weights 
The group of vertices that the user will use to transform the model. 
The weight of each vertex does not affect the behavior of the 


modifier, the method only takes into account vertices with weight 
greater than 0. 


Invert <-> 


Inverts the influence of the selected vertex group, meaning that 
the group now represents vertices that will not be deformed by 
the modifier. 


The setting reverses the weight values of the group. 


Bind 
The Bind button is what tells the Laplacian Deform modifier to 
actually capture the geometry details of the object, so that altering 


the anchor vertices actually alters the shape of the deformed 
object. 


Unbind 


After binding the modifier, you may later decide to make changes 
to the Anchors Vertex Group. To do so you will first need to Unbind 
the modifier before binding it again. 


Error Messages 


Vertex group group_name is not valid 
This message is displayed when a user deletes the vertex group or 


changes its name. 


Vertices changed from X to Y 
This message Is displayed when a user adds or deletes vertices 


to/from the mesh. 


Edges changed from X to Y 
This message is displayed when a user adds or deletes edges 


to/from the mesh. 


The system did not find a solution 
This message is displayed if the solver could not find a solution for 


the linear system. 


Note 


If the mesh is dense, with a number of vertices greater than 
100,000, then it is possible that the nonlinear optimization system 


will fail. 


History 


Laplacian Surface Editing is a method developed by Olga Sorkine and 
others in 2004. This method preserves geometric details as much as 
possible while the user makes editing operations. This method uses 
differential coordinates corresponding to the difference between a 
vector and the weighted average of its neighbors to represent the 
local geometric detail of the mesh. 


Differential Coordinate. 


See also 


e Laplacian Surface Editing (Original paper) 
¢ Differential Coordinates for Interactive Mesh Editing 


Lattice Modifier 


The Lattice modifier deforms the base object according to 
the shape of a Lattice object. Objects to be deformed can be 
meshes, curves, surfaces, text, lattices and even particles. 


Tip 


A Lattice modifier can quickly be added to selected objects 
by parenting them using the Lattice Deform option. 


Options 


Object as] 
The Lattice object with 
which to deform the base 
object. 


Lattice VY itmo@yey x 


Object ‘m) Lattice 
Vertex Group &s 


Strength 


Vertex Group 


An optional vertex group The Lattice modifier. 
name which lets you 

limit the modifier’s effect 

to a part of the base mesh. 


Invert <-> 


Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Strength 


A factor to control blending between original and 
deformed vertex positions. 


Hints 


Why would you use a lattice to deform a mesh instead of 
deforming the mesh itself in Edit Mode? There are a couple 
of reasons for that: 


e If your object has a large number of vertices, it would be 
difficult to edit portions of it quickly in Edit Mode. Using 
a lattice will allow you to deform large portions 
efficiently. 

e The smooth deformation you get from a Lattice modifier 

can be hard to achieve manually. 

Multiple objects can use the same lattice, thus allowing 

you to edit multiple objects at once. 

Like all modifiers, it is non-destructive. Meaning all 

changes happen on top of the original geometry, which 

you can still go back to and edit without affecting the 

deformation. 

A lattice does not affect the texture coordinates of a 

mesh’s surface. 


Note 


When using a lattice to deform particles, order in the 
modifier stack matters. You need to place the Lattice 
modifier after the Particle System one. 


Mesh Deform Modifier 


The Mesh Deform modifier allows an arbitrary mesh (of any 
closed shape) to act as a deformation cage around another 
mesh. 


Note 


This modifier is reasonably easy to use, but it can be very 
slow to compute the binding (the mapping between the 
deform mesh cage to the deformed object geometry). 


Options 
Object v MeshDeform \/ ES imi y x 
The name of the mesh See Cube > 


object to be used as the 
deforming cage. 


Vertex Group gag 


Precision 5 


Dynamic 


Vertex Group 
An optional vertex group 
of the object’s mesh to 
restrict the vertices that The Mesh Deform modifier. 
will be affected by this 
modifier. Vertices not in 
this group will not be deformed. 


Bind 


Invert <-> 
Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Precision 
Controls the accuracy with which the deform mesh cage 
alters the deformed object, when the points on the cage 
are moved. Raising this value higher can greatly increase 
the time it takes to complete the binding calculations, 
but it will get more accurate cage mapping to the 
deformed object. 


This setting becomes unavailable once a cage has been 
bound. 


Dynamic 
When activated, other mesh altering features (Such as 
other modifiers and shape keys) are taken into account 
when binding, increasing deformation quality. 


The setting is deactivated by default to save memory 
and processing time when binding. Like with Precision, 
this setting is unavailable once a cage has been bound. 


Bind 
Links the current vertex positions of both the modified 
geometry and the deforming Object chosen together. An 
unbound Mesh Deform modifier has no effect, it must be 
bound so that altering the shape of the deform mesh 
cage actually alters the shape of the modified object. 


Warning 


Depending on the settings of the modifier and 
complexity of the deform mesh cage and/or deformed 
object, it can take a long time for this operation to 
complete. This can result in Blender not responding to 
user’s actions until it has completed. 


It is also possible that Blender will run out of memory 
and crash. 


To be safe, save your blend-file before proceeding! 


Unbind 
When a deformed object has been associated to a 
deform mesh cage, it can later be disassociated by 
clicking the Unbind button which replaced the Bind one. 


When Unbind is clicked, the deforming mesh cage will 
keep its current shape, it will not reset itself back to its 
initial shape. If you need this original shape, you will 
have to save a copy of it before you alter it. 


The deformed object will, however, reset back to its 
Original shape that it had before it was bound to the 
deform mesh cage. 


Warning 


Significant changes to the entire cage mesh (such as 
rotating the cage upside down) can cause noticeable 
artifacts. 


These can be reduced by binding with a higher Precision, 


however, it is a Known limitation with this modifier and 
cannot be avoided entirely. 


Hints 


e Ensure that the normals on the cage mesh point to the 
outside (they are used to determine the inside and 


outside of the cage). 

Besides the outer cage, more faces within the cage, 
either loose or forming another smaller cage, can be 
used for extra control. Such smaller cages may also 
overlap with the main cage. For example, to get extra 
control over eyes, two small sohere cages could be 
added around them. 


See also 


e The Lattice modifier. 
¢ Original paper 


Shrinkwrap Modifier 


The Shrinkwrap modifier allows an object to “shrink” to the 
surface of another object. It moves each vertex of the object 
being modified to the closest position on the surface of the 
given mesh (using one of the four methods available). 


It can be applied to meshes, lattices, curves, surfaces and 
texts. 


See also 


Shrinkwrap Constraint. 


Options 
W vy (| Shrinkwrap WER y x 
ra 

Wrap Method Nearest Surface Point v e 
x Snap Mode On Surface ve 
M = 
et Target Mf, Cube x 
h Offset 
O Vertex Group &s 


The Shrinkwrap modifier in Nearest Surface Point mode. 


This selector specifies the method to be used to 
determine the nearest point on the target’s surface for 
each vertex of the modified object. Some options will add 


some extra, specific controls to the panel. See Wrap 
Methods for an explanation of each method. 


Snap Mode 
Most modes support an additional setting to control how 
the vertex is moved to the target point selected by the 
methods described above. Some of the choices only 
differ if Offset is not zero. 


On Surface 
The vertex is always moved. The offset is applied 
along the projection line connecting the original 
vertex and selected target point towards the original 
position. 


Outside Surface 
Like On Surface, but the offset is always applied 
towards the outside of the target. 


Above Surface 
Like On Surface, but the offset is applied along the 
smooth normal of the target. 


Inside 
The vertex is not moved if it is already inside the 
target. Offset shrinks the allowed volume towards the 
inside along the projection line. 


Outside 
The vertex is not moved if it is already outside the 
target. Offset expands the exclusion volume towards 
the outside along the projection line. 


Note 


The Inside and Outside options can be used for very 
crude collision detection. The inside vs outside 


determination is done based on the target normal and 
is not always stable near 90 degree and sharper angles 
in the target mesh. 


Target 
Shrink target, the mesh to shrink to/wrap around. 


Offset 


The distance that must be kept from the calculated 
target position. 


Vertex Group 


The vertex group to control whether and how much each 
vertex is displaced to its target position. If a vertex is not 
a member of this group, it is not displaced (same as 
weight 0). 


Wrap Methods 


Nearest Surface Point 


This will select the nearest point over the surface of the 
shrunk target. 


Project 


This will project vertices along a chosen axis until they 
touch the shrink target. Vertices that never touch the shrink 
target are left in their original position. 


Limit 
This is a distance limit between original vertex and 
surface. If the distance is larger than this limit vertex 


would not be projected y | Shrinkwrap Emm. x 
onto the surface. 


Wrap Method Project 


Snap Mode On Surface 


Subdivision Levels 
This applies a 
(temporary) Catmull- 
Clark subdivision to the 
modified object’s 
geometry, before 
computing the wrap. 


Limit 
Subdivision Levels 
Axis 
Negative 
¥ Positive 


Face Cull Off Front 


Target Ml, Cube 


Axis 
Along which local axis of 
the modified object the 
projection is done. These 
options can be combined 
with each other, yielding Project mode. 
a “median axis” of 
projection. If none are 
selected, the normal direction is used. 


Auxiliary Target 
Offset 


Vertex Group is 


Negative/Positive 
This allows you to select the allowed direction(s) of the 
shrink along the selected axis. If both options are 
enabled, both ways are evaluated and the closest hit is 
selected. 


Face Cull 
Allows you to prevent any projection over the “front side” 
(respectively the “back side”) of the target’s faces. The 
“side” of a face is determined by its normal (front being 
the side “from where” the normal “originates”). 


Invert Cull 
If Cull Faces is enabled, and Negative direction along axis 
is allowed, this option can be used to invert the Front or 


Back cull choice for the Negative direction. This is useful 
when projecting in both directions. 


Auxiliary Target 
An additional object to project over. 


Nearest Vertex 


This will snap vertices to the [jowimmrermited <1). memes 
nearest vertex of the shrunk 
target. It adds no extra 
options. 


Wrap Method Nearest Vertex 


Target ‘m) Cube 


Offset 


This method doesn’t Vertex Group 38 
support the Snap Mode 
setting. 


Nearest Vertex mode. 


Target Normal Project 


This mode is similar to y | Shrinkwrap VEHEB~ x 
Nearest Surface Point, but Wrap Method Target Normal Project 
produces a much smoother Snap Mode On Surface 
projection in return for Target ‘Cube 

being significantly slower. Offset 


Vertex Group §s 


Instead of finding the 
closest point, it searches for 
the nearest point that has 
its interpolated smooth 
normal pointing towards or 
away from the original vertex position. Non-manifold 
boundary edges are specially handled as infinitely thin 
cylinders that emit normals in all perpendicular directions. 
Ignores flat shading and auto smooth settings. 


Target Normal Project mode. 


Simple Deform Modifier 


The Simple Deform modifier allows the application of a 
simple deformation to an object. Meshes, lattices, curves, 
surfaces and texts are supported objects. The deformation is 
either a rotation (Twist, Bend) or a scaling (Taper, Stretch). 
The amount of deformation is specified by the Deform Angle 
(rotation) or Deform Factor (scaling). 


vy 7 SimpleDefo.. WET my x 


Twist Bend Taper Stretch 
Angle 360° 
Origin 
Axis 
v Restrictions 


Limits 


Lock 


Vertex Group # 


The Simple Deform modifier. 


The deformation is calculated in the /Joca/ coordinate space. 
Be aware that the local axes of an object can differ from the 
global ones. In the figure above, the global Z axis points up 
and the local Z axis points at 45°. The deformation is 
applied along a Deform axis, which can be set by selection 
from a list (X, Y or Z). By using the Limits field, the influence 
of the modifier can be restricted to a subset of the Deform 
axis. All distances are measured from the origin of the 
object. The vertices that are furthest away from the origin 
on the Deform axis represent the upper and lower limits. 
The origin of the object and the orientation of the local axes 


can be defined by an external Deform object (most of the 
time, an empty). 


Options 


Mode 
Defines the kind of deformation which will be applied. 
The figure below shows the four modes, applied to a text 
object. The origin of the object is at the very left of the 
text. 


Twist around X axis Bend around Z axis 
(180°). (180°). 


SIMPLE DEFORM SIMPLE erORN 


Taper along X axis Stretch along X 
(factor = 2). axis (factor = 0.3). 
Twist 


Rotates the mesh around the specified Axis. Each 
vertex along the Deform axis is rotated around the 
object’s origin. If the origin is inside the object, this 


results in a twisted appearance. Below the origin, 
there is a negative rotation and above the origin, the 
rotation is positive or clockwise. Vertices in the same 
plane as the origin are not rotated. 


The total amount of rotation is specified by the angle 
and the rotation at each vertex is thus weighted by 
the distance of the vertex to the origin of the object. 
Vertices that are furthest away from the object origin 
have max rotation, positive or negative. 


Bend 
Bends the mesh over the specified Axis. The Bend 
mode is more complex and less intuitive. The picture 
below shows the same plane but with different Deform 
and Bending axes. 


Deform axis X or 
Y (a). Deform axis Z (b). 


Deform axis X. Deform axis X. 
Local axis Y Local axis Y 
points down (c). points up (qd). 


Using a mesh plane and setting the Deform axis to X 
or Y will not result in any deformation (Fig a). You 
expect that the bending should be something like 
Figure (c) or (d). Ina 3D world however, selecting the 
X axis introduces an ambiguity because bending along 
the X axis could result in Figure (c) or (d). The 
following pairs describe the selected deform axis vs. 
the desired bending axis: X and Z, Y and Z, Z and X. 


In Fig (a), because of the Deform axis X, the Bending 
is along the Z. All vertices however have the same Z 
coordinate equal to the local origin. So, no 
deformation occurs. In Fig (d) the local axes are 
rotated around the Deform axis X, so that the Bending 
axis Z points to the left. So, all vertices are bend for 
their Z coordinate. The further away from the local 
origin, the more bending. 


This explains also the unexpected result of Fig (b). The 
Deform axis is set here to Z (pointing up). So, 
according to the pairs above, the Bending axis 
defaults to X. All vertices of the plane are bent in their 
X coordinate. The further away, the more rotation 
occurs. Negative X coordinates are rotated 
counterclockwise. 


Taper 
Linearly scales along the specified Axis. The scaling 
factor is weighted by the distance from the origin of 
the object in the deform axis. No scaling occurs in the 
plane of the origin of the object. The maximum scaling 
occurs at the vertices that are furthest away from the 
local origin. This can be a positive or negative scaling, 
depending on the location of the origin. If the local 
origin is within the object, the deformed object 
appears tapered. 


Stretch 
Stretches the object along the specified Axis. If the 
local origin is within the object, the deformed mesh 
looks stretched like pulling a rubber from both sides. 
With a positive factor, the mesh gets longer in the 
deformed axis, wider at the borders and thinner at the 
origin than the original mesh. If the factor is negative, 
then the mesh is squashed in the deformed axis, 
thicker at the origin and thinner at the borders. 


Angle (Twist & Bend)/Factor (Taper & Stretch) 
The total amount of deformation. Can be negative to 
reverse the deformation. 


Axis, Origin 
The name of an object that defines the origin and axis of 
deformation (usually an empty). This object can be: 


e Rotated to control the axis (its local Axis is now used 
as the deformation one). 

e Moved to control the origin of the deformation. 

e Scaled to change the deformation factor. 


Restrictions 


Limits 
You can set the lower and upper limits of the 
deformation. The upper limit cannot be lower than the 
lower one. These limits are mapped on the Deform axis. 


Lock (Twist, Taper and Stretch modes only) 
These controls whether the coordinates along the two 
other axes are allowed to change or not. E.g. if you 
Stretch your object along its Z axis, it is possible to 
squash along the X axis only, by locking the Y one. 


Vertex Group 
The name of the vertex group that indicates whether and 
how much each vertex is influenced by the deformation. 
The amount of influence is determined by the weight in 
the Weight Paint map. 


Smooth Modifier 


The Smooth modifier smooths a mesh by flattening the 
angles between adjacent faces in it, just like the Smooth 
tool in Edit Mode. It smooths without subdividing the mesh, 
the number of vertices remains the same. 


This modifier is not limited to smoothing, though. Its control 
factor can be configured outside the (0.0 to 1.0) range 
(including negative values), which can result in interesting 
deformations. 


Options 


Axis y (7 Smooth 
Enable/disable the 
modifier in the X, Y 
and/or Z axes directions. 


Axis 


Factor 


Repeat 


Factor Vertex Group gs 
Controls the smoothing 


amount. Higher values The Smooth modifier. 
will increase the effect. 


Values outside expected 
range (above 1.0 or below 0.0) will distort the mesh. 


Repeat 


The number of smoothing iterations, equivalent to 
executing the Smooth tool multiple times. 


Vertex Group 


If set, restrict the effect to the only vertices in that vertex 
group. This allows for selective, real-time smoothing, by 
painting vertex weights. 


Invert <-> 
Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Algorithm 


The calculation done by the Smooth modifier is a simple and 
logical one, and can be thought of as the geometric 
equivalent of blurring images. 


Each new vertex position is simply moved towards the 
average position of all its neighbor vertices (topologically 
speaking, i.e. the vertices directly connected to it by an 
edge). 


Example 


Mesh Mesh after Mesh after 
before one ten 
smoothing. smoothing smoothing 


iteration. iterations. 


Smooth Corrective 
Modifier 


The Smooth Corrective modifier is used to reduce highly 
distorted areas of a mesh by smoothing the deformations. 


This is typically useful after an Armature modifier, where 
distortion around joints may be hard to avoid, even with 
careful weight painting. 


To use this modifier effectively, it is important to understand 
the basics of how it works. 


Rest State 
Used as a reference to detect highly distorted areas. The 
Original vertex locations are used by default. 


Smoothing 
Many options for this modifier relate to smoothing which 
is used internally to correct the distorted regions. 


Options 


Factor 
The factor to control the smoothing amount. Higher 
values will increase the effect. 


Values outside expected range (above 1.0 or below 0.0) 
will distort the mesh. 


Repeat 


The number of vy ‘7 Correctives.. \7 Ei. x 
smoothing iterations, 


. Factor 0.500 

equivalent to 
. Ri t 5) 
executing the Smooth za 
tool multiple times. Ses 
Smooth Type Simple 
Scale Vertex Group =m 

Additional scaling Only Smooth 
factor to increase the Bin BOGRIaHES 


size of the mesh. This 
is useful because 
sometimes the Smooth 
Corrective modifier wil| Tne Smooth Corrective modifier. 
introduce volume loss, 

especially when used 

with a rig. 


Rest Source Original Coords 


Smooth Type 
Select the smoothing method used. 


Simple 
This simply relaxes vertices to their connected edges. 


Length Weight 
Uses a method of relaxing that weights by the 
distance of surrounding vertices. This option can give 
higher quality smoothing in some cases, by better 
preserving the shape of the original form. 


Vertex Group 


If set, restrict the effect to the only vertices in that vertex 
group. This allows for selective, real-time smoothing, by 
painting vertex weights. 


Only Smooth 


This option is included to preview the smoothing used, 
before correction is applied. 


Pin Boundaries 
Prevent boundary vertices from smoothing. 


Rest Source 


Select the source for reference vertex positions that 
defines the undeformed state. 


Original Coordinates 
Use the original input vertex positions. This relies on 
the original mesh having the same number of vertices 
as the input, modified mesh. 


Bind Coordinates 
Optionally you may bind the modifier to a specific 
state. This is required when there are constructive 
modifiers such as Subdivision Surface or Mirror in the 
stack before this modifier. 


Example 


An example of a rig using bone envelopes and not weight 
painting. 


Armature only. Armature and 
Corrective Smooth. 


Smooth Laplacian Modifier 


The Smooth Laplacian modifier allows you to reduce noise on a mesh’s surface 
with minimal changes to its shape. 


It can also exaggerate the shape using a negative Factor. 


The Smooth Laplacian is useful for objects that have been reconstructed from 
the real world and contain undesirable noise. It removes noise while still 
preserving desirable geometry as well as the shape of the original model. 


This modifier is based on a curvature flow Laplace Beltrami operator in a 
diffusion equation. 


Hint 
Meshes with a great number of vertices, more than ten thousand (10,000), 


may take several minutes for processing. You can use small portions of the 
mesh for testing before executing the modifier on the entire model. 


Options 


Repeat v7 Laplacians... 37 Fa 
Repetitions allow you to run the 
smoothing operation multiple times. Each 
repetition causes the flow curvature of 
the mesh to be recalculated again, and as 
a result it removes more noise with every 
new iteration using a small Factor < 1.0. coitbatthl fale 


¥ Normalized 


When on 0, no smoothing is done. Vertex Group $83 


Repeat 


Axis 
Lambda Factor 0.010 


Lambda Border 0.010 


Note 

More repetitions will take longer to 
calculate. So beware of doing so on 
meshes with a large number of vertices. 


The Smooth Laplacian modifier. 


With a factor of 0.5. 


Repeat: Repeat: Repeat: Repeat: 
0. i. 5. 10. 


With a factor of 2.0. 


Repeat: Repeat: Repeat: Repeat: 
0. ds Di: 10. 


With a factor of -0.5. 


Axis 
Toggle buttons to enable/disable deforming vertices in the X, Y and/or Z 


axes directions. 


X, Y, Z: 
Selected. ee Sisced. 


X, Y, Z: 
Unselected. 


X, Y, Z: 
Selected. ace eee. 


X, Y, Z: 
Unselected. 


Lambda Factor 


Controls the amount of displacement of every vertex along the flow 
curvature. 


e Using a small Factor, you can remove noise from the shape without 
affecting desirable geometry. 

e Using a large Factor, you get smoothed versions of the shape at the 
cost of fine geometry details. 

e Using a negative Factor, you can enhance the shape, preserving 
desirable geometry. 

e When the Factor is negative, multiple iterations can magnify the noise. 


Factor: Factor: 


Factor: Factor: Factor: 
1.0. 10.0. 50.0. 


Factor: 
0.0. 


Lambda Border 
Since there is no way to calculate the curvature flow on border edges, they 
must be controlled separately. Border edges are smoothed using a much 
simpler method, using this property to control the influence. 


Positive values will smooth the vertex positions, while negative values will 
“enhance” them by transforming them in the opposite direction. 


With a factor of 2.5. 


Border: Border: 
1.0. 2.5. 


With a factor of 20.0. 


Border: “ei as Border: 


With a factor of -30.0. 


? : 


Border: Border: Border: Border: 
0.0: -20.0. -50.0. -200.0. 


Preserve Volume 


The smoothing process can produce shrinkage. That is significant for large 
Factor or large Repeat values. You can use that option to reduce that effect. 


Off. On Off On 


Normalized 


When enabled, the results will depend on face sizes. When disabled, 
geometry spikes may occur. 


Original Off, High 
Geometry. Factor. 


Vertex Group 


A vertex group name, to constrain the effect to a group of vertices only. 
Allows for selective, real-time smoothing or enhancing, by painting vertex 


weights. 
Original No Group . 
Geometry Chosen Vertex Weights Result 


Invert <-> 


Inverts the influence of the selected vertex group, meaning that the 
group now represents vertices that will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Examples 


Femme Femme Cube Shape 


front view side view smooth enhanced 
blend-file. blend-file. blend-file. blend-file. 
See also 


Smooth Modifier. 


Surface Deform Modifier 


The Surface Deform modifier allows an arbitrary mesh 
surface to control the deformation of another, essentially 
transferring its motion/deformation. One great use for this is 
to have a proxy mesh for cloth simulation, which will in turn 
drive the motion of your final and more detailed mesh, 
which would otherwise not be suitable for simulation. 


Options 


Target y [ol SurfaceDeform WES MEIBY x 
The object to which to Target ‘M Cube 
bind (this setting is Interpolation Falloft 
unavailable after Strength 
binding). Vertex Groups 


Warning 
Target Mesh Validity 


While there are no The Surface Deform modifier. 
restrictions with regard 

to the modified mesh, 

the target object’s mesh has a few constraints, which if 
not followed, will prevent a successful binding: 


e It must not contain edges with more than two 
faces. 

e It must not contain concave faces. 

e It must not contain overlapping vertices (doubles). 

e It must not contain faces with collinear edges. 


Interpolation Falloff 
How much a vertex bound to one face of the target will 
be affected by the surrounding faces (this setting is 
unavailable after binding). This essentially controls how 
smooth the deformations are. 


Note 


While lower values result in smoother deformations, 
they may also introduce slight artifacts. 


Strength 
The overall amount of influence the modifier has on 
deforming the mesh. 


Vertex Group 
Allows you to define the influence per vertex. 


Invert <-> 
Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Sparse Bind 
Only record bind data for vertices that have nonzero 
weights in the group at the time of bind. This is an 
optimization, but adding new vertices to the group will 
require a rebind. 


Bind 
Bind the current state of the modified mesh to the 
current state of the target mesh, such that any later 
change in the target mesh will deform the modified mesh 


as well. Note that until the bind has been executed, this 
modifier will have no effect at all. 


Unbind 


Once the mesh is bound, the Bind button changes to 
Unbind. Executing this frees the modified mesh from the 
target, and resets it to its original shape. 


Note 


The meshes are bound with regard to global coordinates, 
but later transformations on the objects are ignored. This 
means that one can freely transform the target or modified 
object after binding, without affecting the modified object. 
The modified mesh will only pick up changes to the target 
object’s mesh itself. 


Note 


The further a mesh deviates from the target mesh surface, 
the more likely it is to get undesirable artifacts. This is an 
inherent characteristic of surface binding in general, so it 
is recommended to have reasonably well matching 
meshes, in order to get a good bind. 


Example 


Cloth simulation copied to an arbitrary mesh with 
rings as instancing faces. 


Volume Displace Modifier 


The Volume Displace modifier displaces existing volume 
grids based on a 3D texture. It uses the RGB color channels 
of the texture to displace the volume into the X, Y and Z 
direction. 


Options 


Texture * 6 Volume Displace 
The texture that is fay 
evaluated at every voxel Texture Mapping Loca 
to determine how far Strength 0.5000 
and in what direction to Sample Radius 1.00000 


displace. Mid Level X 0.50000 
’ 0.50000 


Z 0.50000 


Note 


Grayscale textures lead 
to stretching along one 
axis. It’s best to use a 
color texture. 


The Volume Displace modifier. 


Strength 
Controls how far voxels are displaced. 


Sample Radius 


Smaller values result in better performance, but might 
cut off the volume outside. 


Mid Level 


This should be modified if the texture offsets the entire 
volume in one direction and you want to center it again. 
For performance reasons, the displaced volume should 
stay close to its original position. 


Example 


A volume displaced with various strengths. 


Warp Modifier 


The Warp modifier can be used to warp parts of a mesh toa 
new location in a very flexible way, by using two objects to 
select the “from” and “to” regions. 


A Warp modifier applied to a grid mesh. 


This modifier is a bit tricky to understand at first. It requires 
two points, specified by the two target objects’ origins. The 
“from” point designates a point in space that is pulled 
toward the “to” point. It is akin to using the Proportional 
Editing in Edit Mode. 


Options 


Object From 


The object defining the ¥ [2 Warp rime, x 
origin transformation of 
the warp. 


Object From ‘mi’ Cube 


Object To i, Empty 


Object To Preserve Volume 
The object defining the Stang, 1.00 
destination Vertex Group 8 
transformation of the eae 
men Falloff Type /\ Smooth 

Preserve Volume Radius 
Enables volume Y Texture 
preservation when ma. 
rotating one of the ria 
transforms. 

Strength The Warp modifier. 
Sets how strong the 
effect is. 


Vertex Group 


The name of a vertex group which is used to control the 
influence of the modifier. If left empty, the modifier 
affects all vertices equally. 


Invert <-> 


Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 
Falloff 


Falloff Type 


Sets the way the strength of the warp change as it goes 
from the center of the transform to the Radius value. See 
Proportional Editing for descriptions of the falloff types. 


Radius 
Sets the distance from the transforms that can be 
warped by the transform handles. 


Texture 


Texture 
You can finely control which vertices are affected by the 
warp, and to what extent, using a texture. 


See common masking options for a complete reference. 


Usage 


The Warp modifier can be awkward to use sometimes, and 
its use case is rather small, but there are a few still. For 
example, it can be used to have an interactive Proportional 
Editing that can be used for animations. 


Another way to use this modifier is similar to the Deform 
Modifier. This allows you to deform parts of the mesh 
without having to make a vertex group. 


Examples 


Warp Modifier with a custom falloff curve. 


Wave Modifier 


The Wave modifier adds a ripple-like motion to an object’s 
geometry. 


This modifier is available for meshes, lattices, Curves, 
surfaces and texts. 


Motion 
Circular Linear lias 
wave wave He : 
front. front. eet 
enabled 
for Y. 
Options 
Motion 


The wave effect deforms vertices/control points in the Z 
direction, originating from the given starting point and 
propagating along the object with circular wave fronts (if 
both X and Y are enabled), or with rectilinear wave fronts 
(if only one axis is enabled), then parallel to the axis 
corresponding to the X or Y button activated. 


Cyclic 


Repeats the waves 
cyclically, rather than a 
single pulse. 


Along Normals 


For meshes only. 
Displaces the mesh 
along the surface 
normals (instead of the 
object’s Z axis). 


X/Y/Z 
Restrict displacement 
along normals to the 
selected local axes. 


Falloff 


Controls how fast the 
waves fade out as they 
travel away from the 
coordinates above (or 
those of the Start 
Position Object). 


Height 


The height or amplitude 
of the ripple. 


Width 


’ (7 Wave VYitme@y x 
Motion X uf 
Y Cyclic 
Along Normals 
Falloff 
Height 
Width 


Narrowness 


Vertex Group gs 


vy Start Position 


Object 
Start Position X 
Vf 

vy Time 
Offset 
Life 
Damping 
Speed 


v Texture 


ay + 


Coordinates 


The Wave modifier. 


Half of the width between the tops of two subsequent 
ripples (if Cyclic is enabled). This has an indirect effect on 
the ripple amplitude. If the pulses are too near to each 
other, the wave may not reach the zero Z position, so in 
this case Blender actually lowers the whole wave so that 
the minimum is zero and, consequently, the maximum is 


lower than the expected amplitude. See Technical Details 
and Hints for more information. 


Narrowness 
The actual width of each pulse: the higher the value the 
narrower the pulse. The actual width of the area in which 
the single pulse is apparent is given by 4 / Narrowness. 
That is, if Narrowness is 1 the pulse is 4 units wide, and if 
Narrowness is 4 the pulse is 1 unit wide. 


Vertex Group 
The name of a vertex group which is used to control the 
influence of the modifier. If left empty, the modifier 
affects all vertices equally. 


Invert <-> 
Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Important 


All the values described above are in local object space, 
i.e. they must be multiplied with the corresponding Scale 
values of the object to get the real dimensions. 


Start Position 


Object 
Use another object as the reference for the starting 
position of the wave. Note that you then can animate this 


object’s position, to change the wave’s origin across 
time. 


Start Position X/Y 
Coordinates of the center of the waves, in the object’s 
local space. 


Time 
Settings to control the animation. 


Offset 
Time offset in frames. The frame at which the wave 
begins (if Speed is positive), or ends (if Speed is 
negative). Use a negative frame number to prime and 
pre-start the waves. 


Life 
Duration of animation in frames. When set to zero, loops 
the animation forever. 


Damping 
An additional number of frames in which the wave slowly 
damps from the Height value to zero after Life is 
reached. The dampening occurs for all the ripples and 
begins in the first frame after the Life is over. Ripples 
disappear over Damping frames. 


Speed 
The speed per frame, of the ripple. 


Texture 


You can finely control which vertices are affected by the 
wave, and to what extent, using a texture. 


See common masking options for a complete reference. 


Technical Details and Hints 


The relationship of the above values is described here: 


2 * Width 


LAN 


4 / Narrow 


Height 


Wave front characteristics. 


To obtain a nice wave effect similar to sea waves and close 
to a sinusoidal wave, make the distance between following 
ripples and the ripple width equal. That is, the Narrowness 


value must be equal to 2 / width. E.g. for Width to be 1, set 
Narrow to 2. 


Cloth Modifier 


The Cloth modifier is a container for a Cloth Physics 
simulation. It can be useful for example, to simulate on a 
low-poly mesh then add a Subdivision Surface Modifier after 
the Cloth modifier to improve the visual quality of the cloth 
without drastically increasing simulation times. 


Options 


As the modifier is only a container its actual options can be 
configured in the Physics Properties tab. See the Cloth 
Physics Properties for more information. 


Example 


Cloth on 
carved 
Cloth wooden Cloth 
example. men example. 
(made by 


motorsep). 


Collision Modifier 


The Collision modifier is a container for a Collision Physics. 
Collision physics provide interaction between different 
physics simulations. 


Options 


As the modifier is only a container its actual options can be 
configured in the Physics Properties tab. See the Collision 
Physics Properties for more information. 


Example 


Deflected particles. 


Here is a Meta object, using Instancing Vertices to a particle 
system emitting downwards, and deflected by a mesh cube. 


Dynamic Paint Modifier 


The Dynamic Paint modifier is a container for a Dynamic 
Paint Physics simulation. 


Options 


As the modifier is only a container its actual options are 
configured in the Physics Properties tab. See the Dynamic 
Paint Physics Properties for more information. 


Explode Modifier 


The Explode modifier is used to alter the mesh geometry by 
moving/rotating its faces in a way that roughly tracks 
particles emitted by that object, making it look as if the 
mesh is being exploded (broken apart and pushed outward). 


For this modifier to have any visible effect, there needs to 
be a particle system on its object. That particle system will 
control how the mesh is exploded. 


Both the number of emitted particles and number of faces 
determine how granular the Explode modifier is. More of 
each faces and particles will mean more individual pieces. 


Here is a demo blend-file showing a cube with a particle 
system and Explode modifier. 


Note 


The Explode modifier must come after the Particle System 
one in the modifier stack, in order for the former to get 
required data from the later. 


Options 


Particle UV 
If set, the U value of the coordinates in that UV Map will 
be overwritten with the age of the particle attached to 
the matching mesh face (in proportion, from O for not yet 
born particles, to 1 for dead ones). 


vy SS ParticleSettings Lt © ina 


Settings are in the particle tab 
Yop Explode mor x 


Particle UV 
Show | Alive Dead Unborn 
Cut Edges 
Size 


Vertex Group #s 


Refresh 


The Explode modifier, with a Particle System above it. 


V9OoOtTtMNH~DMAC-AX9K< COTdTH 


constant 0.5 value. 


You can for example vary the color of a fragment (face) 
during the explosion phase, by using a texture with a 
color gradient along its U axis. 


Show 
Unborn 
Show faces when their attached particles are unborn. 


Alive 
Show faces when their attached particles are alive. 


Dead 
Show faces when their attached particles are dead. 


Cut Edges 
Split the mesh in pieces based on location of emitted 
particles, instead of using existing faces. This will 


typically results in a splitting that appears more random. 


Size 
Scale each face using the size of its attached particle, 
once that particle is alive. 


Vertex Group 
Vertices in this group may not be affected by the Explode 
modifier. Vertices with full weight are not affected at all, 
while vertices with less weight have a higher chance of 
being affected. 


Vertices with null weight will be treated like those which 
do not belong to the group at all, and explode normally. 


Invert <-> 
Inverts the influence of the selected vertex group, 
meaning that the group now represents vertices that 
will not be deformed by the modifier. 


The setting reverses the weight values of the group. 


Protect 
Clean vertex group edges. Depending on the weights 
assigned to that vertex group, either completely protect 
those faces from being affected by the Explode modifier 
(which would happen if the faces had a weight value of 
1), or completely remove protection from those faces 
(which would happen if the faces had a weight value of 
0). 


Refresh 
Refresh data in the Explode modifier. 


Known Limitations 


Dynamic Vertex Weights 


This modifier uses the initial vertex weights. Modifiers that 
dynamically change weights will not influence the explosion 
as these values are only used once. 


Fluid Modifier 


The Fluid modifier is a container for a Fluid Physics 
simulation. It can be useful for example, to simulate on a 
low-poly mesh then add a Subdivision Surface Modifier after 
the Fluid modifier to improve the visual quality of the fluid 
without drastically increasing simulation times. 


Options 


As the modifier is only a container its actual options can be 
configured in the Physics Properties tab. See the Fluid 
Physics Properties for more information. 


Example 


Example of a liquid simulation. 


Ocean Modifier 


The Ocean modifier is a tool to simulate and generate a 
deforming ocean surface, and associated texture, used to 
render the simulation data. It is intended to simulate deep 
ocean waves and foam. 


It is a port from the open source Houdini Ocean Toolkit. 
Options 


Geometry 
Generate 


Creates a tiled mesh grid that exactly corresponds 
with the resolution of the simulation data. 


When generating a mesh surface, the existing mesh 
object is completely overridden with the ocean grid; 
this also includes any data generated from previous 
modifiers in the stack. A UV channel is also added, 
mapping the (0.0 to 1.0) UV space to the simulation 
grid. 


Repeat X, Y 
Controls the number of times the grid is tiled in X 
and Y directions. UVs for these tiled mesh areas 
continue outside of the (0.0 to 1.0) UV space. 


Displace 
Uses the existing geometry rather than replacing it. 
Vertices are displaced along the local Z axis. 


Resolution Viewport, Render 


The main control of 
quality vs speed in the 
Simulation engine. This 
determines the 
resolution of the internal 
2D grids generated by 
the simulation for the 3D 
Viewport or the final 
render. 


The internal grids are 
powers of two of the 
resolution value, so a 
resolution value of 16, 
will create simulation 
data of size 256x256. The 
higher the resolution, the 
more details will be 
produced, but the slower 
it will be to calculate. 


Note 


When using the 
Generate modifier 
geometry option, this 
resolution value also 
determines the 
resolution of the 
generated mesh 
surface, equal to the 
resolution of the internal 
simulation data. 


Time 


v 


2X Ocean 
A 


Geometry 
Repeat X 

Y 
Resolution 
Time 

Depth 

Size 

Spatial Size 


Random Seed 


v Waves 


Scale 

Smallest Wave 
Choppiness 
Wind Velocity 


Alignment 


¥Y Spectrum 
Spectrum 


Y Bake 


Cache Path 


Frame Start 
End 


See. x 


Generate 


Turbulent Ocean 


Bake Ocean 


v 


The time at which the The Ocean modifier. 
ocean surface is being 

evaluated. To create an 

animated ocean, you will need to animate this value. The 
speed that the time value is changing will determine the 
speed of the wave animation. 


Depth 
The constant depth of the ocean floor under the 
simulated area. Lower values simulate shallower waters 
by producing higher frequency details and smaller 
waves. 


Size 
A simple scaling factor that does not affect the height of 
the waves or behavior of the simulation. 


Spatial Size 
The width of the ocean surface area being simulated, in 
meters. This also determines the size of the generated 
mesh, or the displaced area. Of course, you can scale the 
object with the Ocean modifier in Object Mode to tweak 
the apparent size in your scene. 


Random Seed 
A different Seed will produce a different simulation result. 


Generate Normals 
Simulates extra normal map data. This can be used by 
the Ocean texture, when mapped to Normals, as a bump 
map, and enables generating normal map image 
sequences when baking. 


Waves 


Scale 
An overall scale control for the amplitude of the waves. It 
approximates the height or depth of the waves above or 
below zero. Rather than just scaling the ocean object in 
Z, it scales all aspects of the simulation, displacement in 
X and Y, and corresponding foam and normals too. 


Smallest Wave 
A minimum limit for the size of generated waves. Acts 


similarly to a low-pass filter, removing higher frequency 
wave detail. 


Choppiness 
The choppiness of the wave peaks. With a choppiness of 
0, the ocean surface is only displaced up and down in the 
Z direction, but with higher choppiness, the waves are 
also displaced laterally in X and Y, to create sharper 
wave peaks. 


Wind Velocity 


Wind speed in meters/second. With a low velocity, waves 
are restricted to smaller surface waves. 


Alignment 
The directionality of the wave shapes due to wind. Ata 
value of 0, the wind and waves are randomly, uniformly 
oriented. With higher Alignment values, the wind is 
blowing in a more constant direction, making the waves 
appear more compressed and aligned to a single 
direction. 


Direction 


When using Alignment, the direction in degrees that the 
waves are aligned to (using local X axis as reference). 


Damping 


When using Alignment, this will define the amount that 
inter-reflected waves are damped out. This has the effect 
of making the wave motion more directional (not just the 
wave shape). 


With a Damping of 0.0, waves are reflected off each 
other in every direction, with a Damping of 1.0, these 
inter-reflected waves are damped out, leaving only 
waves traveling in the direction of the wind. 


Foam 


Simulates extra foam data. 


This can be retrieved by the Ocean texture for use in 
texturing (perhaps as a mask), and enables generating foam 
map image sequences when baking. 


Data Layer 
Optional name for the vertex data layer, used by the 
Ocean Modifier to store foam maps as a Color Attribute. 
This is required for accessing the foam data in the 
renderer. 


Coverage 
Tweaks the amount of foam covering the waves, negative 
values will reduce the amount of foam (leaving only the 
topmost peaks), positive values will add to it. Typically 
ranges from (-1.0 to 1.0). 


Using foam Color Attributes with a named data 
layer. 


Spray 


Generate map of spray direction as a Color Attribute. This 
map can be used to define the velocities for spray particles. 


Spray Map 
Name of the Color Attribute used for the spray direction 
map. 


Invert 
Inverts the spray direction map. 


Spectrum 


Spectrum 
Used to choose the wave spectrum model to use. Wave 
spectra are used to describe how energy moves through 
the waves at different frequencies. Energy travels 


through waves differently depending on the depth of the 
water and the wind speed. 


Turbulent Ocean 
Use for turbulent seas with foam (Phillips). 


Established Ocean 
Use for a large area, established ocean where the 
ocean would extend for miles with wind blowing for 
days allowing the waves to reach a point of 
equilibrium (Pierson-Moskowitz method). 


Established Ocean (Sharp Peaks) 
Similar to regular Established Ocean however, waves 
will continue to grow with time creating sharper peaks 


parameter is used to define the sharpness of these 
peaks. 


Shallow Water 
Use for shallow water with depths less than about 10 
meters which makes it great for small lakes and ponds 
without heavy wind (JONSWAP and TMA - Texel- 
Marsen-Arsloe methods). 


Examples of different spectra, settings adjusted for each. 


Turbulent Ocean. Established Ocean. 


Established Ocean Shallow Water. 
(Sharp Peaks). 


Sharpness Peak 
An artificial factor to control how sharp the peaks of the 
waves are in the Established Ocean (Sharp Peaks) and 
Shallow Water spectrum models. 


Fetch 
Distance from a lee shore, called the fetch, or the 
distance over which the wind blows with constant 
velocity. Used by Established Ocean (Sharp Peaks) and 
Shallow Water spectrum models. 


Bake 


Rather than simulating the ocean data live, it can be baked 
to files in a given directory. When a simulation is baked, the 
simulator engine is completely bypassed, and all 
information for the modifier or texture is retrieved from the 
baked files. 


Baking has the following advantages: 


e It is faster to use the stored data rather than 
recalculating it. 

e It allows rendering of ocean data in external renderers. 

e It enables more advanced foam maps. 


Simulation data is stored as sequences of OpenEXR image 
maps, one for each of displacement, normals, and foam (if 
enabled to be generated). Upon loading the data from these 
baked files, when a frame of the bake sequence is read, it is 
cached in memory. This means that accessing loaded 
frames subsequent times is fast, not incurring the overhead 
of drive access. 


Since these baked files are plain OpenExR’s, they can also be 
opened and rendered in any other application or renderer 
that supports them. 


Cache Path 
Folder to store the baked EXR files in. The sequences will 
be in the form disp ####.exr, normal _####.exr, and 
foam_####.exr, where #### is the four digit frame number. If 
the cache path folder does not exist, it will be created. 


Frame Start, End 
Frames of the simulation to bake (inclusive). The start 
and end frames of the bake are repeated when accessing 
frames outside of the baked range. 


Foam Fade 
Baking also provides improved foam capabilities. When 
simulating live, the ocean simulator retrieves data for 
that current frame only. In the case of the foam map, this 
represents the tips of wave crests for that given frame. In 
reality, after foam is created by wave interactions, it 
remains sitting on the top of the wave surface for a 
while, as it dissipates. With baking, it is possible to 
approximate that behavior, by accumulating foam from 
previous frames, leaving it remaining on the surface. 


Example 


The following example was created and rendered in Blender, 
notice how the peaks of the waves are white; an effect 
generated from the foam data. 


Particle Instance Modifier 


When a Particle Instance modifier is added to an object, the 
mesh of this object will be duplicated at the location of the 
particles of the selected particle system from another target 
object. This means that to use this modifier, you must have 
at least one other object that has a Particles System on it. 


Because of the correlation in which the Particle Instance 
modifier is influenced by the underlying particle systems on 
other objects, some of the apparent effects generated by 
the modifier can look and act vastly different, depending on 
the underlying settings of the particle systems it is 
associated with. This is worth taking account of, when it 
seems that the Particle Instance modifier settings do not 
return the expected results. 


Options 


Object 
The target object which has a particle system associated 
with it. 


Particle System 


Which particle system from the target Object to apply 
this modifier to. 


Create Instances 
Regular 
When enabled, the modifier will use the regular 
(parents) particles to duplicate the mesh of the 
modified object. 


Children vy 9S Particleinstance YW Ea iv x 
When enabled, the Object ‘w Cube 
modifier will use the 


x 


children particles to Particle System <> ParticleSettings Xx 
duplicate the mesh of Create Instances |Regular Children Size 
the modified object. Show | Alive Dead Unborn 


Amount 1.000 
Size 

Scale the instanced 
copies of the mesh by Coordinate Space World 
the particle size X's 
attribute. When this is v (Create Along Paths 
disabled, all the 
copies appear the 
same size as the 


Offset 0.000 


origin. 
See the particle 

, v Layers 
system’s Render and 
Children panels for Index fr: 
particle’s size options. Value firs 


show The Particle Instance modifier. 

Unborn 
When enabled, the 
modifier will use the 
unborn particles to duplicate the mesh of the modified 
object. 

Alive 
When enabled, the modifier will use the alive particles 
to duplicate the mesh of the modified object. 

Dead 


When enabled, the modifier will use the dead particles 
to duplicate the mesh of the modified object. 


Amount 


The proportion of particles to be used. Allows you to 


randomly skip particles to adjust the amount of 
instances. 


Warning 


The random algorithm used currently only ensures that 
relative amount to be respected statistically. The actual 
amount of instances generated will differ from the 
theoretical one, depending on the Seed value of the 


target particle system (and the Offset value described 
below, too). 


That deviation is not significant with high number of 
particles, but it will be highly noticeable with low 
numbers (e.g. with 100 particles in the target system, 
and an Amount value of 0.1, it can generate either up to 
15 or 5 instances, instead of the 10 expected). 


Offset 


A relative offset in the range of particles used for 
instantiation. Allows you to avoid overlapping of the used 
particles, when the same particle system is used in 
multiple modifier instances. 


Tip 


If you want to fully avoid overlaps, your Offset value 
must be at least as high as your Amount value. 


Coordinate Space 
World, Local 


Use World Space, or Local Space of the target object 
(that the particle system is assigned to). 


e World space means that the locations of the 
copies of the modified mesh will depend on the 
location of the modified object and of the target 
object. 

e Local space means that the locations of the copies 
of the modified mesh will depend only on the 
location of the modified object. 


Axis 
Specify which axis of the modified object to use as pole 
axis to apply the rotation from the instantiated particles. 


Create Along Paths 


By default, the instances are placed depending on the 
particles position in the current frame. By enabling Create 
Along Paths, the instance of the modified object follows 
deforms its shape along the particle path (or the hair 
strand). This allows you to select the position along the 
particles path regardless of the current frame. 


Tip 
You can adjust the particles’ path (using the Path 


visualization type) on the Render panel of the Particle 
System tab. 


Note 


The particle system must be baked, except for Hair type or 
Keyed physics. 


Position 


Specify what percentage of the path that the instance 
fills, or the position on the path if the Keep Shape option 
is enabled. 


Random 
Adds randomness to the Position value of each instance. 


Rotation 
Specifies the rotation around the path. 


Random 
Adds randomness to the Rotation value of each instance. 


Keep Shape 
Enabling this prevents the instance from being deformed, 
and places it on the path according to the Position value. 


Layers 


With these fields you can select the Color Attribute, which 
will be filled with colors based on the particles information. 
These Color Attributes can be used, for example, in a shader 
to add variance to a material. 


Index 
A Color Attribute for values based on the particles index. 


Value 
A Color Attribute for random per-particle values. 


Examples 


Particle Instance modifier example. 


The render above shows a single plane mesh object 
assigned to two different vertex groups and each of those 
vertex groups is assigned to a separate and independent 
particle system, with each particle system being assigned to 
a different Particle Instance modifier. In the case shown the 
Particle Instance modifiers are added to a sphere and a 
cube. See example blend-file. 


Create Along Path example. 


In this example, a single Keyed particle travels through four 
points (green planes), on an elliptical path. The Particle 
Instance modifier is added to a cylinder object and then 
associated with that Keyed particle system. 


When the Create Along Paths is activated, instead of the 
cylinder location just following the position of the particle, 
the cylinder mesh is fitted to the shape of the path followed 
by the particle. The mesh geometry of the object which is 
deformed can have an impact on how well the deformation 
is carried out. In the case of the cylinder, it has many loop 
cuts along its length so that it can bend at those points to 
deform along the particle path. 


The Particle Instance modifier Create Along Paths option 
works for hair (Strand) particles as well as with keyed 
particles. In this case, the mesh of the modifier will follow 
the length and profile of the hair strands paths. 


Note 


Strands, when they are generated, instantly die when 
created, so for the Create Along Paths checkbox to be of 
any use, you must also have the Dead checkbox enabled. 


Particle System Modifier 


The Particle System modifier is a container for Particle 
Systems. 


Note 


By default the Particle System modifier does not take into 
account the modifier stack. Make sure to enable Use 
Modifier Stack in the Particle properties if you want Particle 
System modifier to take other modifiers into account. 


Options 


As the modifier is only a container its actual options are 
configured in the Particle Properties tab. See the Particle 
Systems Properties for more information. 


Converting Particle Systems 


Make Instances Real 
Creates a new object of each instanced object or 
collection. See Make Instances Real for more information. 


Convert to Mesh 
Converts path particles to mesh objects. See Convert for 
more information. 


Example 


Fur made from particles. 


Soft Body Modifier 


The Soft Body modifier is a container for a Soft Body Physics 
simulation. 


Options 


As the modifier is only a container its actual options are 
configured in the Physics Properties tab. See the Soft Body 
Physics Properties for more information. 


Example 


The wind cone is a soft body, as the suspension. 
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Bounding Box Node 
Convex Hull Node 
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Make Group 
Ungroup 
Group Input 
Group Output 
Node Groups 


Introduction 


Geometry nodes system for modifying the geometry of an 
object with node-based operations. It can be accessed by 
adding a Geometry Nodes Modifier. 


The properties of a Geometry Nodes modifier in the 
modifier stack. 


The geometry node tree connected to a modifier is a Node 
Group. The geometry from the state before the modifier (the 
original geometry or the result of the previous modifier) will 
be passed to the Group Input node. Then the node group 
can operate on the geometry and pass an output to the 
Group Output node, where it will be passed to the next 
modifier. 


Geometry nodes can modify different types of geometry: 


e Meshes 
e Curves 


e Point Clouds 
e Volumes 
e Instances 


The interface of the modifier is described in the Modifier 
page. 


Inspection 


Inspecting intermediate values in a geometry node tree is 
useful while building/understanding one or when trying to 
figure out why something is not working. Blender provides 
multiple tools to understand how a node tree is working or 
why it is not working. 


Note 


Generally, the inspection tools display data from the last 
time the node tree has been evaluated. If it has not been 
evaluated, no information is available. 


Socket Inspection 


Socket Inspection. 


Socket inspection shows information about the value ina 
socket during the last evaluation. For primitive data types 
such as integers, vectors, and strings the actual value is 
shown. For geometry sockets only some data about the 
geometry is stored, including the set of data types the 
geometry contains, and a count of their elements. 


Socket values are only logged from when the node tree was 
executed, so a node must be connected to the Group Output 
to have a value for inspection. Values are not logged during 
rendering, to improve performance. 


Attribute Search 
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Attribute Search. 


The attribute search is shown when clicking on an attribute 
input in the modifier. It contains a list of all the attributes 
that were available at that point in the modifier or node 
execution. 


Viewer Node 


The Viewer node is used to display intermediate geometry 
in the Spreadsheet Editor and the Viewport. For more 
information see Viewer Node. 


Node Warnings 


Y Curve to Mesh La 


Input geometry has unsupported type: Mesh. 
@ Curve 


@ Profile Curve 


& Fill Caps 


Node Warning. 


When the inputs to a node are invalid, it displays a warning 
in the title. Hovering over the warning icon shows the error 
message. These warnings are only generated when the 
node is executed, so a node must be connected to the 
Group Output to have a warning. 


Node Timings Overlay 


@ 2.0ms 


Y Subdivide Mesh 


@ <0.1ms 
Y Raycast 


Mesh @ OG 1.3 ms 
Y Set Position 


Is Hit @ 


Hit Position 


Geometry @ Hit Normal 


@ Geometry Hit Distance @ 


The node timings overlay. 


Node timings show how long a node took to execute the last 
time the node group was evaluated. They can be turned on 
in the overlays popover on the top right of the node editor. 
When a node group is used in multiple places, the timings 
depend on the context of the node editor, which is displayed 
in the path on the top left. 


Frame nodes display the total time from all of the contained 
nodes and the Group Output node displays the total time for 
the entire node group. 


The displayed timings should only be considered an 
approximation, since they can also take into account actions 
like copying or deleting a geometry input that aren’t part of 
the node’s operation. Also, when a node uses multiple CPU 
cores, the evaluation system might work on other nodes at 
the same time. It’s also important to remember that field 
nodes generally don’t do work by themselves, so their 
execution time is only added to the data-flow nodes they 
are connected to. 


Named Attributes Overlay 


The “Named Attributes” overlay allows displaying when a 
custom named attribute is used by a node or a node group. 
Named attributes can be used by the Capture Attribute 
Node, the Named Attribute Node, and the Remove Named 
Attribute Node, and can be written to, read, or removed. 


Using named attributes (as opposed to Anonymous 
Attributes) can be problematic when the original geometry 
already has attributes with the specified names. In that case 
a geometry node group might mistakenly overwrite some 
essential data. The overlay helps to make detecting that 
situation easy. 


The same data is also available in the Internal 
Dependencies panel in the modifier’s Ul. 


Attributes 


An attribute is a generic term to describe data stored per- 
element in a geometry data-block. For example, every 
vertex can have an associated number or vector. Attributes 
can be altered by connecting a value to the Group Output 
node, but also many nodes can change the values of 
specific attributes. 


Note 


Attribute data types and domains are converted implicitly 
where possible, just like node sockets. 


Named Attributes 


Named attributes are created and used in other areas of 
Blender like shaders, painting, and UV mapping. In the 
modifier panel, a named attribute can be used for input by 
clicking the icon to the left of the value button. The string 
input input allows you to search and choose existing 
attributes from the modifier’s input geometry. 
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Attribute Search. 


The attribute search gives a bit of context about each 
attribute. To the left of the menu, the attribute domain is 
shown followed by the attribute name. To the right of the 
menu, the attribute data type is shown. 


Anonymous Attributes 


Y Distribute Points on Faces 


Points 
Normal 


Rotation 


Random v 
Mesh 


© Selection 


® Density 


< Seed 


The Normal and Rotation outputs are examples of 
attribute fields, which refer to an attribute stored on 
a geometry. 


An anonymous attribute is a set of generic data stored ona 
geometry that doesn’t have a name. Usually, attributes 
exposed in Blender’s interface all have names. However, in 
geometry nodes, attributes can be passed around with node 
sockets. In these cases, an Attribute Field output is created, 
which is used by nodes to find attribute data in an input 
geometry. 


Anonymous attributes are still stored on the geometry like 
other attributes, and they are even automatically 
interpolated when the geometry changes with other nodes, 
except for a few cases. So generally, if the node link is still 
accessible, the attribute it references will be available too. 
However, anonymous attributes cannot be connected to a 
completely separate geometry that was created from a 
different source. To transfer attributes between separate 


geometries, the Sample Index Node or other similar nodes 
like the Sample Nearest Surface Node can be used. 


Attribute Data Types 


The type of an attribute is the kind of data stored at each 
element. 


Boolean: True or false value 

Integer: 32-bit integer 

8-Bit Integer: Smaller integer with a range from -128 
to 127 

Float: Floating-point value 

Vector: 3D vector with floating-point values 

2D Vector: 2D vector with floating-point values 

Color: RGBA color with 32-bit floating-point 
values 

Byte Color: RGBA color with 8-bit positive integer 
values 


The above list is in the order of least to most “complex” (An 
integer can contain more data than a boolean, so it is more 
complicated). When joining separate geometries together, 
the more complex data type is preferred when there are 
matching names. This is particularly important when joining 
geometry with named attributes with the Join Geometry 
Node 


Attribute Domains 


The domain of an attribute refers to what type of geometry 
element the attribute corresponds to. Knowing the domain 
of an attribute is important because it defines how it may be 
interpolated and used in nodes and shading. You can use 


the Spreadsheet Editor to determine the domains of 
attributes. 


Point domain attributes are associated with single 
locations in space with a position: 


o Vertices of a mesh 
o Points of a point cloud 
o Curve control points 


Edge domain attributes are associated with the edges 
of a mesh. 


Face domain attributes are associated with the faces of 
a mesh. 


Face Corner domain attributes are associated with the 
corners of the faces of the mesh. An example is a UV 
map attribute. 


Spline domain attributes are associated with a group of 
connected curve control points. 


Instance domain attributes exist on the Instances ina 
geometry. They can be used to store different values on 
copies of geometry data. Instance domain attributes are 
only supported in geometry nodes. 


Attributes are automatically interpolated to other domains. 
For example, when the Position Node is connected to the 
selection input of the Set Material Node node, the values are 
interpolated from the Point domain to the Face domain. 
Normally, domain conversions use simple averages for 
values, but Boolean data type attributes have special rules 
for interpolation: 


Boolean Domain Interpolation 


From To Conversion 


An edge is selected if both of its vertices 


Point Edge were selected. 


A face is selected if all of its vertices were 


Point Face selected too. 


Each corner’s value is simply a copy of 


Point Comer the value at its vertex. 


A spline is selected if all of its control 


pe a Sa points were selected. 


A vertex is selected if any connected 


Boos pele edge was selected. 


A face is selected if all of its edges are 


Edge Face selected 


A corner is selected if its two adjacent 


Edge Corner edges were selected. 


A vertex is selected if any of the 


Face Point 
connected faces were selected. 


From To 


Face Edge 


Face Corner 


Corner Point 


Corner Edge 


Corner Face 


Spline Point 


Conversion 


An edge is selected if any connected face 
was selected. 


Each corner’s value is simply a copy of 
the value at its face. 


A vertex is selected if all connected face 
corners were selected and it is not a loose 
vertex. 


An edge is selected if all corners on 
adjacent faces were selected. 


A face is selected if all of its corners were 
selected. 


Each point’s value is simply a copy of the 
corresponding value of the spline. 


Built-In Attributes 


Built-in attributes always exist, and cannot be removed. 
Their data type and domain cannot be changed. 


Name 


position 


radius 


Type 


Vector 


Float 


Domain Notes 


Point 


Point 


Built-in attribute 
describing vertex or 
point locations, in the 
local space of a 
geometry. Any node that 
changes the location of 
points will adjust this 
attribute, like the 
Transform and Set 
Position nodes. 


A built-in attribute on 
point clouds used to set 
the size for the points in 
the viewport. Also built- 
In on curves, where it 
controls the size of each 
curve control point when 
converted to a mesh, or 
for other operations. 


Name 


id 


Type 


Integer Point 


Domain Notes 


material index Integer Face 


crease 


Float 


Edge 


Created by the Distribute 
Points on Faces to 
provide stability when 
the shape of the input 
mesh changes, and used 
on instances to create 
motion blur. Values are 
expected to be large, 
with no order. This 
attribute is used by 
nodes that generate 
randomness, like the 
Random Value Node. 
Unlike other built-in 
attributes, this attribute 
is not required, and can 
be removed. 


Used to specify the 
material slot for every 
face in a mesh. 


Edge attribute used by 
the Subdivision Surface 
modifier. The values are 
limited to a range of 0 
and 1. 


Name Type Domain Notes 


Attribute determining if a 
face should have smooth 
Shading enabled in the 
viewport or a render. 


shade smooth Boolean Face 


Determines the number 
of evaluated points 
between two control 
points of a spline. Only 

resolution Integer Spline NURBS and Bézier 
splines have this 
attribute, for poly 
splines, the value is 
always one. 


Determines whether the 
spline has a segment 
that connects its first 
and last control points. 


cyclic Boolean Spline 


Describes the location of 
the left handle of a curve 
control point, on the side 
of the curve’s start. Only 
exists when the curve 
contains a Bézier spline. 


handle left Vector Point 


Name Type Domain Notes 


Describes the location of 
the right handle of a 
curve control point, on 

handle right Vector Point the side of the curve’s 
end. Only exists when 
the curve contains a 
Bézier spline. 


Naming Conventions 


These attributes do not exist by default, but are used 
implicitly by certain parts of Blender. The data type of these 
attributes can be changed, just like any attribute besides 
the built-in attributes. However, the attributes might be 
expected by Blender to have a certain type. 


Name Type Notes 


Used to create motion blur when 


elocity Vector 
‘ ie rendering animations. 


Custom Attributes 


Vertex groups, UV maps and Color Attributes are available 
as attributes in geometry nodes. They are referred to by 
their name. Naming collisions (e.g. a vertex group and a UV 
map with the same name) should be avoided. If there is a 


naming collision, only one of the attributes is accessible in 
geometry nodes. 


Attributes with any other name can also be created by 
nodes, when the name is used for the first time. 


Note that geometry nodes does not always produce e.g. 
vertex groups if a node like Join Geometry is used. Similarly, 
if the data type of a vertex group attribute is changed from 
the initial “Float” type, the attribute will no longer bea 
vertex group. 


Attribute Conversion Operator 


Y Attributes 


Attribute 
Deformation 


UV Map 


Convert Attribute 


& 


This operator found in the Attributes panel of the property 
editor can change the domain or data type of an attribute. 


Due to ongoing development in the area of attributes, many 
areas of Blender can not yet work with the generic 
(identified with a name, stored on any domain with any data 
type)attributes used by geometry nodes. That makes this 
operator an essential workaround in some cases where 
existing tools must be used with data generated from 
geometry nodes. 


Mode 


Generic: Interpolate and convert the attribute 
between the domains and data types 
described on this page. 

UV Map: Create a UV Map layer, editable in the 
UV editor. These would otherwise be 
represented by a 2D vector attribute on 
the face corner domain. 

Vertex Group: Create a Vertex Group from the 
attribute, which corresponds to a float 
attribute on the point domain. 


Note 


This operator only works on original object data, not 
including the results of modifiers, so any attributes added 
or changed by geometry nodes will not be affected. To 
change the type of an attribute generated procedurally, 
modifiers must be applied. 


Fields 


Fundamentally, a field is a function: a set of instructions that 
can transform an arbitrary number of inputs into a single 
output. A field’s result can then be calculated many times 
with different input data. They are used all over geometry 
nodes to allow calculations that have different results for 
every element (mesh vertices, faces, etc.). 


A field input to a node. 


For example, in the figure above, the field connected to the 
“Set Position” node depends on two inputs, Position and 
Index, and transforms them into a vector using a single 
instruction. 


Field Visualization 


Socket shapes are used to convey which sockets are fields 
and which are regular data. There are three possible socket 
Shapes, each visualizing its “field status”: 


Circle: 


Diamond: 


The socket requires a single real value, it 
cannot accept a field input. For output 
sockets, this means the node always 
outputs a single value. 

The socket can accept a field input, or it 
outputs a field. A constant single value 
can be connected to these sockets, but 
then the output will often not vary per 
element. 


Diamond with Dot: 


Y Group Input 


Y Position 


Geometry 


Position 


The socket can be a field, but it is 
currently a single value. This is helpful 
because it allows tracking where single 
values are calculated, instead of a field 
with many different results. It also means 
that Socket Inspection will show the value 
instead of field input names. 


Y Set Position Y Group Output 


Geometry Geometry 


Geometry 


Offset: 


The socket shape is a diamond with a dot, meaning 
the field has the same value for every element. 


Every point will be moved up by 5 m. 


Y Group Input Y Set Position Y Group Output 


Geometry Geometry Geometry 


Geometry 


Offset 
Y Position 


Position 


The socket shape is a diamond and the field input 

now has a varying input. In other words, the value 

can be different for every element. In this case, the 

position will be doubled, since the offset for every 
point is the point’s position. 


Tip 


Often it is desired to extract a single value from a field. 
While it doesn’t make sense conceptually to simply change 
a field into a single value, the Sample Index Node or the 
Attribute Statistic Node can be used to retrieve a single 
value from a field evaluated on a geometry. 


When a connection is made between two node sockets that 
support fields the node connection will be drawn as a 
dashed line. If you make the mistake of connecting a non- 
field socket to a field socket, the connection will be drawn as 
a solid red line indicating that there is an error. 


Node Types 


Nodes can be separated into two categories: data flow 
nodes that usually pass geometry, and field nodes that 
operate on data per-element. Field nodes can be input 


nodes that bring geometry data into the node tree, or 
function nodes that operate on that data. 


Data Flow Nodes 


Nodes with a geometry input and a geometry output will 
almost always be data flow nodes. Meaning that they 
actually change geometry data that will be outputted from 
the Geometry Nodes modifier. 


Function Nodes 


Nodes with diamond socket inputs and outputs are field 
nodes, and resemble the instructions that will be evaluated 
by data flow nodes. Examples of function nodes are the 
math nodes and also more complex nodes like the 


Geometry Proximity Node. 
Input Nodes 


Input nodes provide data to the field evaluation process. By 
themselves, they mean nothing; they must be evaluated 
within the context of a data flow node (geometry) to 
actually output a value. Examples of input nodes are the 
built-in attribute input nodes like Position and |D, but also 
selection nodes like Endpoint Selection. 


Field inputs may also come from other nodes that process 
geometry like the Distribute Points on Faces, in the form of 
Anonymous Attributes. 


Field Context 


All field nodes work in the context of the data flow node 
they are connected to. The context usually consists of a 
geometry component type and an attribute domain, so it 
determines what data is retrieved from input nodes. 


One common misunderstanding is that the same field node 
tree used in multiple places will output the same data. This 
is not necessarily true, because the field node tree will be 
evaluated for every data flow node, potentially retrieving 
data from a different or changed geometry. 


Here, the Set Position node’s input field is evaluated once. 
To evaluate the field, the node traverses backwards to 
retrieve the inputs from the field input nodes. 


When a second Set Position node is added, the same field 
node tree is evaluated twice, once for each data flow node. 


At the second Set Position node, the results will be different 
since its geometry input will already have the changed 
position from the first node. 


However, often it’s necessary to use the same field values 
even after changing the geometry. The Capture Attribute 
Node evaluates a field, copying the result to an anonymous 
attribute on the geometry. 


Here, a Capture Attribute node stores a copy of the initial 
position. Notice that evaluating the field input of the 
Capture Attribute node is an entirely different step. Later on, 
the input fields to the Set Position nodes don’t use the 
actual position, but the anonymous attribute copy of it. 


Instances 


w—~ Evaluated v ‘m) Instancing 


Name Position 
0\f Geometry -1.000 -1.000 
1%& Collection 1.000 1.000 
Bail 
2 @ Object 1.880 12.361 
J 


The three types of instances. 


In addition to storing real data like a mesh or a curve, a 
geometry can store instances, which themselves can 
reference more geometry, or an object, or a collection. The 
purpose of instancing is to allow including much more 
geometry in the result, without duplicating the actual data. 
This is because renderer like Cycles can handle the same 
geometry data in many different locations better than when 
the data is duplicated. 


Each instance keeps track of which geometry it corresponds 
to, and a Iransform. Instances can also store the id 
attribute, used for correct motion blur when instances move 
in an animation. 


The main node used to create instances in geometry nodes 
is the Instance on Points Node. 


Warning 


Currently instancing from geometry nodes cannot be 
mixed with instancing from the Instancing panel in the 
property editor. 


Nested Instancing 


Since instances can store a geometry, and a geometry can 
contain instances, nested instancing is possible. In other 
words, it is possible to instance an instance, or evena 
collection of instances. By default, the Instance on Points 
Node will create nested instances by instancing on the 
points real geometry and instanced geometry. 


A node group that creates nested instancing by 
chaining Instance on Points nodes. 


Here, nested instancing is used to distribute geometry that 
contains both a mesh and instances. The output geometry 
contains a “real” mesh, and a group of instances. Each 
instance contains a sohere mesh and many instances of a 
cone geometry. 


Geometry Output 


Instance Geometry 


Sphere Mesh 


Instance Geometry 


The tree of instanced geometry for the example 
above. 


What makes this method helpful is that the output geometry 
only contains three unique meshes: the plane, the sphere, 
and the cone. This would make the performance much 
better if the meshes were more complicated. 


Warning 


Only eight levels of nested instancing are supported for 
rendering and the viewport currently. Though deeper trees 
of instances can be made inside geometry nodes, they 
must be realized at the end of the node tree. 


Instance Processing 


Almost all nodes that process geometry do so by processing 
each unique geometry in their input’s tree of instances 
separately. For example, if a Subdivision Surface Node was 


placed at the end of the example above, it would only have 
to subdivide three meshes, rather than each instance of a 
mesh. Another important example is processing with the 
output of the String to Curves Node, where each unique 
character only has to be processed once. 


This method can improve performance a lot, but it means 
that the result of an operation will be the same for every 
instance of a certain geometry. In order to have unique 
results for every instance, the Realize Instances Node node 
can be used. 


Attribute Nodes 


Nodes for working with data stored per object element, e.g. 
vertex groups. 


Attribute Statistic Node 
Capture Attribute Node 
Domain Size Node 

Remove Named Attribute Node 
Store Named Attribute Node 


Attribute Statistic Node 


The Attribute Statistic node evaluates 
a field on a geometry and outputs a 
statistic about the entire data set. a 


Median 


Y Attribute Statistic 


Sum 
Min 
Max 
Range 


Standard Deviation 


Variance 


Float v 
Point v 


Geometry 
© Selection 
© Attribute 


Inputs 


Geometry 
Standard geometry input. 


Selection 
A boolean field input for each element indicating whether 
to include its value in the statistics result If the boolean is 
false, the corresponding value from the Attribute input 
will be ignored. 


Attribute 


The attribute field to query a statistic from. 


Properties 
Data Type 

Float: The output will be a single floating- 
point value. 

Vector: The output will be a vector of three 
floating-point values. All calculations 
are elementwise. 

Domain 


The attribute domain used for the statistics and to 
evaluate the input Attribute field on. 


Outputs 
Mean 


The average value of all data. 


Median 
The median value of all data. 


Sum 

The sum value of all data. 
Min 

The min value of all data. 


Max 
The max value of all data. 


Range 
The difference between the max and min value. 


Standard Deviation 
How much values differ from the mean. A low standard 
deviation indicates that the values are grouped tightly 
together at the mean. A high standard deviation 
indicates that the values are spread out over a large 
range. 


Variance 
The variance of all data, defined as the square of the 
standard deviation. 


Capture Attribute Node 


The Capture Attribute node stores the 
result of a field on a geometry, and 
outputs the data as a node socket so it 
can be used by other nodes. 


Y Capture Attribute 


Geometry 
Attribute 


Float Vv 


The result is stored on the geometry 
just like a regular attribute with a 
name, but instead of referencing it Geometry 

with a name, it is retrieved whenever © Value ‘0.000 
the socket is connected to the input of 
a node. Later on when evaluating the 
node tree, the attribute will be 
removed automatically if it is no longer used. 


Point Vv 


This node is essential because field input nodes like the 
Radius Node work in the context of the node they are 
connected to. Meaning that in order to pass data like radius 
to a geometry that doesn’t have radius, an explicit node link 
with the output of this node must be used. 


Note 


Because this node stores an anonymous attribute in the 
geometry, it’s essential to use the geometry output for 
further operations in the node tree. The anonymous 
attribute will not exist for any other geometry besides the 
output. 


Inputs 


Geometry 
Standard geometry input. 


Value 
The input field to evaluate. 


Properties 


Data Type 
The data type used for the evaluated data. 


Domain 
Which attribute domain to store the evaluated data on. 


Outputs 


Geometry 
Standard geometry output. 


Attribute 
The result of the evaluated field, stored on the geometry. 


Examples 


Here, a noise texture is evaluated in along the path of the 
curve in one dimension and rendered with a shader. The 
capture node is required because the output of the Curve to 
Mesh Node does not have a “curve parameter”, since it is a 
mesh and not a curve. So, the Spline Parameter Node must 
be evaluated while the geometry is still a curve. 


Internally, after the noise texture is evaluated on the curve, 
it is automatically copied to the mesh result of the Curve to 
Mesh node. This means that anywhere Attribute output of 
this node can be connected along the same stream of 
geometry nodes, the internal attribute will be available. 


Domain Size Node 


The Domain Size outputs the size of an 
attribute domain on the selected 

geometry type, for example, the Point Count 
number of edges in a mesh, or the Edge Count 
number of points in a point cloud. Face Count 


Face Corner Count 


Y Domain Size 


For more information about attribute 
domains, see the geometry attributes 


VY Mesh v 
page. Geometry 


Inputs 


Geometry 
Standard geometry input. 


Properties 


Component 
Which geometry type to retrieve the domain sizes from. 


Outputs 


Point Count 
The size of the Point domain on any supported geometry. 


Edge Count 
The size of the Edge domain on meshes. 


Face Count 
The size of the Face domain on meshes. 


Face Corner Count 
The size of the Face Corner domain on meshes. 


Spline Count 
The size of the Spline domain on curves. 


Instance Count 
The number of top-level instances in the geometry. 
Nested instances are not considered. 


Remove Named Attribute 
Node 


The Remove Named 
Attribute node deletes an v Remove Named Attribute 
attribute with a certain 
name from its geometry 
input. Any attribute that Geometry 
exists on geometry data 
will be automatically 
propagated when the it is 
changed, which can be an 
expensive operation, so 
using this node can be a simple way to optimize the 
performance of a geometry node tree or even to lower the 
memory usage of the entire scene. 


Geometry 


Name 


Almost all attribute names can be removed. For certain 
Built-In Attributes, removing it will mean that a default value 
will be used instead. For example, removing the cyclic 
attribute on curves means that all curves will be non-cyclic. 


Inputs 


Geometry 
Standard geometry input. 


Name 
Float or Vector input to evaluate. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Store Named Attribute 
Node 


The Store Named Attribute 
node stores the result of a field 
on a geometry as an attribute Geometry 
with the specified name. If the 
attribute already exists, the Float v 
data type and domain will be 
updated to the values chosen 
in the node. However, keep in Geometry 
mind that the domain and data 
type of Built-In Attributes 
cannot be changed. © Value 


vy Store Named Attribute 


Point v 


Name 


Compared with the Capture 
Attribute Node, this node 
basically does the same thing, but the attribute gets a name 
instead of an anonymous reference. For reusing the data in 
the same node tree, the Capture Attribute node might be 
preferrable since it does not create the chance for name 
conflicts in the input geometry. 


Note 


If the input geometry contains multiple geometry 
component types, the attribute will be created on each 
component that has the chosen domain. 


Inputs 


Geometry 
Standard geometry input. 


Value 
The input field to evaluate. 


Name 
The name to give the stored data. 


Properties 


Data Type 
The data type used for the evaluated data. 


Domain 
Which attribute domain to store the evaluated data on. 


Outputs 


Geometry 
Standard geometry output. 


Color Nodes 


Nodes for modifying color data passed through color 
sockets. 


Color Ramp Node 
Combine Color Node 
Mix Node 

RGB Curves Node 
Separate Color Node 


Color Ramp Node 


The Color Ramp Node is 
used for mapping values 
to colors with the use of a image 

gradient. Alpha @ 


Y ColorRamp 


Inputs 


Factor 
The Factor input is used as an index for the color ramp. 


Properties 


Color Ramp 
For controls see Color Ramp Widget. 


Outputs 


Image 
Standard color output. 


Alpha 


Standard alpha output. 


Examples 


Creating an Alpha Mask 


An often overlooked use case of the Color Ramp is to create 
an alpha mask, or a mask that is overlaid on top of another 
image. Such a mask allows you to select parts of the 
background to be shown through. 


Using the Color Ramp node to create an alpha mask. 


In the map above, a black-and-white swirl image, which is 
lacking an alpha channel, is fed into the Color Ramp node as 
a Factor. 


The Color Ramp node is set to a purely transparent color on 
the left end of the gradient, and a fully red color on the 
right. As you can see in the Viewer node, the Color Ramp 
node puts out a mask that is fully transparent where the 
image is black. Black is zero, so Color Ramp outputs the 
color at the left end of the gradient, which is set to 
transparent. The Color Ramp image is fully red and opaque 
where the image is white (which is 1). 


You can verify that the output image mask is indeed 
transparent by overlaying it on top of another image. 


Colorizing an Image 


In this example multiple colors are added to the color 
gradient converting a black-and-white image into a flaming 
swirl. 


1) 


Image 


Alpha @ 


Depth @ 


The shades of gray in the input image are mapped to three 
colors: blue, yellow, and red, all fully opaque (alpha of 1). 
Where the image is black, Color Ramp substitutes blue (the 
first color stop). Where it is some shade of gray, Color Ramp 
outputs a corresponding color from the gradient (bluish, 


yellow, to reddish). Where the image is fully white, the Color 
Ramp outputs red. 


Combine Color Node 


The Combine Color Node combines an v Combine Color 
image from its composite color 

channels. The node can combine 
multiple Color Models depending on v 
the Mode property. 


Color 


Inputs 


The outputs of this node depends on the Mode property (see 
below). 


Alpha 
The color channel that that is responsible for the image’s 
transparency. 


Properties 
Mode 
The color model to output. 
RGB: Combine the three inputs: Red, Green, 
and Blue color channels into a single 
color. 


HSV: 


Combine the three inputs: Hue, 
Saturation, and Value color channels 
into a single color. 

HSL: Combine the three inputs: Hue, 
Saturation, and Lightness color 
channels into a single color. 


Output 


Color 
Standard color output. 


Mix Node 


The Mix Node mixes images by © 
working on the individual and 
corresponding pixels of the two input 


Image 


images. Called “Mix Color” in the Mix aX 
shader, geometry, and texture cane 
context. 
@ 
Important whip 


Image 


As of Blender 3.4 this node has 
been updated in Shader and 
Geometry node editors. Files saved 
with the new node are not forward compatible. 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output image. 

Image 
The background image. The image size and resolution 
sets the dimensions of the output image. 


Image 
The foreground image. 


Properties 


Mix 
The Blend modes can be selected in the select menu. 
See Color Blend Modes for details on each blending 
mode. 


Add, Subtract, Multiply, Screen, Divide, Difference, 
Darken, Lighten, Overlay, Color Dodge, Color Burn, Hue, 
Saturation, Value, Color, Soft Light, Linear Light 


Use Alpha 
If activated, by clicking on the Color and Alpha icon, the 
Alpha channel of the second image is used for mixing. 
When deactivated, the default, the icon background is a 
light gray. The alpha channel of the base image is always 
used. 


Clamp 
Limit the output value between 0.0 and 1.0. 


Outputs 


Image 
Standard color output. 


Examples 


Below are samples of common mix modes and uses, mixing 
a color or checker with a mask. 


Some explanation of the mixing methods above might help 
you use the Mix node effectively: 


Add 
Adding blue to blue keeps it blue, but adding blue to red 
makes purple. White already has a full amount of blue, so 
it stays white. Use this to shift a color of an image. 
Adding a blue tinge makes the image feel colder. 


Subtract 
Taking Blue away from white leaves Red and Green, 
which combined make Yellow. Taking Blue away from 
Purple leaves Red. Use this to desaturate an image. 
Taking away yellow makes an image bluer and more 
depressing. 


Multiply 


Black (0.0) times anything leaves black. Anything times 
White (1.0) is itself. Use this to mask out garbage, or to 
colorize a black-and-white image. 


Hue 
Shows you how much of a color is in an image, ignoring 
all colors except what is selected: makes a monochrome 
picture (style ‘Black & Hue’). 


Mix 
Combines the two images, averaging the two. 


Lighten 
Like bleach makes your whites whiter. Used with a mask 
to lighten up a little. 


Difference 
It takes out a color. The color needed to turn Yellow into 
White is Blue. Use this to compare two very similar 
images to see what had been done to one to make it the 
other; sort of like a change log for images. You can use 
this to see a watermark (See Watermark images) you 
have placed in an image for theft detection. 


Darken 
With the colors set here, it’s like looking at the world 
through rose-colored glasses. 


Note 


Only add, subtract, multiply and divide are suitable for 
Scene Referenced images. 


Contrast Enhancement 


Here is a small node tree showing the effects of two other 
common uses for the RGB Curve: Darken and Contrast 
Enhancement. You can see the effect each curve has 
independently, and the combined effect when they are 
mixed equally. 


Example node setup showing “Darken”, “Enhance 
Contrast” and “Mix” nodes for composition. 


As you can hopefully see, our original magic monkey was 
overexposed by too much light. To cure an overexposure, 
you must both darken the image and enhance the contrast. 


In the top RGB curve, Darken, only the right side of the 
curve was lowered; thus, any X input along the bottom 
results in a geometrically less Y output. The Enhance 
Contrast RGB (S-shaped) curve scales the output such that 
middle values of X change dramatically; namely, the middle 
brightness scale is expanded, and thus, whiter whites and 


blacker blacks are output. To make this curve, simply click 
on the curve and a new control point is added. Drag the 
point around to bend the curve as you wish. The Mix node 
combines these two effects equally, and Suzanne feels 
much better. 


Watermark Images 


In the old days, a pattern was pressed into the paper mush 
as it dried, creating a mark that identified who made the 
paper and where it came from. The mark was barely 
perceptible except in just the right light. Probably the first 
form of subliminal advertising. Nowadays, people watermark 
their images to identify them as personal intellectual 
property, for subliminal advertising of the author or hosting 
service, or simply to track their image’s proliferation 
throughout the web. Blender provides a complete set of 
tools for you to both encode your watermark and to tell if an 
image has your watermark. 


Encoding your Watermark in an Image 


First, construct your own personal watermark. You can use 
your name, a word, or a shape or image not easily 
replicated. While neutral gray works best using the encoding 
method suggested, you are free to use other colors or 
patterns. It can be a single pixel or a whole gradient; it is up 
to you. In the example below, we are encoding the 
watermark in a specific location in the image using the 
Translate node; this helps later because we only have to 
look at a specific location for the mark. We then use the 
RGB to BW node to convert the image to numbers that the 
Map Value node can use to make the image subliminal. In 
this case, it reduces the mark to one-tenth of its original 
intensity. The Add node adds the corresponding pixels, 


making the ones containing the mark ever-so-slightly 
brighter. 


Embedding your mark in an image using a mark and 
specific position. 


Of course, if you want people to notice your mark, do not 
scale it So much, or make it a contrasting color. There are 
also many other ways, using other mix settings and fancier 


rigs. Feel free to experiment! 
Hint 
Additional uses 


You can also use this technique, using settings that result 
in visible effects, in title sequences to make the words 
appear to be cast on the water’s surface, or as a special 
effect to make words appear on the possessed girl’s 


forearm. 


Decoding an Image for your Watermark 


When you see an image that you think might be yours, use 
the node tree below to compare it to your stock image (pre- 


watermarked original). In this tree, the Mix node is set to 
Difference, and the Map Value node amplifies any 
difference. The result is routed to a viewer, and you can see 
how the original mark clearly stands out. 


Checking an image for your watermark. 


Various image compression algorithms lose some of the 
Original; the difference shows as noise. Experiment with 
different compression settings and marks to see which 
works best for you by having the encoding node group in 
one scene, and the decoding group in another. Use them 
while changing Blender’s image format settings, reloading 
the watermarked image after saving, to get an acceptable 
result. In the example above, the mark was clearly visible all 
the way up to JPEG compression of 50%. 


RGB Curves Node 


The RGB Curves Node allows 
color corrections for each color 
channel and levels 
adjustments in the Standard Filmlike 
compositing context. 

P g mR G B @MOe - 


Y RGB Curves 


Image 


& Fac 


Image 


White Level 


Black Level 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output image. 


Image 
Standard color input. 


Black Level Compositor Only 


Defines the input color that is (linear) mapped to black. 


White Level Compositor Only 
Defines the input color that is (linear) mapped to white. 


Tip 


To define the levels, use the eyedropper to select a color 
sample of a displayed image. 


Properties 


Tone Compositor Only 
Standard: TODO 2.8 
Film Like: TODO 2.8 


Channel 
Clicking on one of the channels displays the curve for 
each. 


C (Combined RGB), R (Red), G (Green), B (Blue) 


Curve 
A Bézier curve that varies the input levels (X axis) to 
produce an output level (Y axis). For the curve controls 
see: Curve widget. 


Outputs 


Image 
Standard color output. 


Examples 


Below are some common curves you can use to achieve 
desired effects. 


From left to right: 1. Lighten shadows 2. Negative 3. 
Decrease contrast 4. Posterize. 


Color Correction using Curves 


Image 
Standard Film like 


CcRicis @©9Ov ex 


) as 


¥Y Use Alpha 
Image 
Alpha 1.000 
z 1.000 


Color correction with curves. 


In this example, the image has too much red in it, so we run 
it through an RGB Curves node and reduce the Red channel. 


Also, read on for examples of the Darken and Contrast 
Enhancement curves, here. 


Color Correction using Black/White Levels 


y RGB Curves 
Image 


Standard Film like 


Gros OOS 


Color correction with Black/White Levels. 


Manually adjusting the RGB curves for color correction can 
be difficult. Another option for color correction is to use the 
Black and White Levels instead, which really might be their 
main purpose. 


In this example, the White Level is set to the color of a 
bright spot of the sand in the background, and the Black 
Level to the color in the center of the fish’s eye. To do this 
efficiently it is best to bring up the Image Editor showing the 
Original input image. You can then use the levels’ color 
picker to easily choose the appropriate colors from the input 
image, zooming into pixel level if necessary. The result can 
be fine-tuned with the R, G, and B curves like in the previous 
example. 


The curve for C is used to compensate for the increased 
contrast that is a side effect of setting Black and White 
Levels. 


Effects 


Image 


vy Render Layers © 


Standard Film like 


Image 


C RG B 


O9Nv ex 


X 1.00000 Y 0.00000 


@ | Fac 1.000 


Image 


Changing colors by inverting the 


¥ Use Alpha 
Image 

Die) Alpha 

® Z 


red channel. 


Separate Color Node 


The Separate Color Node splits an \ Separate Color 
image into its composite color 
channels. The node can output 
multiple Color Models depending on 
the Mode property. ates 


Red © 
Green © 


Alpha © 


vw 


Inputs 


Color 
Standard color input. 


Properties 
Mode 

The color model to output. 

RGB: Split the input colors into it’s three 
outputs: Red, Green, and Blue color 
channels. 

HSV: Split the input colors into it’s three 


outputs: Hue, Saturation, and Value 
color channels. 

HSL: Split the input colors into it’s three 
outputs: Hue, Saturation, and Lightness 
color channels. 


Outputs 


The outputs of this node depends on the Mode property (see 
above). 


Alpha 
The color channel that that is responsible for the image’s 


transparency. 


Curve Nodes 


Nodes that only operate on curves. 


Curve Length Node 
Curve to Mesh Node 
Curve to Points Node 
Deform Curves on Surface Node 
Fill Curve Node 

Fillet Curve Node 
Resample Curve Node 
Reverse Curve Node 
Sample Curve Node 
Subdivide Curve Node 
Trim Curve Node 


Curve Handle Position Node 
Curve Tangent Node 

Curve Tilt Node 

Endpoint Selection Node 
Handle Type Selection Node 
Is Spline Cyclic Node 

Spline Length Node 

Spline Parameter Node 
Spline Resolution Node 


Set Curve Radius Node 
Set Curve Normal Node 
Set Curve Tilt Node 

Set Handle Positions Node 


Set Handle Type Node 
Set Spline Cyclic Node 


Set Spline Resolution Node 
Set Spline Type Node 


Curve Length Node 


Y Curve Length 


Length @ 


The Curve Length node outputs the length of all splines 
added together. 


Inputs 


Curve 
Standard geometry input. 


Properties 


This node has no properties. 


Output 


Length 
Accumulated length of all splines of the curve. 


Curve to Mesh Node 


Y Curve to Mesh 


Mesh 
Curve 


Profile Curve 


® Fill Caps 


The Curve to Mesh node converts all splines of a curve to a 


mesh. Optionally, a profile curve can be provided to give the 
curve a custom shape. 


The node transfers attributes to the result. Attributes that 
are built-in on meshes but not curves, like shade smooth, will 
be transferred to the correct domain as well. 


Tip 


The output mesh has auto smooth set and sharp edges 
from the profile curve tagged automatically. If any splines 
in the profile curve are Bézier splines and any of the 
control points use Free or Vector handles, the 
corresponding edges will be shaded sharp. 


Inputs 


Curve 


Standard geometry input. All non-curve components are 
ignored. 


Profile Curve 
If a profile curve is provided, it will be extruded along all 
splines. Otherwise the generated mesh will just be a 
chain of edges. 


Fill Caps 
If the profile spline is cyclic, fill the ends of the generated 
mesh with n-gons. The resulting mesh is Manifold, the 


two new faces for each spline are simply connected to 
existing edges. 


Properties 
This node has no properties. 


Outputs 


Mesh 
Standard geometry output. 


Curve to Points Node 


The Curve to Points node generates a 
point cloud from a curve. 


Y Curve to Points 


Points 


Tangent 


Normal 


Rotation 


Inputs 


Curve 
Standard curve input. 


Count 
Number of points generated. This input is only available 
for Count mode. 


Length 
Length of the curve. This input is only available for 
Length mode. 


Properties 


Mode 


Evaluated: Creates points from the curve’s 
evaluated points based on the 
resolution attribute for NURBS and 
Bézier splines. This mode will generally 
be the fastest, since the second step of 
Sampling equal lengths is not 


necessary. 

Count: Sample each spline by evenly 
distributing the specified number of 
points. 

Length: Sample each spline by splitting it into 


segments with specified length. The 
length will be rounded down so that a 
whole number of samples will fit in 
each input spline. To counteract 
jumping when the length of the spline 
changes, the Irim Curve Node can be 
used with a multiple of this length. 


Outputs 


Points 
Generated point cloud. 


Tangent 
The normalized curve tangent at the sampled position, or 
the direct evaluated normal in Evaluated mode. 


Normal 
The normal value from the evaluated curve at each result 
point. This is the same value from the Normal Node at 
those positions. 


Rotation 


The Euler rotation build from the Tangent and Normal 
outputs, for convenience. 


Deform Curves on Surface 
Node 


Y Deform Curves on Surface 


Curves 


Curves 


The Deform Curves on Surface node translates and rotates 
each curve based on the difference in its root position. The 
root position is defined by UV coordinates stored on each 
curve and the UV Map selected for the purpose in the 
Curves surface settings. 


The transformation is calculated based on the difference of 
the original mesh (before shape keys and modifiers are 
evaluated), and the final mesh. 


Unlike other geometry nodes, this node has quite a few 
implicit inputs: 


e The original and evaluated mesh are retrieved from the 
modifier object’s surface property. This means the node 
only works for curves objects. 

e The original and evaluated UV map are also retrieved 
from the object’s surface property. 

e A 3D vector attribute named rest position, used for 
calculating tangents for rotating curves that are 
consistent with the tangents calculated on the original 
mesh (the rotation needs to be calculated from the 
normal and tangent of the original and evaluated 
meshes). 


e A 2D vector attribute on the curve domain named 
surface _uv_ coordinate to store the location of the root 
positions on the surface mesh’s UV map. 


In future development, this node will be generalized so the 
setup is more flexible. 


Parts of the internal operation are similar to the Sample UV 
Surface Node. 


Inputs 


Curves 
Standard curves input. 


Properties 


This node has no properties. 


Outputs 


Curves 
Standard curves output. 


Fill Curve Node 


Y Fill Curve 


Mesh 


Triangles N-gons 


Curve 


The Fill Curve node generates a mesh using the constrained 
Delaunay triangulation algorithm with the curves as 
boundaries. The mesh is only generated flat with a local Z of 
0. 


Inputs 


Curve 
Standard geometry input with a curve component. 


Properties 

Mode 
The type of geometry the output consists of. 
Triangles: The output is made up of triangles. 
N-gons: The output is made up of n-gons. 

Outputs 


Mesh 


The filled in curves. 


Examples 


A single point spline can be used to customize the 
triangulation of the resulting mesh. 


Curve @, 
: © Fill Curve 
Points 8 \ 
\ v Join Geometry Y Group Output 
Inner Radius 1m \ ~ = 

\ Geometry @ ® Geometry 
Outer Radius 2m 


> i Geometry 


Twist 0° 


vy Object Info 


Geometry ® 


Original 


@_ Single PointCurve xX 


Here a curve object with a single spline with a single 
point at the origin is joined with the star primitive to 
customize triangulation. 


© Fill Curve 


Points \ = 
\ v Join Geometry Mesh @ Y Group Output 


Inner Radius 1m \ orezrar 
\ Geometry @ Geometry 


Outer Radius 2m N-gons 


Twist o° on Q Geometry 


v Object Info 


Geometry @ 


Original 


This is the default triangulation without the single 
point. 


Fillet Curve Node 


The Fillet Curve rounds corners on 
curve control points, similar to the 
effect of the Bevel Modifier on a 2D Sallis 
mesh. However, a key difference is Bezier Poly 
that the rounded portions created by 
the Fillet Curve node are always 
portions of a circle. 


Y Fillet Curve 


Curve 


© Radius 0.25m 


& Limit Radius 


Inputs 


Curve 
Standard geometry input with a curve component. 


Radius 
The radius of the circle portion generated at each fillet. 


Count 
Only in Poly mode, the number of control points to add 
for each fillet. 


Limit Radius 
Whether to limit the maximum value of the radius in 
order to avoid overlapping fillets. 


Properties 


Method 


Bézier: Only two control points will be 
generated for every filleted control 
point. The shape generated by the 
aligned handles on the generated 
control points on either side of the fillet 
is used to create the circle portion 
shape, meaning that the number of 
segments in the fillet shape depends 
on the spline’s resolution value. 

Poly: The number of control points generated 
for each field input is controlled directly 
with an integer field input. This mode 
works better for poly and NURBS 
splines. 


Outputs 


Curve 
Standard geometry input with a curve component. 


Examples 


¥ Curve to Mesh 


The node can be used to round the corners of simple 
3D poly splines. 


wy Fillet Curve 2 


v Group Output 


Curve Geometry 


Points 8 Triangles 


InnerRadius 1m 2 - 
Curve Curve 
Outer Radius 2m 
Count 8 
Twist On 
> Radius 0.25m 


@ Limit Radius 


The node can be combined with the curve primitive 
nodes to make more interesting shapes. 


Resample Curve Node 


Y Resample Curve 


Curve 
Count v 


Curve 
© Selection 


Count 


The Resample Curve node creates a poly spline for each 
input spline. In the Count and Length modes, the control 
points of the new poly splines will have uniform spacing. 


Tip 


Use a field as an input to have a different count/length for 
each spline. 


Inputs 


Curve 
Standard geometry input. 


Selection 


Whether or not to resample each spline. True values 
mean spline will be resampled to a poly spline, false 
values mean the spline will be unaffected. 


Count 


The number of control points on the new splines. 


Length 


The approximate length between the control points of the 
new splines. 


Tip 
A Trim Curve Node can be used with a multiple of the 


input length to make the distance between each 
Sampled point exact, even when the length of the spline 


changes. 
Properties 
Mode 
How to specify the amount of samples. 
Count: Sample the specified number of points 
along each spline. 
Length: Calculate the number of samples by 


splitting each spline into segments with 
the specified length. The length will be 
rounded down so that a whole number 
of samples will fit in each input spline. 

Evaluated: Evaluate the spline’s points based on 
the resolution attribute for NURBS and 
Bézier splines. Changes nothing for 
poly splines. 


Outputs 


Curve 


Standard geometry output. 


Reverse Curve Node 


Y Reverse Curve 
Curve 


Curve 


© Selection 


The Reverse Curve node swaps the start and end of splines. 
The shape of the splines is not changed. 


Tip 


When used on the Profile input of the Curve to Mesh Node, 
this node fill flip the normals of the resulting mesh. 


Inputs 


Curve 
Standard geometry input. 


Selection 
Whether or not to change the direction of each spline. 


True values mean the direction will be changed, false 
values mean the spline will be unaffected. 


Properties 


This node has no properties. 


Outputs 


Curve 
Standard geometry output. 


Sample Curve Node 


The Sample Curve calculates a point v Sample Curve 
on a curve at a certain distance from 

the start of the curve, specified by the 
length or factor inputs. It also outputs 
data retrieved from that position on Tengen 
the curve. The sampled values are Normal 
linearly interpolated from the values 

at the evaluated curve points at each 
side of the sampled point. foe, Length 


All Curves 


Note Curves 


Value © 


Position 


Float v 


© Value 
© Factor 0.000 


When the curve contains multiple 
splines, the sample position is found 
based on the total accumulated Serscllocs 
length, including the lengths of all 
previous splines. The order of the 
splines is the same order as displayed in the Spreadsheet 
Editor. 


Inputs 


Curves 
Standard geometry input with a curve component. 


Input 
A field input to evaluate custom attributes. The 
evaluation is outputted through the Va/ue output. 


Factor Factor mode 


The portion of the total length used to determine the 
Sample position. 


Length Length mode 
A length in distance units used to determine how far 
along the curve to travel before sampling. 


Curve Index 
An index to only evaluate specific splines, these indices 
can be specified manually or from the Index Node. This 
input is ignored when the Al/ Curves property is enabled. 


Properties 


Data Type 
The data type used for the evaluated data. 


Mode 
How to find endpoint positions for the trimmed spline. 
The option acts the same as it does in the Trim Curve 
Node. 


Factor: Find the endpoint positions using a 
factor of each spline’s length. The input 
values should be between 0 or 1. 

Length: Find the endpoint positions using a 
length from the start of each spline. 
The input values should be between 0 
and the length of the splines. 


All Curves 
Sample lengths based on the total length of all curves, 
rather than using a length inside each selected curve. 


Outputs 


Value 
The value of the input Va/ue at the sample point. 


Position 
The position at the sample along the spline. 


Tangent 
The normalized curve tangent at the sample. 


Tip 

This output can be combined with the Align Euler to 
Vector Node to create a rotation that lines up with 
direction of the curve. Including the Normal output in a 


second align node after can align the other rotation 
axis. 


Normal 
The normalized curve normal at the sample. 


Examples 


© Set Position 


Y Object Info 


~ Separate XYZ 


Here, the Count mode of the iS 
recreated, except a mesh is used for the result instead of a 
curve. The Z axis of the position can be used as the sample 
factor because the position is between zero and one for the 
entire line. 


Subdivide Curve Node 


Y Subdivide Curve 


Curve 


The Subdivide Curve node adds more control points in 
between existing control points on the curve input. For 
Bézier and poly splines, the shape of the spline will not be 
changed at all. 


With Bézier curves, this can be used to increase the control 
on the shape of the curve while still having the higher-level 
provided by Bézier splines. Unlike the Resample Curve 
Node, where they are converted to poly splines. 


Inputs 


Curve 
Standard geometry input. 


Cuts 
The number of control points to create on the segment 
following each point. When the input is a field, the 
number of cuts for a segment is determined by the value 
of the field when evaluated at the previous point. 


Properties 


This node has no properties. 


Outputs 


Curve 
Standard geometry output. 


Trim Curve Node 


Y Trim Curve 


Curve 


Factor Length 


Curve 
> Start 
> 


The Trim Curve node shortens each spline in the curve by 
removing sections at the start and end of each spline. 


Bézier splines will still be Bézier splines in the output, with 
the first and last control point and its handles moved as 
necessary to preserve the shape. NURBS splines will be 
transformed into poly splines in order to be trimmed. 


Warning 


Currently the Trim Curve node does not support cyclic 
splines. 


Note 


Since curve normals are calculated the final curve, this 
node may change the resulting normals when the 
Minimum twist method is used, since the Minimum method 
considers the entire length of the curve to decide the final 
normals. In some cases the Capture Attribute Node could 


be used to avoid this, by saving the original normals to be 
used later. 


Inputs 


Curve 
Standard geometry input with a curve component. 


Start 
The factor or length used to determine where to start 


each output spline. 


Note 
If the Start input is larger than the End, then the 


resulting spline will have a single point, located at the 
sample location of the Start value. 


End 
The factor or length used to determine where to end 


each output spline. 


Properties 


Mode 
How to find endpoint positions for the trimmed spline. 


Find the endpoint positions using a 
factor of each spline’s length. The input 
values should be between 0 or 1. 


Factor: 


Length: 


Find the endpoint positions using a 
length from the start of each spline. 
The input values should be between 0 
and the length of the splines. 


Outputs 


Curve 
Standard geometry output. 


Curve Handle Position 
Node 


The Curve Handle Position node 
outputs the position of each of a 
Bézier spline’s handles. If the curve 
does not contain Bézier splines, the bet 
node will output zero. © Relative 


Y Curve Handle Positions 


Left 


The node to set this data is the Set 
Handle Positions Node. 


Inputs 


Relative 
Output the handle positions relative to the corresponding 
control point instead of in the local space of the 
geometry. 


Properties 


This node has no properties. 


Outputs 


Left 
The position of the each control point’s left handle. 


Right 
The position of the each control point’s right handle. 


Curve Tangent Node 


The Curve Tangent node outputs the 
. . : ; Y Curve Tangent 

direction that a curve points in at each 

control point, depending on the Lope 

direction of the curve (which can be 

controlled with the Reverse Curve 

Node). The output values are normalized vectors. 


Warning 


For NURBS and Bézier spline curves, keep in mind that the 
value retrieved from this node is the value at every control 
point, which may not correspond to the visible evaluated 
points. For example, a Bézier spline might have 48 
evaluated points, but only four control points, if its 
resolution is 12. For NURBS splines the difference may be 
even more pronounced and the result may not be as 
expected. A Resample Curve Node can be used to create a 


poly spline, where there is a control point for every 
evaluated point. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Tangent 
The direction of the curve at every control point. 


Curve Tilt Node 


The Curve Tilt node outputs the angle 
used to turn the curve normal around 
the direction of the curve tangent in 
its evaluated points. Keep in mind that 
the output is per control point, just like 
the values that can be controlled in curve Edit Mode. For 
NURBS and Bézier splines, the values will be interpolated to 
the final evaluated points. 


Y Curve Tilt 


The input node for this data is the Set Curve Tilt node. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Tilt 
The tilt angle for the normal in radians. 


Endpoint Selection Node 


The Endpoint Selection node provides 
a selection for an arbitrary number of 
endpoints in each spline in a curve. 


Y Endpoint Selection 


Selection 


Start Size 1 
Note End Size 1 


The selection operates for every 

control point. This may not 

correspond to the evaluated points displayed in the 
viewport for NURBS and Bézier splines, where one control 
point may correspond to many evaluated points. 


Tip 


To use this data after the curve has been converted to 
another data type like mesh or a point cloud, the Capture 
Attribute Node can be used. 


Inputs 


Start Size 
The number of points to select from the start. 


End Size 
The number of points to select from the end. 


Properties 


This node has no properties. 


Outputs 


Selection 
Selection of the start and end of each spline of the curve. 


Examples 


~ Endpoint Selection 


Selection @——~ 


Start Size 4 


End Size 1 


Anywhere the geometry is a curve, this node can be used to 
generate a selection of only the first and last points of each 
spline. Here, the Points input of the Instance on Points Node 
iS a curve consisting of the poly spline shown in Edit Mode. 


Handle Type Selection 
Node 


Y Handle Type Selection 


Selection @ 


Right 


Creates a selection based on the handle types of the control 
points. 


The handle type of each control point can be changed with 
the Set Handle Type Node. 


Inputs 


This node has no inputs. 


Properties 


Mode 
Whether to consider left and/or right handles. When both 
are selected, the output value is true if either of the 
handles are of the chosen type. 


Left: Consider the left handle. 
Right: Consider the right handle. 


Handle Type 


Handle type for which the selection will be true. See the 
Bézier curves page for more details on the different 
handle types. 


Outputs 


Selection 
Boolean field set to true wherever the handle type 
matches. 


Is Spline Cyclic Node 


The Is Spline Cyclic controls whether 
each of the curve splines start and 
endpoints form a connection. Its She Sy 
output corresponds to the built-in 
cyclic attribute on the curve spline 
domain. 


Y Is Spline Cyclic 


The node to set this data is the Set Spline Cyclic Node. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Cyclic 
Whether the spline is cyclic. 


Spline Length Node 


The Spline Length node outputs the 
total length of each spline, asa 
distance, or a number of points. This is 
different than the Curve Length node, pees 
which adds up the total length for all 
of the curve’s splines. 


Y Spline Length 


Length 


The output values correspond to the spline domain, but the 
node can be used to output a value for every curve control 
point as well. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Length 
The length of each spline. 


Point Count 
The number of control points in each spline. 


Spline Parameter Node 


The Spline Parameter node outputs 
how far along each spline a control 


Y Spline Parameter 


point is. The Factor output is different Factor 
from dividing the index by the total Length @ 
number of control points, because the Index 


control points might not be equally 
spaced along the curve. 


The first value is zero, so the output corresponds to the 
length at the control point rather than including the length 
of the following segment. 


When used on the spline domain, the node outputs the 
portion of the total length of the curve (including all splines) 
has been traversed at the start of each spline. The order of 
the curve’s splines is visible in the Spreadsheet Editor. 


Warning 


For NURBS and Bézier spline curves, keep in mind that the 
value retrieved from this node is the value at every control 
point, which may not correspond to the visible evaluated 
points. For NURBS splines the difference may be even 
more pronounced and the result may not be as expected. 
A Resample Curve Node node can be used to create a poly 
spline, where there is a control point for every evaluated 
point. 


Note 


When the Length is zero, the Factor is arbitrary. In this 
case the result is exceptionally calculated dividing the 
index by the total number of control points or curves. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Factor 
When the node is used on the point domain, the value is 
the portion of the spline’s total length at each control 
point. On the spline domain it is the portion of the 
curve’s total length at the start of the spline. 


Length 
When the node is used on the point domain, the value is 
the distance along the spline to each control point. On 
the spline domain it is the length along the entire curve 
at the start of the spline. 


Index 
Each control point’s index on its spline. This is different 
from the output of the index node, which also counts the 
control points in all previous splines. 


Examples 


~ 


Ely Curve Parameter (Gx 


Spiral ~ Set Curve Radius ~ Curve to Mesh ~ Group Output 


Curve ©———_______ Curve @ Mesh @ @ Geometry 
Resolution 32 re @ Curve @ Curve 


Rotations 2.000 = © Selection 
¥Y Spline Parameter 


Start Radiu 1m @ Radius @ YFill Caps 
Factor @ / 
End Radius 2m 


Height 3.07m 


®@ Profile Curve 


Length @ 


v Curve Circle 
Index 
Reverse Curve @ 


Points 
Resolution 32 


® Radius 1m 


The parameter used to control the radius of the curve. The 


beginning of the spline has a radius of 0, the end has a 
radius of 1. 


Spline Resolution Node 


The Spline Resolution outputs the 
number of evaluated curve points that 
will be generated for every control beset 
point on the spline. This node works 
for NURBS and Bézier splines, for poly 
splines, there is a one-to-one correspondence between 
Original points and evaluated points, so the resolution value 
will be 1. 


Y Spline Resolution 


On Bézier splines, the resolution does not have an effect on 
segments between vector handles, since there are no extra 
evaluated points between the neighboring control points. 


The node to set this data is the Set Spline Resolution Node. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Resolution 
The integer resolution value for each spline. 


Set Curve Radius Node 


The Set Curve Radius controls the 
radius of the curve, used for 
operations like the size of the profile in 
the Curve to Mesh node. The value is Curve 
set for every control point, and is then © Selection 
interpolated to each evaluated point in [RagaiGerits 
between the control points. 


Y Set Curve Radius 


Curve 


The input node for this data is the 
Curve Radius node. 


Inputs 


Geometry 
Standard geometry input, containing curves. 


Selection 
Whether or not to change the value on each control 
point. True values mean the value will be changed, false 
values mean the value will remain the same. 


Radius 
The radius value for each control point. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Set Curve Normal Node 


The Set Curve Normal controls the 
method used to calculate curve 
normals for every curve. Curve 


vy Set Curve Normal 


The node doesn’t set the normals Minimum Twist  v 
directly, those are calculated later 
as necessary. Combined with the 
tilt attribute value at each control © Selection 
point, this will define the final 
normals accessible with the 
Normal Node. 


Curve 


Internally this node adjusts the values of the normal_mode 
attribute on each curve. 


Inputs 


Curve 
Standard geometry input, containing curves. 


Selection 
Whether or not to change the value on each curve. 


Properties 


Mode 
The method for evaluation of the curve’s normals 


Minumum Twist: 


The final normals are calculated to 
have the smallest twist around the 
curve tangent across the whole curve. 

Z-Up: The final normals are calculated so that 
they is perpendicular to the Z axis and 
the tangent. If a series of points is 
vertical, the X axis is used 


Outputs 


Curve 
Standard geometry output. 


Set Curve Tilt Node 


The Set Curve Tilt controls the tilt 
angle at each curve control point. That 


Y Set Curve Tilt 


angle rotates normal vector which is Curve 
generated at each point when Curve 
evaluating the curve. The normal then © Selection 

can be retrieved with the Normal © Tilt 

Node. 


The rotation of the normal vector is an 

Axis Angle rotation. It is the same as the Vector Rotate Node 
operation with the tangent vector as the axis, the raw 
evaluated normal is used as the original vector, and the tilt 
as the rotation angle. 


The input node for this data is the Curve Tilt Node. 


Inputs 


Curve 
Standard geometry input, containing curves. 


Selection 
Whether or not to change the value on each control 
point. True values mean the value will be changed, false 
values mean the value will remain the same. 


Tilt 
The tilt angle for each control point. 


Properties 


This node has no properties. 


Outputs 


Curve 
Standard geometry output. 


Set Handle Positions Node 


The Set Handle Positions node sets the 
positions for the handles of Bézier 
curves. They can be used to alter the Sule 
generated shape of the curve. The Left Right 
input node for this data is the Curve 
Handle Position Node. See the Bézier 
curves page for more details. 


Y Set Handle Positions 


Curve 


© Selection 


Position 
Offset: 
0.000 
0.000 
0.000 


Note 


When the position is changed, Auto 
handle types will be converted to 
Aligned, and Vector handle types will 
be converted to Free. 


Note 


The left and right handles cannot be changed at the same 
time with this node. That is because it would break the 
alignment for left and right handles at the same control 
point. 


Inputs 


Curve 
Standard geometry input, containing curves. 


Selection 


Whether or not to change the handle position on each 
control point. True values mean the resolution will be 
changed, false values mean the resolution will remain 
the same. 


Position 
The new handle position. 


Note 


The handle positions are the global position of the handle, 
they are not relative to the position of the corresponding 
control point. 


Offset 
An optional translation for each handle. This is evaluated 
at the same time as the Position input, meaning that 
fields evaluated for it will not reflect the changed 
position. 


Properties 


Left / Right 
Whether to set the handle position of the left or right 
handle. The Left handle is closer to the start of the 
spline, and the Right handle is closer to the end. 


Outputs 


Curve 
Standard geometry output. 


Examples 


Here, the handles are adjusted to the same position as the 
control points, but offset down in the Z direction slightly. 
With the Set Spline Type Node, the curve can be a poly 
spline in Edit Mode, to make adjustment simpler for the user 
of the node group. 


Set Handle Type Node 


Sets the handle type for the points on 

the Bézier curve that are in the 

selection. Sites 
Left Right 


Y Set Handle Type 


A selection for a certain handle type 
can be retrieved with the Handle Type 


Selection Node. Curve 
© Selection 


(\ Auto 


Inputs 


Curve 
Bézier curve. 


Selection 
The points whose handle types will be changed. 


Properties 


Mode 
Whether to update left or right or both handles. When 
both are selected, both the left and the right handles will 
be updated. 


Left: Update the left handles. 
Right: Update the right handles. 


Handle Type 


The handle type to switch to. See the Bézier curves page 
for more details on the different handle types. 


Outputs 


Curve 
Standard curve output. 


Set Spline Cyclic Node 


The Set Spline Cyclic controls whether 
each spline will loop back on itself. 


Y Set Spline Cyclic 


Each spline has the same number of Sebel 
control points whether or not it is set Geometry 
as cyclic. But when displaying in the © Selection 


viewport or for operations with other © WW) Cyclic 
nodes, a connection will be made 
between the first and last control 
points. 


The input node for this data is the Is Spline Cyclic Node. 


Inputs 


Curve 
Standard geometry input. 


Selection 
Whether or not to change the cyclic value on each spline. 
True values mean the value will be changed, false values 
mean the value will remain the same. 


Cyclic 
Whether or not to join the first and last points of each 
spline. 


Properties 


This node has no properties. 


Outputs 


Curve 
Standard geometry output. 


Set Spline Resolution 
Node 


The Set Spline Resolution node sets 
the value for how many evaluated 


Y Set Spline Resolution 


points should be generated on the Geometry 
curve for every control point. It only Geometry 

has an effect on NURBS and Bézier © Selection 

splines. The evaluated points are Resolution 12 


displayed in the viewport, used in the 
Curve to Mesh Node node, and 
optionally used in the Resample Curve 
Node. 


The input node for this data is the Spline Resolution Node. 


Inputs 


Curve 
Standard geometry input. 


Selection 
Whether or not to change the resolution value on each 
spline. True values mean the value will be changed, false 
values mean the resolution will remain the same. 


Resolution 
The number of evaluated points generated for each 
control point in NURBS and Bézier splines. It controls the 
accuracy of operations like trimming or sampling a curve. 
Higher resolutions are more accurate, but slower. 


Properties 
This node has no properties. 
Outputs 


Curve 
Standard geometry output. 


Set Spline Type Node 


Sets the spline type for the splines in 
the curve component that are in the 
selection. 


Y Set Spline Type 


Curve 


Poly v 


Curve 


© Selection 


Inputs 


Curve 
Standard geometry input with a curve component. 


Selection 
The splines whose spline types will be changed. 


Properties 


Spline Type 
The type to convert the splines in the selection to. Read 
the Spline Types page for more details on the different 
spline types. 


Bézier: Convert to a Bézier spline. 


Note 

When converting from a NURBS spline 
to a Bézier spline, at least six points 
are needed. When the number of 


points is not a multiple of three a full 
conversion is not possible and the 
spline has to be truncated. 


NURBS: Convert to a NURBS Spline. 
Poly: Convert to a poly spline. 
Outputs 
Curve 


Standard curve output. 


Curve Primitive Nodes 


Nodes that create a primitive curve, e.g., a circle. 


Arc Node 

Bézier Segment Node 
Curve Circle Node 
Curve Line Node 
Curve Spiral Node 
Quadratic Bézier Node 
Quadrilateral Node 
Star Node 


Arc Node 


The Arc node generates a poly spline 
arc. The node has two modes, Radius . 
and Points. Sila 


Points Radius 


Resolution 16 


Radius lm 


Start Angle 0° 


Sweep Ang 315° 
Connect Center 


Invert Arc 


Inputs 


Resolution 
Number of edges on the arc. 


Radius 
The radius of the arc. Radius mode only. 


Start Angle 
Starting angle of the arc. Radius mode only. 


Sweep Angle 
Length of the arc. Radius mode only. 


Connect Center 
Connect the arc at the center. 


Invert Arc 


Invert and draw opposite arc. 


Start, Middle, End 
The three points on the arc. Points mode only. The order 
of the points determines the direction (clockwise or 
counterclockwise) of the arc. The arc will always draw 
from Start to End via the Middle point. This can be 
changed by using the Invert Arc option. 


Offset Angle 
Offset angle of the arc. Points mode only. 


Note 


Because of the finite resolution, the middle point does not 
necessarily lie on the generated arc. 


Properties 


Mode 
Points: The position and radius of the arc are 
determined by three points. The center 
of the arc, radius and normal are also 
given as outputs. 
Radius: The arc is determined by the radius, 
start angle and sweep angle. 


Outputs 


Curve 
Poly spline generated from the inputs. 


Center 


The center of the arc described by the three points. 
Points mode only. 


Normal 
The normal direction of the plane described by the three 
points, pointing towards the positive Z axis. Points mode 
only. 


Radius 
The radius of the arc described by the three points. 
Points mode only. 


Bezier Segment Node 


The Bézier Segment node generates a 
2D Bézier spline from the given control 
points and handles. 


Y Bezier Segment 


Curve 


Position Offset 


Resolution 16 


Start: 


Inputs 


Resolution 
The number of edges on the curve. 


Start, End 
Positions of the start and end control point of the curve. 


Start Handle, End Handle 
Positions of the handles used to define the shape of the 
curve. 


Properties 
Mode 
Position: The handle inputs are the absolute 
positions of the handles in 3D space. 
Offset: The handle positions are relative to the 
control point on the curve. The handle 
inputs give the offset from the control 
points. 
Outputs 
Curve 


Bézier spline generated from the inputs. 


Curve Circle Node 


The Curve Circle node generates a 
poly spline circle. 


Y Curve Circle 


Curve 


Points Radius 


Resolution 32 


G Radius 1m 


Inputs 


Resolution 
Number of edges on the circle. 


Radius 
The radius of the circle. 


Point 1, Point 2, Point 3 
The three points on the circle. The order of the points 
determines the direction (clockwise or counterclockwise) 
of the circle. 


Note 


Because of the finite resolution, the three points do not 
necessarily lie on the generated curve. 


Properties 


Mode 
Points: The position and radius of the circle are 
determined by three points. The center 
of the circle is also given as an output. 
If the three points lie on one line, no 
geometry is generated. 
Radius: The circle is determined by the radius. 


Outputs 


Curve 
Poly spline generated from the inputs. 


Center 
The center of the circle defined by the three points. 


Curve Line Node 


Y Curve Line 


Curve 


Points Direction 


Start: 


The Curve Line node generates poly spline line. 


Inputs 


Start 
Position of the first control point. 


End 


Position of the second control point. This is only available 
in the Points mode. 


Direction 
Direction the line is going in. The length of this vector 
does not matter. This is only available in the Direction 
mode. 


Length 
Length of the line. This is only available in the Direction 
mode. 


Properties 
Mode: 
Points: Define the spline with start and end 
points. 
Direction: Define the spline with a start, direction 
and length. 
Outputs 
Curve 


Standard geometry output. 


Curve Spiral Node 


The Curve Spiral node generates a 


poly spline in a spiral shape. It can be eae | 
used to create springs or other similar Curve 
objects. By default the spiral twists in Resolution 32 


a clockwise fashion. Rotations 2.000 
Start Radiu 1m 
End Radius 2m 


Height 2m 


Reverse 


Inputs 


Resolution 
Number of points in one rotation of the spiral. 


Rotations 
Number of times the spiral makes a full rotation. 


Start Radius, End Radius 
Radius of the start point and end point of the spiral. The 
radius of the spiral changes linearly between the two 
values over the whole spiral. 


Height 
Height of the spiral. 


Reverse 
Boolean value that changes the direction from clockwise 
to counterclockwise when it is enabled. 


Properties 
This node has no properties. 
Outputs 


Curve 
Poly spline generated from the inputs. 


Quadratic Bezier Node 


The Quadratic Bézier node generates 
a poly spline curve from the given 
control points. The generated shape is 
a parabola. Resolution 16 


Start: 


Y Quadratic Bezier 


Curve 


Inputs 


Resolution 
The number of edges on the curve. 


Start, Middle, End 
Positions of the three control points. The generated curve 
passes through the two end points, and is tangent to the 
lines between the middle point and the two end points. 


Properties 


This node has no properties. 


Outputs 


Curve 
Poly spline generated from the inputs. 


Quadrilateral Node 


Y Quadrilateral 


Rectangle 


@® Width 
& Height 


The Quadrilateral node generates a polygon with four 
points, with different modes. 


Inputs 


Width / Bottom Width / Top Width 
The X axis size of the shape. 


Height 
The Y axis size of the shape. 


Bottom Height / Top Height 
The distance between the bottom or top point and the X 
axis, in Kite mode. 


Offset 
In Parallelogram mode, the relative X difference between 
the top and bottom edge. In Trapezoid mode, the amount 
to move the top edge in the positive X axis. 


Point 1 - 4 
Input vectors for the Points mode. 


Properties 


Mode 

Rectangle: Generate a rectangle-shaped curve 
with a width and a height. 

Parallelogram: Generate a rectangle with an offset for 
the different X values of the top and 
bottom edges. 

Trapezoid: Generate a trapezoid-shaped curve 
with a height, a width for the top and 
bottom, and an offset. 

Kite: Generate a kite shape with a width, 
and the top and bottom points distance 
from the X axis. 


Points: Generate a four point cyclic poly spline 
by inputting the position vectors 
directly. 

Outputs 
Curve 


Poly spline generated from the inputs. 


Star Node 


The Star node generates a poly spline 
in a star pattern by connecting 
alternating points of two circles. The 


Curve 


points on the inner circle are offset by Outer Points 
a rotation so that they lie in between Points 8 
the points on the outer circle. This Inner Radiu 1m 
offset can be changed with the twist Outer Radiu 2m 


input. Twist 0° 


Inputs 


Points 
Number of points on each of the circles. 


Inner Radius, Outer Radius 
Radii of the two circles on which to place the control 
points. The inner radius can be larger than the outer 
radius. 


Twist 
Angle offset of the inner circle. The twist value rotates 
the points on the circle corresponding with the inner 
radius counterclockwise by the given angle. 


Properties 


This node has no properties. 


Outputs 


Curve 
Poly spline generated from the inputs. 


Outer Points 
A boolean attribute field with a selection of the points on 
the Outer Radius, which is every other point. 


Curve Topology Nodes 


Nodes that retrieve information about the connectivity 
between curves and control points. 


e Curve of Point Node 
e Offset Point in Curve Node 
e Points of Curve Node 


Curve of Point Node 


The Curve of Point node retrieves 
the index of the curve a control v Curve of Point 

point is part of. This node is Cane inde 
conceptually similar to the Face 


of Corner Node. Index in Curve 


Point Index 


Inputs 


Point Index 
The index of the input control point. 


Note 

By default this uses the index from the field context, 
which makes it important that the node is evaluated on 
the point domain. 


Properties 


This node has no properties. 


Outputs 


Curve Index 
The index of the curve the control point is part of. 


Index in Curve 
How far along the control point is along its curve, with a 
value of O for the first point in each curve. 


Offset Point in Curve Node 


The Offset Point in Curve node 


retrieves other points in the same v Offset Point in Curve 
curve as the input control point. Is Valid Offset 
This is like starting at a specific . 

control point and walking along POI MiGex 
neighboring points toward the Point Index 


start or end of the curve. 


Oi 


Conceptually the operation is 
similar to the Offset Corner in 
Face Node, but the point index 
doesn’t wrap around to the other end of the curve unless it 
is cyclic. 


Inputs 


Point Index 
The index of the input control point. 


Note 

By default this uses the index from the field context, 
which makes it important that the node is evaluated on 
the point domain. 


Offset 
The number of points to move around the curve before 
finding the result. If the curve is cyclic and the offset 
goes past the start or end point of the curve, it will wrap 
around to the other side. 


Properties 


This node has no properties. 


Outputs 


Is Valid Offset 
Whether the input control point plus the offset is a valid 
index of the original curve. Any offset in a cyclic curve is 
always valid. 


Point Index 
The index of the offset curve point. 


Points of Curve Node 


The Points of Curve node 
retrieves indices of specific 
control points in a curve. Point Index 


Y Points of Curve 


Total 


Curve Index 


© Weights 


Sort Index 


Inputs 


Curve Index 
The index of the input curve. 


Note 

By default this uses the index from the field context, 
which makes it important that the node is evaluated on 
the curve domain. 


Weights 
Values used to sort the curve’s control points. By default 
the control points are sorted by index, so the control 
points with the smallest indices come first. 


Sort Index 
Which of the sorted control points to use for the Point 
Index output. If the value is larger than the total number 


of control points, it will wrap around to the beginning. 


Properties 


This node has no properties. 


Outputs 


Point Index 
The index of one of the curve’s control points, chosen by 


the Sort Index input. 


Total 
The number of control points in the curve. 


Geometry Nodes 


Nodes that can operate on different geometry types 
(volume, mesh). 


Bounding Box Node 
Convex Hull Node 


Delete Geometry Node 
Duplicate Elements Node 


Geometry Proximity Node 
Geometry to Instance Node 


Join Geometry Node 
Merge by Distance Node 
Raycast Node 

Sample Index Node 

Sample Nearest Node 
Separate Components Node 


Separate Geometry Node 
Transform Node 


Set ID Node 
Set Position Node 


Bounding Box Node 


The Bounding Box node creates a box 
mesh with the minimum volume that 


Y Bounding Box 


encapsulates the geometry of the Peto se 
input. The node also can output the ae 
vector positions of the bounding 

dimensions. Geometry 


The mesh output and the Min and Max 

outputs do not take instances into 

account. Instead, for instanced geometry, a bounding box is 
computed for each instance rather than the whole 
geometry. To compute the bounding box including the 
instances, a Realize Instances Node can be used. 


Inputs 


Geometry 
Standard geometry input. 


Properties 


This node has no properties. 


Outputs 


Bounding Box 
The resulting box that encapsulate the input geometry. 


Min 


The coordinates corresponding to the box’s -X, -Y, -Z 
position values, i.e. how far the box extends in each of 
the negative axes directions. 


Max 
The coordinates corresponding to the box’s +X, +Y, +Z 
position values, i.e. how far the box extends in each of 
the positive axes directions. 


Example 


Bounding Box node used to create a box that 
encapsulates the geometry of the monkey mesh. 


Convex Hull Node 


Y Convex Hull 


Convex Hull 


Geometry 


The Convex Hull node outputs a convex mesh that is 
enclosing all points in the input geometry. 


Note 


When the node is used on a geometry with instances, the 
algorithm will run once per instance, resulting in many 
convex hull meshes in the instance geometries. The 
Realize Instances node can be used to get a convex hull of 
an entire geometry. 


Important 


Volumes are not supported by this node, and attributes are 
not automatically transferred to the result. 


Inputs 


Geometry 
Standard geometry inputs. 


Properties 


This node has not properties. 


Outputs 


Convex Hull 
Mesh that encloses all points in the input. 


Delete Geometry Node 


Y Delete Geometry 


Geometry 


Geometry 


© Selection 


The Delete Geometry node removes the selected part of a 
geometry. It behaves similarly to the Delete tool in Edit 
Mode. The type of elements to be deleted can be specified 
with the domain and mode properties. 


Inputs 


Geometry 
Standard geometry input. 


Selection 
Boolean field that is true for parts of the geometry to be 
deleted. 


Properties 


Domain 
The domain on which the selection field is evaluated. 


Point: The selection is on the points, control 
points, and vertices of the geometry. 

Edge: The selection is on the edges of the 
mesh component. The other 
components are not modified. 

Faces: The selection is on the faces of the 
mesh component. The other 
components are not modified. 

Spline: The selection is on the splines in the 
curve component. For each spline, it 
will either be deleted entirely or not at 
all. The other components are not 
modified. 

Instances: The selection is on the top-level 
instances, and the entire instance is 
removed if it is selected. If the input 
also contains realized geometry, that 
will be unaffected. 


Mode 
The type of elements to be affected. This only applies to 
the mesh component. 


All: Vertices, edges, and faces in the 
selection will be deleted. 

Only Edges & Faces: 
Vertices won’t be deleted, even if they 
are in the selection. 


Only Faces: Only faces in the selection will be 
deleted. 
Output 
Geometry 


Standard geometry output. 


Duplicate Elements Node 


Y Duplicate Elements 


Geometry 


Duplicate Index 


Point v 


Geometry 


© Selection 


Amount 


The Duplicate Elements node creates a new geometry with 
the specified elements from the input duplicated an 
arbitrary number of times. The positions of elements are not 
changed, so all of the duplicates will be at the exact same 
location. 


Inputs 


Geometry 
Standard geometry input. 


Selection 
Boolean field that is true for parts of the geometry to be 
deleted. 


Amount 
Field indicating how many times each input element 
should be duplicated. If the value is zero for an element, 


it will not be included in the output at all. 


Properties 


Domain 
The type of geometry element to duplicate 


Point: Duplicate the points of meshes, curves, 
or point clouds. Any other elements will 
not be included in the output. 


Edge: Duplicate mesh edges. Faces will not 
be included in the output. 
Faces: Duplicate mesh faces. Each duplicated 


face will be separate, in other words 
they will not share edges with other 


faces. 
Spline: Individual curves from the input curves 
component will be duplicated. 
Instances: Input top-level instances will be 
duplicated. 
Output 
Geometry 


Standard geometry output. 


Duplicate Index 
An attribute field with a value for every output element 
describing which duplicate of the corresponding input. 
The value for every input element will start at O and 
increase to Amount - 1. 


Examples 


Combined with the Geometry to Instance Node, this can be 
used to create a basic efficient “Array” operation. This 
should be more efficient because the duplicates are 
instances. 


The “Duplicate Index” is used to move each instance in the 
result a different amount. 


Geometry Proximity Node 


Y Geometry Proximity 


Position 


Distance @ 


Faces v 


Target 


Source Position 


The Geometry Proximity node computes the closest location 
on the target geometry. 


Tip 


The Map Range Node is often helpful to use with the 
distance output of this node to create a falloff with a 
maximum distance. 


Inputs 


Target 
Standard geometry input. 


Source Position 


The given position to calculate the closest location on the 
target. 


Properties 


Target Element 

Faces: Calculate the closest point anywhere 
on the faces of the target’s mesh 
geometry. 

Edges: Calculate the closest point anywhere 
on the edges of the target’s mesh 
geometry. 

Points: Calculate the closest point or vertex on 
the target geometry. This mode is 
usually the fastest. This mode works for 
both point cloud and mesh geometry, 
the other modes only work for meshes. 


Outputs 


Position 
Closest location on the surface of the target mesh, or the 
closest point in the target point cloud in Points mode. 


Distance 
Distance (as floating-point value) from the source 
position to the closest location in the target. 


Examples 


The different modes of the node: faces, edges and points. In 
this example the Geometry Nodes modifier is added on the 
target plane. Note that the larger plane is subdivided and 
the smaller plane is not. 


L) Le) Be 


The three target element modes: faces, edges, and 
points. 


Points distributed on a sphere used as a target fora 
distance used in a shader. 


Geometry to Instance 
Node 


The Geometry to Instance node 
turns every connected input 
geometry into an instance. Visually, aaa 
the node has a similar result as the Geometry 

Join Geometry Node, but it outputs 
the result as separate instances 
instead. The geometry data itself 
isn’t actually joined. 


Y Geometry to Instance 


The node can be used in combination with the Pick 
Instances option in the Instance on Points Node, as a way to 
pick between geometry generated in the node tree (as 
opposed to picking from separate instances from the 
Collection Info Node, for example). 


Tip 


This node can be much faster than the join geometry node 
when the inputs are large geometries. This is because the 
join geometry node must actually create a larger mesh, or 
a larger curve. Even though the operation is simple, just 
creating a large mesh can have a significant cost. This 
node can be better, because instead of merging large 
geometries, it just groups them together as instances. 


Inputs 


Geometry 
Geometry that will be joined. Multiple inputs are allowed. 
When the node is muted, only the first link will be passed 
through. 


Properties 


This node has no properties. 


Output 


Geometry 
Standard geometry output. 


Examples 


Size X 


Size Y 
Vertices X 


Vertices Y 


The node used in combination with the Instance on Points 
Node to choose between multiple primitives for instancing. 


Join Geometry Node 


The Join Geometry node merges separately generated 
geometries into a single one. If the geometry inputs contain 
different types of data, the output will also contain different 
data types. 


Y Join Geometry 


Geometry 


Geometry 


Note 


The node cannot handle the case when more than one 
geometry input has a volume component. 


Materials 


When multiple mesh inputs contain different materials, the 
material slots from each mesh geometry are merged so that 
the output mesh will contain all the input materials. 


Attributes 


When merging attributes from multiple geometry inputs, the 
highest complexity data type is chosen for the output 
attribute. In other words, if a weight attribute has a Boolean 
type on one geometry input and a vector data type on 


another geometry, the weight attribute on the output 
geometry will have a vector data type. The same heuristic is 
used for attribute domains, the domain with the most 
information will be used for the output. 


Warning 


Like other geometry nodes, this node always outputs 
generic typed attributes. So instead of a Vertex Group 
attribute, it will create a “Float” attribute on the result, and 
it will create a generic 2D vector attribute instead of a 
special “UV Map” attribute. Some other areas of Blender 
don’t properly handle generic attributes in version 3.0. 


Custom face corner normals are also not transferred 
Currently. 


Inputs 
Geometry 
Geometry that will be joined. Multiple inputs are allowed. 


When the node is muted, only the first link will be passed 
through. 


Properties 
This node has no properties. 


Output 


Geometry 
Standard geometry output. 


Merge by Distance Node 


The Merge by Distance node merges 
selected mesh vertices or point cloud 


Y Merge by Distance 


points within a given distance, Geometry 
merging surrounding geometry where Geometry 
necessary. This operation is similar to © Selection 


the Merge by Distance operator or the @  Distanc 0.001 m 
Weld Modifier. 


Inputs 


Geometry 
Standard geometry input. 


Selection 


Boolean field that is true for parts of the geometry to be 
deleted. Unselected points will be completely unsed for 

the operation- they will not be merged into other points, 
and no points will merge into them either. 


Tip 

When possible, using the selection input can be a 
simple way to speed up the node, since searching for 
nearby points is a relatively expensive operation that 


gets even more expensive when more points are 
involved. 


Distance 
The distance to use for searching for nearby points. 


Properties 


Mode 
Method for choosing which vertices are merged. 
All: Merge includes all geometry including 
loose parts. 
Connected: Merge only includes attached geometry 


il.e. the modifier will not merge loose 
parts together. 


Output 


Geometry 
Standard geometry output. 


Examples 


Using the selection input to only merge some of the 
points in a point cloud. 


Raycast Node 


Y Raycast 


IsHit > 
Hit Position 
Hit Normal 
Hit Distance @ 
Attribute 


Float v 
Interpolated v 


Target Geometry 
© Attribute 
Source Position 
Ray Direction: 
0.000 
0.000 
-1.000 


o Ray Length 100 m 


The Raycast node intersects rays from one geometry onto 
another. The source geometry is defined by the context of 
the node that the Raycast node is connected to. Each ray 
computes hit points on the target mesh and outputs 
normals, distances and any surface attribute specified. 


Inputs 


Target Geometry 
Geometry that rays are tested against. 


Attribute 
An optional field input evaluated on the Target Geometry 
that will be interpolated at the hit points. The resulting 
values are outputted with the Attribute output. 


Source Position 
The position from where to start each ray. By default, this 
is the same as if the Position Node was connected. 


Ray Direction 
Direction of each ray from the starting position. The field 
is evaluated on the geometry from the context of the 
field evaluation, not the Target Geometry. 


Ray Length 
Maximum distance a ray can travel before being 
considered “no hit”. 


Properties 


Mapping 
How attributes of the target mesh are mapped to the 
attribute values on the result geometry. 


Interpolated: Vertex and corner attributes are 
interpolated smoothly, with a bilinear 
function. 

Nearest: Choose the value of the closest vertex 
without interpolating. 


Outputs 


Is Hit 


Boolean output that is true for each ray which has hit the 
Target Geometry. 


Hit Position 
The location of the intersection point with the target 
mesh. 


Hit Normal 
The surface Normal vector at the hit location. 


Hit Distance 
The distance from the ray origin to the Hit Position. 


Attribute 
Interpolated values of the Attribute input sampled at the 
Hit Position. 


Sample Index Node 


v Sample Index 
Value © 

Float 

Point 


Clamp 


Geometry 
© Value 


Index 


The Sample Index node retrieves values from a source 
geometry at a specific index. 


Tip 


If the Geometry used for the input is the same as the 
geometry from the field context, this node is equivalent to 
the Field at Index Node. Using that node is usually 


preferrable since avoding the geometry socket makes the 
whole setup easier to use in other situations and share. 


Inputs 


Geometry 
The geometry to retrieve the attribute from. 


Value 
A field to evaluate on the source Geometry. The values 
are then retrieved from specific indices for the output. 


Index 
Which index to use when retrieving the data from the 
input Value field. Any index can be connected, resulting 
in a “shuffling” of the values. 


Properties 


Data Type 
The data type to use for the retrieved values. 


Domain 
The attribute domain that the attribute is transferred 
from, or in other words, the domain used to evaluate the 
Attribute input. For example, it is possible to transfer 
data from the faces of one geometry to the points of 
another. 


Clamp 
Clamp the indices to the size of the attribute domain 
instead of outputting a default value for invalid indices. 


Outputs 


Value 
The data retrieved from the source Geometry input. 


Examples 


v Set Position 
Geometry 


Geometry 
© Selecti 

Yv Sample Index scape 
Position 


Offset: 


Vv Object Info Value 


Geometry vere 
ector v 


Original Relative 


Point v 


Clamp 
VY Position 
Geometry 
Position 
Value 


Index 


Here the node is used to copy the positions of one 
object to another. This recreates the behavior of the 
Transfer Attribute node from Blender versions before 
3.4. This works best when their geometries have the 

Same number of points and the same Topology. 


Sample Nearest Node 


v Sample Nearest 


Index 


Point 


Geometry 


Sample Position 


The Sample Nearest node retrieves the index of the 
geometry element in its input geometry that is closest to 
the input position. This node is similar to the Geometry 
Proximity Node, but it outputs the index of the closest 
element instead of its distance from the current location. 


Inputs 


Geometry 
The geometry to sample. 


Note 
This node only supports point cloud and mesh inputs. 


Sample Position 
The position to start from when finding the closest 
location on the target geometry. By default, this is the 
same as if the Position Node was connected. 


Properties 


Domain 
The attribute domain to consider the distance from. 


Outputs 


Index 
The index of the closest geometry element of the chosen 


domain. 


Examples 


v Sample Index 


Value @-———_ 


Float v 
Point v 
¥ Clamp 
Geometry 
© Value 
Index 
vy Sample Nearest 
Index 
Point v 
Geometry 


Sample Position 


Combining this node with the Sample Index Node 
gives a setup that can retrieve the closest attribute 
value from another geometry. This is the same 
behavior as the Transfer Attribute node in versions 
of Blender before 3.4. 


Separate Components 
Node 


Y Separate Component 
Mesh 
Point Cloud 
Curve 
Volume 


Instances 


Geometry 


The Separate Components node splits a geometry into a 
separate output for each type of data in the geometry. 


Inputs 


Geometry 
Standard geometry input. 


Properties 
This node has no properties. 


Outputs 


Mesh 
Mesh component of the input geometry. 


Point Cloud 
Point cloud component of the input geometry. 


Curve 
Curve component of the input geometry. 


Volume 
Volume component of the input geometry. 


Instances 
Instances component of the input geometry. Even if the 
instances contain geometry data with one of the other 
types, all instances will be added to this output. A Realize 
Instances Node can be added to move the data from 
geometry instances to their corresponding outputs. 


Separate Geometry Node 


The Separate Geometry node 


Y Separate Geometry 
produces two geometry outputs. 
Based on the Selection input, the input Sethu. 
geometry is split between the two inverted 
outputs. 


Point v 


Geometry 
Tip © Selection 


This node can be combined with the 
Compare Node for a more precise 


control of which parts are separated to a given output 
geometry. 


Inputs 


Geometry 
Standard Geometry input. 


Selection 


Boolean field used to calculate which output each part of 
the geometry will go to. Parts in the selection will move 
to the Selection output. Parts not in the selection will 
move to the /nverted output. 


Properties 


Domain 
The domain on which the selection field is evaluated. 


Point: The selection is on the points, control 
points, and vertices of the geometry. 

Edge: The selection is on the edges of the 
mesh component. The other 
components are not modified. 

Faces: The selection is on the faces of the 
mesh component. The other 
components are not modified. 

Spline: The selection is on the splines in the 
curve component. For each spline, it is 
either entirely in the selection or not at 
all. The other components are not 
modified. 


Note 


When selecting a domain that doesn’t modify all 
components, the unmodified components will appear in 
both outputs. 


Outputs 


Selection 
The parts of the geometry in the selection. 


Inverted 
The parts of the geometry not in the selection. 


Transform Node 


The Transform Node allows you to 
move, rotate or scale the geometry. 
The transformation is applied to the Sete dy 
entire geometry, and not per element. Geometry 

The Set Position Node is used for Translation: 
moving individual points of a 
geometry. For transforming instances 
individually, the instance translate, 
rotate, or scale nodes can be used. 


Y Transform 


Inputs 


Geometry 
Standard geometry input. 


Translation 
Translation of the entire geometry in the local space of 
the modified object. 


Rotation 
Euler rotation in the local space of the modified object. 


Scale 


Scale for the geometry in the local space of the modified 
object. 


Properties 


This node has no properties. 


Output 


Geometry 
Standard geometry output. 


Set ID Node 


The Set ID node fills the id attribute on 
the input geometry. If the attribute 


does not exist yet, it will be created Geometry 
with a default value of zero. The ID is Geometry 

also created by the Distribute Points © Selection 

on Faces, and it is used in the Random ID 


Value Node and other nodes if it 
exists. 


The input node for this data is the |D Node. 


Inputs 


Geometry 
Standard geometry input. 


Selection 
Whether or not to change the value on each point or 
instance. True values mean the value will be changed, 
false values mean the value will remain the same. 


ID 
The value for each element. By default, this input uses 
the index, which is useful when stable IDs are desired 
when deleting a dynamic number of instances. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Set Position Node 


The Set Position node controls the 
location of each point, the same way 
as controlling the position attribute. If Botley 
the input geometry contains Geometry 
instances, this node will affect the © Selection 
location of the origin of each instance. Position 


Y Set Position 


Offset: 


The input node for this data is the 
Position Node. 


Inputs 


Geometry 
Standard geometry input. 


Selection 
Whether or not to change the position of each point or 
instance. True values mean the position will be changed, 
false values mean it will remain the same. 


Position 
The new position for selected elements. By default, this 
is the same as if the Position Node was connected, 
meaning the node will do nothing. 


Offset 
An optional translation for each point. This is evaluated 
at the same time as the Position input, meaning that 


fields evaluated for it will not reflect the changed 
position. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Input Nodes 


Nodes used mainly as input to other nodes. 


Boolean Node 
Collection Info Node 
Color Node 
Integer Node 

Is Viewport Node 
Material Node 
Object Info Node 
Scene Time Node 
Self Object Node 
String_Node 
Value Node 
Vector Node 


Index Node 

Named Attribute Node 
Normal Node 

Position Node 

Radius Node 

ID Node 


Boolean Node 


The Boolean node provides a Boolean 
value. 


Y Boolean 


Boolean @ 


Inputs 


This node has no input sockets. 


Properties 


Single Boolean value (true/false). 


Outputs 


Boolean 
Standard Boolean output. 


Collection Info Node 


The Collection Info node gets 
information from collections. This can 
be useful to control parameters in the tet 
geometry node tree with an external 
collection. 


Y Collection Info 


Original _ Relative 


e 
© Separate Children 
& 


Tip 


Reset Children 


A Collection Info node can be added 


quickly by dragging a collection into 
the node editor. 


Inputs 


Collection 
Collection to get the properties from. 


Separate Children 
Output each child of the collection as a separate 
instance. The list of instances will be sorted 
alphabetically with the objects and child collections 
sorted together. This can be used with the Pick Instance 
option in the Instance on Points Node to choose between 
collection children at each point. 


Reset Children 
Remove the transform of each of the collection’s children 
when converting them to instances. This is useful in 
order to keep child objects visually separate in the 


viewport, while keeping every instance located directly at 
the location of the point it was added for. 


Properties 


Transform Space 
The transformation of the geometry outputs. 


Original: Output the geometry relative to the 
collection offset. 
Relative: Join the input collection geometry with 


the modified object, maintaining the 
relative position between the objects in 
the scene. 


Outputs 


Geometry 
Geometry of the collection in world space with all its 
modifiers applied. 


Color Node 


The Color node outputs the color value 
chosen with the color picker widget. 


Y Color 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Color 
Color value indicated by the color picker widget. 


Integer Node 


The Integer node provides an integer 
value. 


Y Integer 


Integer 


Inputs 


This node has no input sockets. 


Properties 


Single integer value. 


Outputs 


Integer 
Standard integer output 


Is Viewport Node 


The Is Viewport node outputs true 

when geometry nodes are evaluated 
for the viewport. For the final render Foals Gy 
the node outputs false. 


Y Is Viewport 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Is Viewport 
Boolean value that indicates whether geometry nodes 
are evaluated for preview. 


Material Node 


The Material input node 
outputs a single material. It ” Material 
can be connected to other 
material sockets to make Material 
using the same material 
name in multiple places &) 
more convenient. 


Inputs 


This node has no inputs. 


Properties 


e Material 


Output 


Material 
A reference to the selected material. 


Object Info Node 


The Object Info node gets information 
from objects. This can be useful to 
control parameters in the geometry 
node tree with an external object, i tebindtad 
either directly by using its geometry, Scale 
or via its transformation properties. Geometry 


Y Object Info 


Location 


Original _ Relative 


An Object Info node can be added 
quickly by dragging an object into the 
node editor. @ As Instance 


Inputs 


Object 
Object to get the properties from. 


As Instance 
Output the entire object as single instance instead of 
realized geometry. This allows instancing non-geometry 
object types, because the output will contain an instance 
of the object. 


Properties 


Transform Space 
The transformation of the vector and geometry outputs. 


Original: Output the geometry relative to the 
input object transform, and the 
location, rotation and scale relative to 
the world origin. 

Relative: Bring the input object geometry, 
location, rotation and scale into the 
modified object, maintaining the 
relative position between the two 
objects in the scene. 


Outputs 


Location 
Location of the object in world space. 


Rotation 
Rotation of the object in world space. 


Scale 
Scale of the object in world space. 


Geometry 
Geometry of the object in world space with all its 
modifiers applied. 


Scene Time Node 


The Scene Time node outputs the 
current time in the scene’s animation 
in units of seconds or frames. 


Y Scene Time 


Seconds @ 


Frame @ 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Seconds 
Current scene time in seconds. 


Frames 
Current scene frame. As an input in geometry nodes, this 
output may also output non-round numbers, in order to 
Support higher quality motion blur. 


Self Object Node 


The Self Object node outputs 
the object that contains the vy Self Object 
geometry nodes modifier 
currently being executed. This 
can be used to retrieve the 
Original transforms. 


Self Object 


Note 


The geometry cannot be retrieved from this object with the 
Object Info Node, since its final geometry is still being 
evaluated. 


Inputs 

This node has no inputs. 
Properties 

This node has no properties. 


Outputs 


Self Object 
The object currently being evaluated. 


String Node 


The String input node creates a single 
string. It can be connected to attribute 
name sockets to make using the same ae 
attribute name in multiple places more 
convenient. 


Y String 


Inputs 


This node has no inputs. 
Properties 
e String 


Output 


String 
Standard string output. 


Value Node 


The Value Node is a simple node to input 
numerical values to other nodes in the 
tree. Value @ 


vy Value 


0.500 


Inputs 


This node has no input sockets. 


Properties 


Single numerical value (floating-point). 


Outputs 


Value 
The value set in the node properties. 


Example 


In the following example the Va/ue Node is used to control 
multiple values at once, this makes the node a useful 
organizational tool. 


¥ Use Alpha 


image 


e Alpha 1.000 


e vA 1.000 


Example of the Value node. 
Tip 
From this you can also make different values proportional 


to each other by adding a Math Node in between the 
different links. 


Vector Node 


The Vector input node creates a single 
vector. 


Inputs 


This node has no inputs. 


Properties 


eee 
N ~< xX 


Output 


Vector 
Standard vector output. 


Y Vector 


Vector 


0.000 
0.000 
0.000 


Index Node 


The Index node gives an integer value 
indicating the position of each element 
in the list, starting at zero. This 
depends on the internal order of the 
data in the geometry, which is not 
necessarily visible in the 3D Viewport. However, the index 
value is visible in the left-most column in the Spreadsheet 
Editor. 


Note 


Indices in geometry data are often defined by the internals 
of complex algorithms that create it. If no inputs change, 
indices will be the same when the same node tree is 
executed multiple times. However, they may not be 
predictable when inputs to nodes that generate geometry 
or change its topology are adjusted. Additionally, updates 
to algorithms in newer versions of Blender may change the 
order of generated elements. 


To avoid relying on consistent indices, it is recommended 
to calculate them locally, or to avoid operations that 
change topology when they must be consistent over time. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Index 
Integer value which enumerates each point on the 
geometry. 


Named Attribute Node 


The Named Attribute node 

outputs the data of an attribute 
based on the context of where it Attribute @ 
is connected (the Field Context). 


vy Named Attribute 


Inputs 


This node has no inputs. 


Properties 


Data Type 
The data type used for the retrieved data. Attribute 
Search can be used to give a basic list of possible 
attribute names and data types. When a value is chosen 
from the search menu, the data type is set to 
automatically choose the data type from the geometry 
nodes result. 


Outputs 


Attribute 
The attribute data stored on the geometry. 


Normal Node 


The Normal node returns a vector for 
each evaluated point indicating the 
normal direction. The output can bce 
depend on the attribute domain used 
in the node evaluating the field, but 
the output is always a normalized unit vector. 


Y Normal 


Face: On the face domain, the normal is the 
“up” direction of the face. 

Mesh Vertices: For mesh vertices, the normal is an 
average of the surrounding face normals. 
If the vertex does not have any connected 
faces, the output is simply the normalized 
position of that vertex. 

Edge: The normal output for each edge is the 
average of the edge’s two vertex normals. 

Face Corner: The output for each face corner is the 
same as the face normal of the 
corresponding face. 

Curve Control Points: 
The output of this node when used for 
curve geometry is the evaluated normal of 
the curve, which depends on the twist 
method. The normal vector is always 
perpendicular to the direction of the 
curve’s path at every point. 


Warning 


For NURBS and Bézier spline curves, keep in mind that the 
value retrieved from this node is the value at every control 
point, which may not correspond to the visible evaluated 


points. For NURBS splines the difference may be even 
more pronounced and the result may not be as expected. 
A Resample Curve Node can be used to create a poly 
spline, where there is a control point for every evaluated 


point. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Normal 
Vector indicating the normal of each geometry element. 


Position Node 


The Position node outputs a vector of 
each point of the geometry the node is 
connected to. 


Y Position 


Position 


The node can work on geometry 

domains besides points. In that case, 

the position data will be automatically interpolated to the 
new domain. For example, when used as part of the input to 
the Split Edges Node, the position for each edge will be the 
average position of the edge’s two vertices. 


For instances themselves, the output is the origin of each 
instance. However, if the node is for a geometry node that 
adjusts data inside instances, the position output of this 
node will be in the local space of each instance. See the 
Instance Processing page for more details. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Position 


Vector that indicates the location of each element of the 
geometry. 


Radius Node 


The Radius node outputs the radius 
value at each point on the evaluated 
geometry. For curves, this value is — 
used for things like determining the 
size of the mesh created in the Curve 
to Mesh node. For point clouds, the value is used for the 
display size of the point in the viewport. 


Y Radius 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Radius 
Float value indicating radius at each point on the 
geometry. 


ID Node 


The ID node gives an integer value 
indicating the stable random identifier 
of each element on the point domain, 
which is stored in the id attribute. 


The node to set this data is the Set |D 
Node node. 


Note 


Unlike other built-in attributes, the id attribute does not 
always exist. In that case, this node will output the index. 


Inputs 
This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


ID 
Integer value. 


Instances Nodes 


Nodes that only operate on instances. 


Instance on Points Node 
Instances to Points Node 
Rotate Instances Node 
Scale Instances Node 
Translate Instances Node 
Realize Instances Node 


Instance Rotation Node 
Instance Scale Node 


Instance on Points Node 


Y Instance on Points 
Instances 
Points 
© Selection 


Instance 


> Pick Instance 


Instance Index 


Rotation: 


The Instance on Points node adds a reference to a geometry 
to each of the points present in the input geometry. 
Instances are a fast way to add the same geometry to a 
scene many times without duplicating the underlying data. 
The node works on any geometry type with a Point domain, 
including meshes, point clouds, and curve control points. 


Any attributes on the points from the Geometry input will be 


available on the instance domain of the generated 
instances. 


Tip 


The Make Instances Real operator can be used to create 
objects from instances generated with this node. 


Note 


To instance object types that do not contain geometry, like 
a light object, the Object Info Node can be used. Other 
objects like Metaball objects are not supported for 
instancing. 


Inputs 


Geometry 
Standard geometry input. The position of the points of 
this geometry affect the transforms of each instance 
output. 


Note 


If the input geometry contains instances, the node will 
create more instances on the points inside the 
instances, creating nested instancing. In this case, each 
new instance will have the transform created by the 
node from the Rotation and Scale inputs, but it will a/so 
be transformed based on the parent instances. 


Selection 
Whether to instance on each point. True values mean the 
an instance will be generated on the point, false values 
mean the point will be skipped. 


Instance 


The geometry to instance on each selected point. This 
can contain real geometry, or multiple instances, which 
can be useful when combined with the Pick Instance 
option. 


Pick Instances 
If enabled, instead of adding the entire geometry from 
the Instance input on every point, choose an instance 
from the instance list of the geometry based on the 
Instance Index input. This option is intended to be used 
with the Collection Info Node. 


Instance Index 
The selection of index for every selected point, only used 
when Pick Instances is true. By default the point !D is 
used, or the index if that doesn’t exist. Negative values 
or values that are too large are wrapped around to the 
other end of the instance list. 


Rotation 
The Euler rotation for every instance. This can use the 
rotation output of nodes like Distribute Points on Faces 
and Curve to Points. An Euler rotation can also be created 
from a direction vector like the normal with the Align 
Euler to Vector Node. 


Scale 
The size of each generated instance. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. If the id attribute exists on 
the input geometry, it will be copied to the result 
instances. 


Instances to Points Node 


The Instances to Points node ene 
generates points at the origins of top- 
level instances. Attributes on the 

instance domain are moved to the instances 
point cloud points. 


Points 


© Selection 


Position 


Note © Radius 0.05m 


Top-level instances are those that are 
owned by the node’s input geometry. 
Instances owned by other instances, i.e. nested instances, 


are not considered by this node. 


Inputs 


Instances 
Standard geometry input. 


Selection 
The instances used to generate points. True values mean 


a point is created for the instance, false values mean the 
instance is skipped. 


Position 
Overrides the default position of generated point. 


Radius 
Controls the radius of the result points. 


Properties 


This node has no properties. 


Outputs 


Points 
Standard geometry output. 


Rotate Instances Node 


The Rotate Instances node rotates 
geometry instances in local or global 
space. 


Y Rotate Instances 
Instances 


Instances 
The Instances page contains more © Selection 
information about geometry instances. Rotation: 


© ¥ Local Space 


Inputs 


Geometry 
Standard geometry input. 


Selection 
Boolean field used to determine if an instance will be 


rotated. 


Rotation 
The Euler rotation to rotate the instances by. 


Pivot Point 
The position around which each instance is rotated. If the 
Local Space input is true, the location is relative to the 


initial transform of the instance. 


Local Space 
If enabled, the instances are rotated in local space. In 
other words, they are rotated around the axes described 
by the initial transform of each instance. When the input 
is disabled, the pivot point and rotation are specified in 
the local space of the modifier object. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Scale Instances Node 


The Scale Instances node scales 
geometry instances in local or global 
space. 


Y Scale Instances 
Instances 


Instances 
The Instances page contains more © Selection 
information about geometry instances. Scale: 


Om 
Om 


Om 


© ¥ Local Space 


Inputs 


Geometry 
Standard geometry input. 


Selection 
Boolean field used to determine if an instance will be 


scaled. 


Scale 
The scale factor to apply to the instance’s transform on 


each axis. 


Center 


The position from which the instance origins are scaled. 
Each instance will move away from this location. When 
the Local Space input is enabled, this location is relative 
to the initial transform of each instance. 


Local Space 
If enabled, the instances are scaled in local space. In 
other words, they are scaled in the directions the 
described by the initial transform of each instance. When 
the input is disabled, the Center and Scale inputs are 
specified in the local space of the modifier object. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Translate Instances Node 


The Translate Instances node moves 
top-level geometry instances in local 


Y Translate Instances 


or global space. Instances 
Instances 

The Instances page contains more 6 seus 

information about geometry instances. Teansiations 


Om 
Om 


Om 


© ¥ Local Space 


Inputs 


Geometry 
Standard geometry input. 


Selection 
Boolean field used to determine if an instance will be 
translated. 


Translation 
The vector to translate the instances by. 


Local Space 
If enabled, the instances are translated relative to their 
initial rotation. Otherwise they are translated in the local 
space of the modifier object. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Realize Instances Node 


The Realize Instances node makes any 
instances (efficient duplicates of the 
same geometry) into real geometry Sates 
data. This makes it possible to affect Geometry 

each instance individually, whereas 
without this node, the exact same 
changes are applied to every instance 
of the same geometry. However, performance can become 
much worse when the input contains many instances of 
complex geometry, which is a fundamental limitation when 
procedurally processing geometry. 


Y Realize Instances 


Note 


If the input contains multiple volume instances, only the 
first volume component is moved to the output. 


Attributes 


When merging attributes from multiple geometry inputs, the 
highest complexity data type is chosen for the output 
attribute. In other words, if a weight attribute has a Boolean 
type on one geometry input and a vector data type on 
another geometry, the weight attribute on the output 
geometry will have a vector data type. 


Named and anonymous attributes are propagated from the 
instance domain to the realized geometry. If the same 
attribute exists on the geometry and on an instance, the 


attribute values from the geometry has precedence over the 
values on the instances. 


In order to avoid creating duplicate values, the id attribute 
has special handling. The id values or indices of each 
instance are combined with id values from the points on 
geometry data. 


Warning 


Like other geometry nodes, this node always outputs 
generic typed attributes. So instead of a Vertex Group 
attribute, it will create a “Float” attribute on the result, and 
it will create a generic 2D vector attribute instead of a 
special “UV Map” attribute. Some other areas of Blender 
don’t properly handle generic attributes in version 3.0. 


Custom face corner normals are also not transferred 
Currently. 


Inputs 


Geometry 
Standard geometry input. 


Properties 


This node has no properties. 


Outputs 


Geometry 


Standard geometry output. 


Instance Rotation Node 


The Instance Rotation outputs the 

XYZ Euler rotation of each top-level 
instance in the local space of the Rotation 
modifier object. 


v Instance Rotation 


The Instances page contains more 
information about geometry instances. 


Note 

Though rotations are often displayed in units of degrees in 
the spreadsheet or node editor, they are stored internally 
in radians, so this node outputs radians. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Rotation 
Vector that indicates the rotation of each top-level 
instance in radians. 


Instance Scale Node 


The Instance Scale outputs the size 
of top-level instances on each axis 
in the local space of the modifier Scale 
object. 


v Instance Scale 


The Instances page contains more 
information about geometry instances. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Scale 
Vector that indicates the scale of each top-level instance. 


Material Nodes 


Nodes that work with materials. 


e Replace Material Node 


e Material Index Node 
Material Selection Node 


Set Material Node 
Set Material Index Node 


Replace Material Node 


The Replace Material node 
Swaps one material with ~ Replace Material 
another. Replacing a 
material with this node is Geometry 
more efficient than creating | 
a selection of all faces with Geometry 

the old material with the Old: &@ 
Material Selection Node and aenae 
then using the Set Material New: 
Node. 


Note 


Currently this node only adjusts mesh data. 


Inputs 


Geometry 
Standard geometry input. 


Old 
Material that is going to be replaced. 


New 
Material that is replacing the old material. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Material Index Node 


The Material Index node outputs which 
material in the list of materials of the 
geometry each element corresponds bell al 
to. Currently the node supports mesh 
data, where material index is a built-in 
attribute on faces. 


Y Material Index 


The node to set this data is the Set Material Index node. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Material Index 
Standard integer value, with a minimum value of zero. 


Material Selection Node 


The Material Selection node 
provides a selection for meshes 
that use this material. Since the Selection @ 
material index is stored on each © 

face, the output will be implicitly 
interpolated to a different domain 
when necessary. For example, 
every vertex connected to a selected face will be selected. 


vy Material Selection 


Inputs 


Material 
Standard material input. 


Properties 


This node has no properties. 


Outputs 


Selection 
Selection of faces that use the input material. 


Set Material Node 


The Set Material changes the material 
assignment in the specified selection, 


Y Set Material 


by adjusting the material index Setltty 
attribute. If the material is already Geometry 

used on the geometry, the existing © Selection 
material index will be reused. © 


Note 


This node adjusts mesh, point clouds, and volume data; 
other data types do not support materials. 


Inputs 


Geometry 
Standard geometry input containing a mesh. 


Material 
The material to apply to the geometry. 


Selection 


Whether to change the material of each face. True values 
mean the material will be changed, false values mean it 
will remain the same. 


Note, volumes and point clouds only support a single 
material, in these cases a field input will be ignored. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Set Material Index Node 


The Set Material Index node sets the 
material index for a geometry. 


Y Set Material Index 


Geometry 


The node to get this data is the Geometry 
Material Index node. © Selection 


Material Index 0 


Inputs 


Geometry 
Standard geometry input. 


Selection 
Whether to change the material index for each face. True 


values mean the material index will be changed, false 
values mean it will remain the same. 


Material Index 
The new material index. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Mesh Nodes 


Nodes that only operate on meshes. 


Dual Mesh Node 

Edge Paths to Curves Node 
Edge Paths to Selection Node 
Extrude Mesh Node 

Flip Faces Node 

Mesh Boolean Node 

Mesh to Curve Node 

Mesh to Points Node 

Mesh to Volume Node 
Sample Nearest Surface Node 
Sample UV Surface Node 
Scale Elements Node 

Split Edges Node 

Subdivide Mesh Node 
Subdivision Surface Node 
Triangulate Node 


Edge Angle Node 

Edge Neighbors Node 
Edge Vertices Node 

Face Area Node 

Face Neighbors Node 
Face Set Boundaries Node 
Is Face Planar Node 

Is Shade Smooth Node 
Mesh Island Node 
Shortest Edge Paths Node 
Vertex Neighbors Node 


e Set Shade Smooth Node 


Dual Mesh Node 


The Dual Mesh Node converts a mesh 
into it’s dual, i.e. faces are turned into 
vertices and vertices are turned into 
faces. This also means that attributes Mesh 

which were on the face domain are @ Keep Boundaries 
transferred to the point domain in the 
dual mesh. 


Y Dual Mesh 


Dual Mesh 


Warning 


The Dual Mesh node only works on manifold geometry. To 
work with non-manifold geometry it’s best to remesh the 
geometry first. 


Inputs 


Mesh 
Standard geometry input. 


Keep Boundaries 
Keeps the non-manifold boundaries of the input mesh in 


place, by creating extra geometry, and avoiding the dual 
mesh transformation there. 


Properties 


This node has no properties. 


Output 


Dual Mesh 
Standard geometry output. 


Examples 


The Dual Mesh Node combines nicely with triangulated 
meshes. In this case an Ico Sphere is used, which is made 
up of nice and evenly spaced triangles. 


© Map Range ~ Multiply 


Edge Paths to Curves 
Node 


The Edge Paths to Curves node 
output curves that follow paths 


v Edge Paths to Curves 


across mesh edges. Curves 
Mesh 
See also > Start Vertices 
: . Next Vertex Ind 
This node is meant to use the output nape te rtrst thal 


of the Shortest Edge Paths Node. It 
is similar to the Edge Paths to 
Selection Node, but it creates a curve that follow each 
path, rather than a selection of every visited edge. 


Inputs 


Mesh 
Standard mesh input. 


Start Vertices 


A selection of the vertices to start at when traveling 
along the next vertex indices. 


Next Vertex Index 
Describes the path to follow at every vertex. 


Properties 


This node has no properties. 


Outputs 


Mesh 
Standard curves output. 


Edge Paths to Selection 
Node 


The Edge Paths to Selection node ERAGE PATS IG SEIN 
follows paths across mesh edges 
and outputs a selection of every 
visited edge. © Start Vertices 
Next Vertex Index 


Selection @ 


See also 


This node is meant to use the 

output of the Shortest Edge Paths Node. It can be 
combined with the Separate Geometry Node to remove 
any unused edges. 


Inputs 


Start Vertices 
A selection of the vertices to start at when traveling 
along the next vertex indices. 


Next Vertex Index 
Describes the path to follow at every vertex. 


Properties 


This node has no properties. 


Outputs 


Selection 
A boolean field indicating all edges visited when 
traversing the mesh. 


Extrude Mesh Node 


The Extrude Mesh Node generates 
new vertices, edges, or faces, on 
selected geometry and transforms 
them based on an offset. 


Y Extrude Mesh 


The operations are similar to the 
extrude tools in mesh edit mode, 
though there are some differences. 
Most importantly, the node never py? Sach 

keeps the back-faces of the extrusion Soe 

in place, they are always removed. ° Geos 
Attribute propagation rules may also @ © Individual 

be different. 


Faces 


Mesh 


Inputs 


Mesh 
Standard geometry input. 


Selection 
Whether to extrude each element. True values mean 
elements will be extruded, false values mean elements 
will remain unchanged. 


Offset 


The amount to translate the new geometry on each axis. 
The default value of the “Offset” input is the mesh’s 
normals. To change the distance, the Scale input can be 
used. However, when an input is computed for this 
directly, the length of the input vectors is used. 


Tip 


Because the default input is the mesh’s normals, they 
may need to be calculated just for this node. If the 
extrusion is only in one direction anyway, a potential 
performance improvement is to connect a Vector Node 


instead. 


Scale 


The factor used to scale elements or groups of elements. 


Individual Face Mode Only 
Whether to extrude each face individually rather than 
extruding connected groups of faces together as regions. 
A quad side face will be generated on each side of every 


selected face. 


Properties 


Mode 
Vertices: 


Edges: 


This mode is quite simple, it just 
attaches new edges and vertices to the 
selected vertices. 


Attach new quad faces to the selected 
edges. Vertices shared by the original 
selected vertices are also shared in the 
duplicated edges. 


Note 

Depending on the situation, the 
normals of the new faces may be 
arbitrary. If the selected edges only 
have one selected face, then the node 
can pick a consistent orientation for 


Faces: 


Output 


Mesh 


the new faces, but if there is more 
than one connected face, or no 
connected faces, the normals may 
have to be adjusted afterwards. 


Extrudes contiguous regions of 

selected faces, or each selected face 
individually, depending on the 
Individual boolean input. 

When the /ndividual input is false, the 
node will find regions of connected 
faces and generate new “side” faces on 
the boundaries of those regions. If the 
whole mesh is selected and it is already 
a Manifold shape, then result will just 
be that the whole mesh moves. Any 
vertices, edges or faces on the inside of 
the face regions are just moved, they 
are not duplicated. 


Standard geometry output. 


Top 


A boolean field output containing the top new top 
geometry. The domain depends on the selected mode. In 
Vertex mode, this is a selection of the new vertices. In 
Edge mode, this is a selection of the duplicated edges 
and in Face mode, it is a selection of the new faces. 


Side 


A boolean field output containing the “side” of the new 
geometry. In Vertex mode, it selects the new edges, in 


Edge mode, the new faces, and in Face mode, the new 
side faces are selected, which are all of the new faces 
that aren’t in the Top selection. 


Examples 


Here, the selection outputs are used to set materials on 
certain faces of the mesh. A Random Value Node node can 
be used to limit the extrusion to a random set of faces. 


Attribute Propagation 


Attributes are transferred to the new elements with specific 
rules. An attribute will never change domains on the 
resulting mesh. The id attribute does not have any special 
handling. 


Generally boolean attributes are propagated with “or”, 
meaning any connected “true” value that is mixed in for 
other types will cause the new value to be “true” as well. 


The following sections describe: 


Vertex Mode 


The new edges created in vertex mode use the 
average value of all connected edges. 


e New vertices have copied values from their original 
vertices 

e New edges have the average value of any connected 
Original edges. For boolean attributes, edges are 
selected if any connected edges were selected. 


Edge Mode 


Attribute propagation for new connecting edges (the 
vertical yellow edge). The final value is a mix of the 
values from the two middle blue edges. The darker 

maroon edges lower on the image are not used. 


New vertices have copied values from their original 
vertices. 

Vertical connecting edges get the average value from 
any connected extruded edges. For booleans, the edges 
are selected if any connected extruded edges were 
selected. (Propagation rules are shown in the figure 
above.) 

Horizontal duplicate edges have copied values from 
their original edges. 

New faces get the average values of all faces 
connected to the selected edge. For booleans, faces are 
selected if any connected original faces were selected. 


e New face corners get the averaged value of 
corresponding corners in all faces connected to selected 
edges. For booleans, corners are selected if one of those 


corners are selected. 


Face Mode 


Attribute propagation for new connecting edges (the 
vertical yellow edge). The final value is a mix of the 
values from the two middle blue edges. The values 
from the darker maroon edges between unselected 
faces and on top of the extruded region are not 
used. 


e New vertices have copied values from their original 
vertices. 

e Vertical connecting edges get the average value from 
any connected extruded edges, not including the edges 
“on top” of extruded regions. For booleans, the edges 


are selected if any of those connected edges were 

selected. (Propagation rules are shown in the figure 

above.) 

Horizontal duplicate edges have copied values from 

their original edges. 

e New faces have copied values from the corresponding 
extruded faces. 

e New face corners have copied values from the 
corresponding corresponding corners of extruded faces. 


Individual Face Mode 


Attribute propagation for new connecting edge. 
Each edge uses the average values of the two 
neighboring edges on its extruded face. 


e New vertices have copied values from their original 
vertices. 


Vertical connecting edges get the average value of the 
two neighboring edges on each extruded face. For 
booleans, the edges are selected when at least one 
neighbor on the extruded face was selected. 

Horizontal duplicate edges have copied values from 
their original edges. 

New side faces have copied values from their 
corresponding selected face. 

New face corners have copied values from the 
corresponding corners of selected faces. 


Flip Faces Node 


The Flip Faces Node reverses the order 
of the vertices and edges of each 
selected face. The most common use 
of this node is to flip the normals of a Mesh 
face. Any face corner domain © Selection 
attributes of selected faces are also 
reversed. 


Y Flip Faces 


Though this node is usually used to affect normals, it is not 
called “Flip Normals” for an important reason. The node 
does not actually interact with normals directly. Normals are 
defined by the right hande rule, so if a face’s vertex list is 
reversed, then its normal will point in the opposite direction. 


Inputs 


Mesh 
Standard geometry input. 


Selection 
Whether to flip the direction of each face. True values 
mean the face will be flipped, false means the face will 
be unaffected. 


Properties 


This node has no properties. 


Output 


Mesh 
Standard geometry output. 


Mesh Boolean Node 


The Mesh Boolean Node allows you to 

cut, subtract, and join the geometry of 
two inputs. This node offers the same ht 
operations as the Boolean modifier. Difference ¥ 


‘YY Mesh Boolean 


Mesh 1 
Mesh 2 


& Self Intersection 


@ Hole Tolerant 


Inputs 


Mesh 1/2 
Standard geometry input. 


Self Intersection 
Correctly calculates cases when one or both operands 
have self-intersections. This involves more calculations 
making the node slower. 


Hole Tolerant 
Optimizes the Boolean output for Non-manifold geometry 
at the cost of increased computational time. Because of 
the performance impact, this option should only be 
enabled when the solver demonstrates errors with non- 
manifold geometry. 


Properties 


Operation 
Intersect: Produce a new geometry containing 
only the volume inside of both 
geometry 1 and geometry 2. 


Union: The two input meshes are joined, then 
any interior elements are removed. 
Difference: Geometry 2 is subtracted from 


geometry 1 (everything outside of 
geometry 2 is kept). 


Output 


Mesh 
Standard geometry output. 


Intersecting Edges 
A boolean attribute field with a selection of the edges 
that were created where the two inputs meet. 


Mesh to Curve Node 


The Mesh to Curve node generates a 
curve from a mesh. The result is a poly 
spline, with a point for every selected Soltis 
vertex on the mesh. Any intersection Mesh 

of more than two selected edges will © Selection 

cause a break in the spline. Meaning 
that if a the mesh has grid-like 
topology and a continuous spline is 
desired, the Selection input is very important. 


Y Mesh to Curve 


Attributes will be transferred to the resulting curve, 
including named attributes. If the mesh has attributes with 
the names of built-in curve attributes like radius and cyclic, 
they will be copied as well. 


Inputs 


Mesh 
Standard mesh input. 


Selection 


A field input evaluated on the edge domain to determine 
whether each edge will be included in the result. 


Tip 
Using this input is more efficient than deleting parts of 
the geometry before or after the conversion. 


Properties 
This node has no properties. 
Outputs 


Curve 
Generated curve. 


Mesh to Points Node 


The Mesh to Points node generates a 
point cloud from a mesh. 


Y Mesh to Points 
Points 
Vertices v 


Mesh 


© Selection 


Position 


> Radius 0.05m 


Inputs 


Mesh 
Standard Mesh input. 


Selection 
The meshes used to generate a point cloud. 


Position 
Positions of generated points. By default, this input is the 
same as if the Position Node was connected. 


Radius 
Radii of generated points. 


Properties 


Mode 
Vertices: Points are generated for each vertex. 


Edges: Points are generated for each edge, at 
the middle of each edge, by default. 

Faces: Points are generated for each face, at 
the average of all of each face’s 
vertices, by default. 

Corners: Points are generated for each corner. 
The points are all placed at the location 
of each corners vertex, so they will 
overlap by default. 


Outputs 


Points 
Generated point cloud. 


Mesh to Volume Node 


The Mesh to Volume node 
creates a fog volumes 
based on the shape of a Volume 
mesh. The volume is 
created with a grid of the 
name “density”. Mesh 


Mesh to Volume 


Resolution Amount 


Density 1.000 


Voxel Amount 64.000 
Exterior Band Width 0.1m 
Interior Band Width Om 


¥ Fill Volume 


Inputs 


Mesh 
Standard Mesh input. 


Density 
Value of voxels inside the generated fog volume. 


Voxel Amount 
Specify the approximate number of voxels along the 
diagonal. 


Voxel Size 
Specify the voxel side length. 


Exterior Band Width 


The maximum distance of the included voxels to the 
surface on the outside of the mesh. 


Interior Band Width 
The maximum distance of the included voxels to the 
surface on the inside of the mesh. Activating Fill Volume 
is Similar to increasing the interior band width to a high 
number. 


Fill Volume 
The entire enclosed volume or otherwise only the voxels 
close to the surface will get a density greater than zero. 
This setting is only used when the mesh object is 
Manifold. 


Properties 


Resolution 
How the voxel size is specified. 


Amount: Specify the approximate number of 
voxels along the diagonal. 
Size: Specify the voxel side length. It is 


recommended to be careful when 
tweaking this value, because small 
changes can have a large effect on the 
processing time. 


Outputs 


Volume 
The generated volume grid. 


Sample Nearest Surface 
Node 


vy Sample Nearest Surface 


Value @ 


Float 


Mesh 
© Value 


Sample Position 


The Sample Nearest Surface node finds values at the closest 
points on the surface of a source mesh geometry. Non-face 
attributes are interpolated across the surface. 


This node is similar to the Geometry Proximity Node, but it 
gives the value of any attribute at the closest surface point, 
not just its position. 


Warning 


Because the node samples the surface of a mesh rather 


than its edges or vertices, values from loose points and 
edges are ignored. 


Inputs 


Mesh 
The geometry to retrieve the attribute from. 


Value 
A field to evaluate on the Source geometry for use with 
the transfer method. 


Sample Position 
The position to start from when finding the closest 
location on the target mesh. By default, this is the same 
as if the Position Node was connected. 


Properties 


Data Type 
The data type to use for the retrieved values. 


Outputs 


Value 
The data retrieved and interpolated from the Source 
geometry, mapped based on the node’s settings and 
inputs. 


Sample UV Surface Node 


v Sample UV Surface 


Value © 
Is Valid © 


Float v 
Mesh 
© Value 


Source UV Map 


Sample UV: 
0.000 
0.000 
0.000 


The Sample UV Surface node finds values on a mesh’s 
surface at specific UV locations. Internally the process is a 
“reverse UV lookup” from a location in 2D space. The node 
then finds the face that corresponds to each UV coordinate, 
and the location within that face. 


Warning 


Because of the node’s method of computatation, the UV 
map should not have any overlapping faces. If the UV map 
is sampled at a location with no faces or overlapping faces, 
the node will output the default value for the data type, 
which is zeros for most types. 


Inputs 


Mesh 
A geometry containing the mesh with a UV map for 
Sampling. 


Value 
A field to evaluate on the target Mesh geometry for later 
Sampling at the surface positions. 


Source UV Map 
The mesh UV map to sample, evaluated on the Mesh 
input. Should not have overlapping faces. 


Sample UV 
The coordinates to sample within the UV map. 


Properties 


Data Type 
The data type to use for the retrieved values. 


Outputs 


Value 
The data retrieved and interpolated from the Mesh 
geometry, mapped based on the node’s settings and 
inputs. 


Is Valid 
Whether the node could find a single face to sample at 
the UV coordinate. 


Scale Elements Node 


The Scale Elements Node scales 
groups of connected edges and faces. 
When multiple selected faces/edges Sted 
Share the same vertices, they are Face e 
scaled together. The center and 
scaling factor is averaged in this case. 


Y Scale Elements 


Uniform v 


Geometry 


© Selection 
© Scale 1.000 


Center 


Inputs 


Mesh 
Standard geometry input. 


Selection 
Whether to scale each edge or face. True values mean 
the element will be scaled, false means it will be 
unaffected. 


Scale 
The factor used to scale elements or groups of elements. 


Center 
Origin of the scaling for each element. If multiple 
elements are connected, their center is averaged. 


Axis Single Axis Mode Only 


Axis in which to scale the element. This input is 
normalized internally, so the length does not matter. 


Properties 


Domain 
The element type to transform. 


Face: Scale individual faces or neighboring 
face islands. 

Edge: Scale individual edges or neighboring 
edge islands. 

Scale Mode 

Uniform: Scale elements by the same factor in 
every direction. 

Single Axis: Scale elements in a single direction 


defined by the Direction input. 


Output 


Mesh 
Standard geometry output. 


Examples 


The node is useful when combined with the Extrude Mesh 
Node, especially in Individual mode, where face islands 
don’t need to be scaled together. 


v Scale Elem 
Geome vy Group Output 


Geometry 


vy Group Input > an orm 


Geometry : Geometry 
tion 


Scale 0.500 


Faces 


Mesh 


Split Edges Node 


Like the Edge Split Modifier, the Split 
Edges node splits and duplicates 
edges within a mesh, breaking ‘links 
between faces around those split Mesh 
edges. © Selection 


Y Split Edges 


’ 


Inputs 


Mesh 
Standard geometry input. 


Selection 
A standard Boolean selection input to determine which 


edges will be split. 


Note 


Because of mesh topology requirements, sometimes more 
or fewer edges than are selected will be split. 


Properties 


This node has no properties. 


Outputs 


Mesh 


Standard geometry output. 


Subdivide Mesh Node 


The Subdivide Mesh node adds new 
faces to mesh geometry using a 
simple interpolation for deformation. 


Y Subdivide Mesh 


Mesh 


Inputs 


Mesh 
Standard geometry input. 


Level 
The number of subdivisions to apply to the input 
geometry. 


Properties 
This node has no properties. 


Outputs 


Mesh 
Standard geometry output. 


Subdivision Surface Node 


The Subdivision Surface node adds 
new faces to mesh geometry using a 
Catmull-Clark subdivision method. 


Y Subdivision Surface 


Mesh 


Keep Boundaries v 


All 
Mesh 
Level 


© Crease 


Inputs 


Mesh 
Standard geometry input. 


Level 
The number of subdivisions to apply to the input 
geometry. 


Edge Crease 
Controls how smooth edges should be with Weighted 
Edge Creases. 


Vertex Crease 
Controls how much the subdivision surface should be 
pulled towards the vertex. Similar to edge creases, but 
allows individual vertices to be creased. 


Properties 


UV Smooth 
Controls how subdivision smoothing is applied to UVs. 


None: UVs remain unchanged. 

Keep Corners: UV islands are smoothed, but their 
boundary remain unchanged. 

Keep Corners, Junctions: 
UVs are smoothed, corners on 
discontinuous boundary and junctions 
of three or more regions are kept 
sharp. 

Keep Corners, Junctions, Concave: 
UVs are smoothed, corners on 
discontinuous boundary, junctions of 
three or more regions and darts and 
concave corners are kept sharp. 

Keep Boundaries: 
UVs are smoothed, boundaries are kept 
Sharp. 

All: UVs and their boundaries are 
smoothed. 


Boundary Smooth 
Controls how open boundaries (and corners) are 
smoothed. 


All: Smooth boundaries, including corners. 
Keep Corners: Smooth boundaries, but corners are 
kept sharp. 
Outputs 
Mesh 


Standard geometry output. 


Triangulate Node 


The Triangulate node converts all 

faces in a mesh (quads and n-gons) to 
triangular faces. It functions the same oh 
as the Triangulate tool in Edit Mode. Shortest Diagonal v 


Y Triangulate 


Beauty v 
Mesh 
© Selection 


Minimum Verti 4 


Inputs 


Mesh 
Standard geometry input. 


Selection 
A standard Boolean selection input to determine which 
faces will be triangulated. 


Minimum Vertices 
Minimum number of vertices a face must have to be 
triangulated. For example, setting this value to 5, will 
prevent triangulation of Quads and only triangulate N- 
gons. 


Properties 


Quad Method 


Beauty: Split the quads in nice triangles, slower 
method. 

Fixed: Split the quads on their 1st and 3rd 
vertices. 

Fixed Alternate: 
Split the quads on their 2nd and 4th 
vertices. 

Shortest Diagonal: 
Split the quads along their shortest 
diagonal. 

Longest Diagonal: 
Split the quads along their longest 
diagonal. This is the preferred mode for 
cloth simulations. 


N-gon Method 


Beauty: Arrange the new triangles nicely, 
slower method. 
Clip: Split n-gons using an ear-clipping 


algorithm (gives similar results to the 
tessellation used for the viewport 
rendering). 


Outputs 


Mesh 
Standard geometry output. 


Example 


Mesh before Mesh after 
triangulation. triangulation. 


Edge Angle Node 


The Edge Angle node calculates the 
angle in radians between two faces 
that meet at an edge. For the Face, 
Face Corner, and Point domains, the 
node uses simple domain interpolation 
to move values from the mesh’s 
edges. 


Y Edge Angle 


Unsigned Angle @ 


Signed Angle 


Note 
The output of this node depends on the density of the 


mesh. If there are more edges closer together and the 
curvature of the mesh stays the same, the edge angle will 
be different 

Inputs 

This node has no inputs. 

Properties 

This node has no properties. 


Outputs 


Unsigned Angle 


The shortest angle in radians between two faces where 
they meet at an edge. The range of the data is from zero 
to Pl. Flat edges and Non-manifold edges have an angle 
of zero. An edge between two faces completely folded 
back on each other has an angle of PI, or 180 degrees. 


Tip 
Computing this value is slightly faster than the signed 
angle, so if there is no need to distinguish between 


convex and concave angles, using this value can 
provide a performance improvement. 


Signed Angle 


The signed angle in radians between two faces where 
they meet at an edge. Flat edges and Non-manifold 


edges have an angle of zero. Concave angles are positive 
and convex angles are negative. 


Edge Neighbors Node 


The Edge Neighbors node outputs 
topology information relating to each 
edge of a mesh. naan 


Y Edge Neighbors 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Face Count 
The number of faces that use the edge as one of their 
sides. When the value is one, the edge is a non-manifold 
boundary edge. Alternatively, when the value is zero, the 
edge is a loose edge, not used by any faces. 


Examples 


Using the Face Count output to create a curve ona 
mesh’s boundary edges. 


Edge Vertices Node 


The Edge Vertices node outputs the x TpSUERES 
position and index of the two vertices | 
of each of a mesh’s edges. 


Vertex Index 1 


Vertex Index 2 


Position 1 


Note 


Position 2 


The order of the two vertices of an 
edge is arbitrary. In some cases it 
may be predictable based on the 
internals of the algorithm that created the mesh, but in 
general the order should not be relied upon. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Vertex Index 1/2 
The index of the two vertices of the edge. 


Position 1/2 
The position of each of the edge’s vertices. This output is 
for convenience, it is the same as using index output to 


retrieve the position from the Field at Index Node. 


Face Area Node 


The Face Area node outputs the 

Y Face Area 
surface area of a mesh’s faces. The 
units are in Blender units no matter 
the unit system, equivalent to meters- 
squared at the default unit scale. 


Note 


For quads and N-gons, when the face’s vertices are not 
planar, the output is not necessarily the same as the sum 
of every one of the face’s triangles visible in the viewport. 
In this case it should only be used an approximation. In 
some cases, the Iriangulate Node can be used to get an 
exact value. 


Inputs 


This node has no inputs. 


Properties 
This node has no properties. 
Outputs 


Area 
The surface area of each of the mesh’s faces. 


Examples 


vy Group Input 


Geometry Y Group Output 


Geometry 


7? Sum 
VY Attribute Statistic J 


4 
A 


Sum @~ 


Float v 


Face v 


Vv Face Area Geometry 


———-@ Attribute 


Combined with the Attribute Statistic Node, this node can be 
used to calculate the total surface area of a mesh. 


Face Neighbors Node 


The Face Neighbors node outputs 
topology information relating to each 
face of a mesh. 


Y Face Neighbors 


Vertex Count 


Face Count 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Vertex Count 
This output is simply the number of sides of each face, or 
how many corners each face has. 


Neighboring Face Count 
The number of faces that connect to this face with at 
least one edge. On a regular manifold mesh with only 
quads and triangles, this will be the same as the vertex 
count, otherwise it might be completely different. 


Face Set Boundaries Node 


The Face Set Boundaries 


Node finds the edges Y Face Set Boundaries 
which lie on the 


boundaries of specified Boundary Edges @ 
regions. These edges 
could be used to mark 
seams for UV 
unwrapping, for example. 


Face Set 


Inputs 


Face Set 
Identifier for which group of faces this face belongs to. All 
contiguous faces with the same value are in the same 
region. 


Properties 


This node has no properties. 


Output 


Boundary Edges 
Selection of the boundary edges of the different face 
sets. An edge is considered to be at the boundary if it lies 
on at least two faces with different identifiers. 


Examples 


Combined with the UV Unwrap Node, this node is used to 
turn the face sets (right cube) into a UV map for a texture 
(left cube). 


Is Face Planar Node 


The Is Face Planar node 
outputs whether every v Face Is Planar 
triangle of a guads or N-gons 
is on the same plane as all 
of the others, in other words, © Threshold 0.01m 
if they have the same 
normal. 


Planar @ 


For example, a non-planar face can be created by moving a 
single vertex in a face but not the others. Triangles will 
always be planar. 


Inputs 


Threshold 
The distance a point can be from the surface before the 
face is no longer considered planar. 


Properties 


This node has no properties. 


Outputs 


Planar 
Whether each mesh face is planar. 


Examples 


° Threshold 0.01 m 


Combined with the Set Material Node, this node is used to 
visualize all non-planar faces in a mesh. 


Is Shade Smooth Node 


The Is Shade Smooth node outputs 
true for each face of the mesh if that 
face is marked to render smooth Sites Sy 
shaded. Otherwise, if the face is 
marked to render as flat shaded, so 
the node outputs false. 


Y Is Shade Smooth 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Smooth 
Boolean value that indicates whether the normals of each 
face corner on the final mesh are smoothed with normal 
of all adjacent faces or not. 


Mesh Island Node 


The Mesh Island node outputs 

information about separate connected 
regions, or “islands” of a mesh. peal cho 
Whenever two vertices are connected Stl Sls 
together by an edge, they are 

considered as part of the same island, 
and will have the same Island Index output. 


Y Mesh Island 


This node’s behavior is similar to the Select Linked operator 
in edit mode, or the Random per Island output of the 
Geometry shader node. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Island Index 
The index of the each vertex’s island. Indices are decided 
based on the lowest vertex index contained in each 
island 


Island Count 


The total number of mesh islands. This is a single value, 
and does not vary per element. 


Shortest Edge Paths Node 


The Shortest Edge Paths node finds STCHONGEE Edge Pathe 
paths along mesh edges to a selection 
of end vertices. The cost used to 
define “shortest” can be set to 
anything. By default there is a © End Vertex 
constant cost for every edge, but a © Edge Cost 
typical input would be the length of 
each edge. 


Next Vertex Index 


Total Cost @ 


The output is encoded with vertex indices, and is meant to 
be used on the vertex domain. For each vertex, the Next 
Vertex Input output stores the index of the following vertex 
in the path to the “closest” endpoint. 


The node is implemented with Dijkstra’s algorithm. 
Tip 


vy Edge Vertices v Distance 


Vertex Index 1 Value @ 
Vertex Index 2 
Distance v 


Position 1 
Vector 


Position 2 


Vector 


The edge length is a natural input to the Edge Cost. It can 
be implemented with the Edge Vertices Node and the 
Vector Math Node set to the Distance operation. 


See also 


This node can be used with the Edge Paths to Selection 
Node or the Edge Paths to Curves Node to generate new 
geometry based on the paths. 


Inputs 


End Vertex 
A selection of the goal vertices that terminate the edge 


paths. 


Edge Cost 
The weight for each edge, used to determine the 


meaning of “shortest.” 


Properties 


This node has no properties. 


Outputs 


Next Vertex Index 
The following vertex on the shortest path from every 
vertex to the closest endpoint (as defined by the cost 


input). 


Total Cost 
The remaining cost before an end vertex is reached by 


following the next vertex indices 


Vertex Neighbors Node 


The Vertex Neighbors node outputs 
topology information relating to each 
vertex of a mesh. sds el 


Face Count 


Y Vertex Neighbors 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Vertex Count 
The number of vertices connected to this vertex with an 
edge, equal to the number of connected edges. 


Face Count 
The number of faces that contain the vertex. 


Set Shade Smooth Node 


The Set Shade Smooth node controls 


Y Set Shade Smooth 
whether the mesh’s faces look smooth 


in the viewport and renders. The input Sealy 
node for this data is the Is Shade Geometry 
Smooth node. © Selection 


© Y Shade Smooth 


Inputs 


Mesh 
Standard geometry input. 


Shade Smooth 
When true, the selected faces will be marked to render 
smooth shaded. Otherwise the faces will be rendered flat 
shaded. 

Selection 


Boolean input for selecting which faces will have the 
Shade Smooth value applied. 


Properties 
This node has no properties. 


Outputs 


Mesh 


Standard geometry output. 


Mesh Primitive Nodes 


Nodes that create a primitive mesh, e.g. a cube. 


Cone Node 

Cube Node 
Cylinder Node 
Grid Node 
Icosphere Node 
Mesh Circle Node 
Mesh Line Node 
UV _ Sphere Node 


Cone Node 


The Cone node generates a cone 


mesh that is optionally truncated. 
Mesh 


Top @ 
Bottom @ 
Side 


FilType N-Gon v 


Vertices 32 


Side Segments 1 


FillSegments 1 
Radius Top Om 
Radius Bott 1m 
Depth 2m 


Inputs 


Vertices 
Number of points on the circle at the top and bottom. No 
geometry is generated if the number is below three. 


Side Segments 
Number of edges running vertically along the side of the 
cone. No geometry is generated if the number is below 
one. 


Fill Segments 
Number of concentric rings used to fill the round faces at 
the top and bottom. No geometry is generated if the 
number is below one. 


Radius Top 
The distance of the vertices in the top circle from the Z 
axis. If this is zero, the vertices in the circle are merged 


into one. 


Radius Bottom 
Same as Radius Top but for the bottom circle. 


Depth 
Height of the generated cone. 


Note 


If the top and bottom radii are zero, this node will output a 
single line. 


Properties 


Fill Type 
How the circles at the top and bottom are filled with 
faces when their radius is larger than zero. 


None: Do not fill the circles. 

N-Gon: Fill the innermost segment of the 
circles with a single face. 

Triangles: Fill the innermost segment of the 


circles with triangles connected to a 
new vertex on the Z axis. 


Outputs 


Mesh 
Standard geometry output. 


Top 
A boolean attribute field with a selection of the faces on 
the top of the cone. If the Fil/ Type property is set to 
none, then this will be a selection of the top edges 


instead. If Radius Top is zero, this will be a selection of 
the top vertex. 


Side 
A boolean attribute field with a selection of the faces on 
the side of the cone. 


Bottom 


A boolean attribute field with a selection of the faces on 
the bottom of the cone. If the Fill Type property is set to 
none, then this will be a selection of the bottom edges 
instead. If Radius Bottom is zero, this will be a selection 
of the bottom vertex. 


Cube Node 


The Cube node generates a cuboid 
mesh with variable side lengths and 
subdivisions. The inside of the mesh is 
still hollow like a normal cube. 


Vertices X 


Vertices Y 


Vertices Z 


Inputs 


Size 
Side lengths along each of the main axes. 


Vertices X, Y, Z 
Number of vertices for each side of the cube. The 
number of vertices should be at least 1. 


Properties 
This node has no properties. 


Outputs 


Mesh 
Standard geometry output. 


Cylinder Node 


The Cylinder node generates a 
cylinder mesh. It is similar to the Cone 
node but always uses the same radius 


for the circles at the top and bottom. Top 
Side @ 


Y Cylinder 


Mesh 


Bottom 


FilType N-Gon v 


Vertices 32 


Side Segments 1 


FillSegments 1 
Radius lm 


Depth 2m 


Inputs 


Vertices 
Number of vertices on the circle at the top and bottom. 
No geometry is generated if the number is below three. 


Side Segments 
Number of edges running vertically along the side of the 
cone. No geometry is generated if the number is below 
one. 


Fill Segments 
Number of concentric rings used to fill the round faces at 
the top and bottom. No geometry is generated if the 
number is below one. 


Radius 
Distance of the vertices from the Z axis. If this is zero, 
the output will be a single line. 


Depth 
Height of the cylinder. 


Properties 


Fill Type 
How the circles at the top and bottom are filled with 
faces when their radius is larger than zero. 


None: Do not fill the circles. 

N-Gon: Fill the innermost segment of the 
circles with a single face. 

Triangles: Fill the innermost segment of the 


circles with triangles connected to a 
new vertex on the Z axis. 


Outputs 


Mesh 
Standard geometry output. 


Top 
A boolean attribute field with a selection of the faces on 
the top of the cylinder. If the Fill Type property is None, 
then this will be a selection of the top edges instead. If 
the Radius is zero, this will be a selection of the top point. 


Side 
A boolean attribute field with a selection of the faces on 
the side of the cylinder. 


Bottom 
This is the same as the Top selection output, but on the 
bottom side of the geometry instead. 


Grid Node 


The Grid node generates a planar 
mesh on the XY plane. 


Size X 


Size Y 


Vertices X 
Vertices Y 


Inputs 


Size X 
Side length of the plane in the X direction. 


Size Y 
Side length of the plane in the Y direction. 


Vertices X 
Number of vertices in the X direction. If this is smaller 
than two, no mesh is generated. 


Vertices Y 
Number of vertices in the Y direction. If this is smaller 
than two, no mesh is generated. 


Properties 


This node has no properties. 


Outputs 


Mesh 
Standard geometry output. 


Icosphere Node 


The Icosphere node generates a 
spherical mesh that consists of equally 
sized triangles. 


Y Ico Sphere 


a Radius lm 


Subdivisions 1 


Inputs 


Radius 
Distance of the vertices from the origin. 


Subdivisions 
Number of subdivisions on top of the most basic 
icosphere. The number of faces quadruple with every 
Subdivision. 


Properties 
This node has no properties. 


Outputs 


Mesh 
Standard geometry output. 


Mesh Circle Node 


The Mesh Circle node generates a 
circular ring of edges that is optionally 
filled with faces. hee 


Y Mesh Circle 


Fill Type None v 


Vertices 32 
& Radius 


Inputs 


Vertices 
Number of vertices on the circle. No geometry is 
generated when the number is below three. 


Radius 
Distance of the vertices from the origin. 


Properties 
Fill Type 
How the circle is filled with faces. 
None: Output just the edge ring without any 
faces. 
N-Gon: Fill the circle with a single face. 
Triangles: Fill the circle with triangles connected 


to a new vertex at the origin. 


Outputs 


Mesh 
Standard geometry output. 


Mesh Line Node 


The Mesh Line node generates SMCS 
vertices in a line and connects them 
with edges. 


Offset 


Count 


Start Location: 


Inputs 


Count 
Number of vertices on the line. 


Resolution 
Length of individual edges. The node tries to fit as many 
vertices as possible between the start and end point. The 
exact end point might not be hit. This is only available 
when the mode is set to End Points and the count mode 
is set to Resolution. 


Start Location 
Position of the first vertex. 


Offset 
Controls the direction of the line and distance between 
the vertices. This is only available when the mode is set 
to Offset. 


End Location 
Position of the last vertex. This is only available when the 
mode is set to End Points. 


Properties 
Mode 
Inputs to use to control the line. 
Offset: Specify the offset from one vertex to 
the next. 
End Points: Specify the start and end point of the 
line. 
Count Mode 


Determines how the number of vertices is chosen. This is 
only available when the mode is set to End Points. 


Count: Specify the total number of vertices. 
Resolution: Specify the distance between vertices. 
Outputs 
Mesh 


Standard geometry output. 


UV Sphere Node 


The UV Sphere node generates a 
spherical mesh mostly out of quads 
except for triangles at the top and 
bottom. Segments 32 
Rings 16 


Y UV Sphere 


Mesh 


eS Radius 


Inputs 


Segments 
Horizontal resolution of the sphere. If this is smaller than 
three, no mesh is generated. 


Rings 
Vertical resolution of the sphere. If this is smaller than 
two, no mesh is generated. 


Radius 
Distance of vertices to the origin. 


Properties 
This node has no properties. 


Outputs 


Mesh 
Standard geometry output. 


Mesh Topology Nodes 


Nodes that retrieve information about the connectivity 
between mesh elements. 


Corners of Face Node 
Corners of Vertex Node 
Edges of Corner Node 
Edges of Vertex Node 

Face of Corner Node 
Offset Corner in Face Node 
Vertex_of Corner Node 


Corners of Face Node 


The Corners of Face node gives 
access to specific corners of input 
faces. Comer Index 


Y Comers of Face 


Total 


Face Index 


© Weights 


Sort Index 


Inputs 


Face Index 
The index of the input face. 


Note 

By default this uses the index from the field context, 
which makes it important that the node is evaluated on 
the face domain. 


Weights 
Values used to sort the face’s corners. By default the 
corners are sorted by index, so the corners with the 
smallest indices come first. 


Sort Index 
Which of the sorted corners to use for the Corner Index 
output. If the value is larger than the total number of 


corners, it will wrap around to the beginning. 


Properties 


This node has no properties. 


Outputs 


Corner Index 
The index of one of the face’s corners, chosen by the Sort 


Index input. 


Total 
The number of corners in the face, or its side count. 


Corners of Vertex Node 


The Corners of Vertex node 
retrieves face corners attached to v Comers of Vertex 
each vertex. The node first Comer hier 
gathers a list of the corners of all 
faces connected to the vertex. 
That list is then sorted based on Vertex Index 
the values of the Sort Weight 
input. The Tota/ output is the 
number of connected Sort Index 
faces/corners, and the Corner 
Index output is one of those 
corners, chosen with the Sort 
Index input. 


Total 


© Weights 


Inputs 


Vertex Index 
The index of the input vertex. 


Note 

By default this uses the index from the field context, 
which makes it important that the node is evaluated on 
the vertex domain. 


Weights 
Values used to sort the corners connected to the vertex. 
By default the corners are sorted by index, so the corners 
with the smallest indices come first. 


Sort Index 
Which of the sorted corners to use for the Corner Index 
output. If the value is larger than the total number of 
connected face corners, it will wrap around to the 
beginning. 


Properties 


This node has no properties. 


Outputs 


Corner Index 
An corner connected to the face, chosen by the Sort 
Index input. 


Total 
The number of faces or face corners connected to the 
vertex. 


Edges of Corner Node 


The Edges of Corner node 
retrieves the edges on both sides v Edges of Corner 
of a face corner. Next Edge Index 


Previous Edge Index 


Corner Index 


Inputs 


Corner Index 
The index of the input face corner. 


Note 

By default this uses the index from the field context, 
which makes it important that the node is evaluated on 
the face corner domain. 


Properties 


This node has no properties. 


Outputs 


Next Edge Index 
The index of the neighboring edge in the face, in the 
direction of increasing face corner indices. 


Previous Edge Index 
The index of the neighboring edge in the face, in the 
direction of decreasing face corner indices. 


Edges of Vertex Node 


The Edges of Vertex node retrieves 
the edges connected to each St 
vertex. Each vertex is connected Edge Index 
to several edges. The node first 
collects a list of those edges, then 
sorts them based on the Sort Vertex Index 
Weight input. The Tota/ output is © Weights 
the number of edges in that list, 
and the Edge Index output is one 
of those edges chosen with the 
Sort Index input. 


Total 


Sort Index 


One example use is finding the “most vertical” edge 
connected to each vertex. 


Inputs 


Vertex Index 
The index of the input vertex. 


Note 

By default this uses the index from the field context, 
which makes it important that the node is evaluated on 
the vertex domain. 


Weights 
Values used to sort the edges connected to the vertex. 
By default the edges are sorted by index, so the edges 
with the smallest indices come first. 


Sort Index 
Which of the sorted edges to use for the Edge Index 
output. If the value is larger than the total number of 
connected edges, it will wrap around to the beginning. 


Properties 


This node has no properties. 


Outputs 


Edge Index 
An edge connected to the face, chosen by the Sort Index 
input. 


Total 
The number of edges connected to the vertex. 


Face of Corner Node 


The Face of Corner node retrieves 


the face a face corner is part of. eae 


Face Index 


Index in Face 


Corner Index 


Inputs 


Corner Index 
The index of the input face corner. 


Note 
By default this uses the index from the field context, 


which makes it important that the node is evaluated on 
the face corner domain. 


Properties 


This node has no properties. 


Outputs 


Face Index 
The index of the face the corner is a part of. 


Index in Face 
The index of the corner, starting from the first corner in 
the face. Each face is comprised of a list of face corners, 
this output is the distance from the start of that list. If the 
corner is the first in the face, the value will be zero. If it 
comes last, the value will be one less than the number of 
corners in the face. 


Offset Corner in Face Node 


The Offset Corner in Face node 
retrieves other corners in the Bo ani LMP Tiki 
same face as the input face corner. Corner Index 
This is like “rotating” the input 
corner around in its face. 


Corner Index 


Offset 
Conceptually the operation is 
similar to the Offset Point in Curve 
Node. 


Inputs 


Corner Index 
The index of the input face corner 


Note 

By default this uses the index from the field context, 
which makes it important that the node is evaluated on 
the face corner domain. 


Offset 


The number of corners to move around the face before 
finding the result, circling around the start of the face if 
necessary 


Properties 


This node has no properties. 


Outputs 


Corner Index 
The index of the offset face corner. 


Vertex of Corner Node 


The Vertex of Corner node outputs 
the index of the vertex that a face 
corner is attached to. Vertex Index 


Y Vertex of Comer 


Comer Index 


Inputs 


Corner Index 
The index of the face corner. 


Note 
By default this uses the index from the field context, 


which makes it important that the node is evaluated on 
the face corner domain. 


Properties 


This node has no properties. 


Outputs 


Vertex Index 
The index of the vertex that the face corner is attached 
to. 


Output Nodes 


Nodes that output to outside the node tree. 


e Viewer Node 


Viewer Node 


The Viewer node allows 
viewing data from inside a Vv Viewer 
geometry node group in the 

Spreadsheet Editor and the 3D 


Auto 


Any geometry connected can © Value 
be visualized in the viewport 
and its attribute values can be 
read in the spreadsheet. 


Activation and Deactivation 


Using Shift-Ctrl-LMB On any node or socket connects it to the 
viewer and makes it active. Using the same shortcut on 
empty space in the node editor makes deactivates the 
active viewer. When the active viewer is not visible anymore 
(e.g. another object is selected, or the current node group is 
exited), it is deactivated. The icon in the viewer node 
header can also be used to activate and deactivate it. 


In the viewport, the Show Viewer option can turn off the 
viewer node visualization completely in order to see the 
final output of the object’s evaluation instead. 


Attribute Visualization 


When the viewer has a geometry and a separate value input 
connected, the values can be visualized with a viewport 
overlays. When possible, the attribute domain used to 


visualize the data is determined automatically. Otherwise, 
the viewer node falls back to the face corner domain on 
meshes and the point domain on curves. When necessary, 
the domain can be chosen manually. 


The attribute overlay opacity can be controlled with the 
Viewer Node setting in the overlays popover. 


The spreadsheet now only shows the “Viewer” column for 
the domain that is selected in the Viewer node. 


Pinning 


It can be helpful to pin a specific viewer node in the 
spreadsheet. When pinned, the spreadsheet still references 
the viewer node even when it becomes inactive. 


Inputs 


Geometry 
Geometry that will be displayed in the Spreadsheet. 


Value 
Field to be evaluated on the geometry. The type for this 
value is chosen automatically when the keyboard 
shortcut to link an output is pressed. However, if the type 
must be adjusted manually, it is available in the node 
editor Sidebar. 


Properties 


Data Type 
The data type used to evaluate the Value input, visible in 
the node side-bar. 


Domain 
The attribute domain used to evaluate the Value input. 
The Auto option chooses the domain automatically based 
on the connected nodes. 


Outputs 


This node has no outputs. 


Point Nodes 


Nodes generate or modify point clouds. 


Distribute Points in Volume 
Distribute Points on Faces 
Points Node 

Points to Vertices Node 
Points to Volume Node 


Set Point Radius Node 


Distribute Points In 
Volume 


Y Distribute Points in Volume vy Distribute Points in Volume 
Points Points 
Random Grid v 


Volume Volume 


@ Density Spacing: 
Seed 


Threshold 


The Distribute Points in Volume node creates points inside of 
volume grids. The node has two basic modes of operation: 
distributing points randomly, or in a regular grid. Both 
methods operate on all of the float grids in the volume. 


Inputs 


Volume 
Standard volume geometry input. 


Density 
Number of points to sample per unit volume. 


Spacing 


Spacing between grid points. 


Threshold 
Minimum value of a volume cell to contain a grid point 


Properties 


Distribution Method 

Random: Distribute points randomly inside of the 
volume. The local point count is 
implicitly defined as a product of of the 
global from the Density input and the 
local voxel value. This method creates 
a distribution that is not stable as the 
input volume deforms. 

Grid: Distribute the points in a grid pattern 
inside of the volume. At each grid 
point, the voxel value is used to 
determine whether to add a point. 


Outputs 


Points 
Standard point cloud geometry output. 


Distribute Points on Faces 


The Distribute Points on Faces 
node places points on the surface 


Y Distribute Points on Faces 


of the input geometry object. Point, Points 
corner and polygon attributes of Normal 
the input geometry are transferred Rotation 


to the generated points. That 
includes vertex weights and UV 
maps. Additionally, the node has 
Normal and Rotation outputs. 


Random v 
Mesh 


© Selection 


© Density 10.000 


The node also generates a stable Set : 
ID, stored in the built-in id 
attribute, used as a stable 
identifier for each point. When the mesh is deformed or the 
density changes the values will be consistent for each 
remaining point. This attribute is used in the Random Value 
and Instance on Points nodes. 


Inputs 


Mesh 
Standard geometry input. 


Note 
The input geometry must contain a mesh with faces. 


Selection 


The selection of which face corners should be considered 
for point distribution. 


Distance Min 
The minimal distance points can have to each other. This 
option is only available for the Poisson Disk distribution 
method. At its default value of zero, the node’s behavior 
is the same as it is in Random mode, because none of 
the internally generated points are removed. 


Density Max 


The point density for the point distribution. The unit is in 
number of points per square meter. This value is 
multiplied by the values from the Density input. Only 
available in Poisson Disk mode. 


Note 


This will be capped on distributions by the Distance Min 
option. If the density is greater than what the minimal 
distance allows, no new points will be added after this 
threshold has been passed. 


Density 


The number of points to distribute per square meter on 
each mesh face. This value is multiplied by the values 
from the Density Attribute. 


In Poisson Disk mode, this value is multiplied by the 
Density Max input for the final density. 


Seed 
The random Seed to use when generating points. 


Properties 


Distribution Method 


Random: Distribute points randomly on the 
surface. This is the fastest distribution 
method. 

Poisson Disk: Distribute points randomly on the 
surface while taking a minimum 
distance into account. 


Outputs 


Points 
Generated points. Named attributes are copied to the 
result mesh, along with the data in the other attribute 
field outputs. 


Normal 
The Normal of the triangle on which each point is 
scattered. 


Rotation: 
An XYZ Euler rotation built from the normal attribute for 
convenience. Such a value can also be built from the 
normal with the Rotate Euler Node. Keep in mind that the 
Z axis of the result rotation will be arbitrary, since the 
mesh normal used to create the rotation does not have 
enough information to set all three rotation axes. 


Points Node 


The Points node generate a point 
cloud with positions and radii defined 
by fields. 


vy Points 


Geometry 


Count 1 
Position: 
0.000 
0.000 
0.000 
> Radius 0.1m 


Inputs 


Count 
The number of points to create. 


Position 
The position of each generated point. 


Radius 
The radius of each point. 


Note 


Since the point cloud is created from scratch, the Position 
and Radius inputs can only depend on the index node. 
Regular input nodes like the position won’t work. 


Properties 


This node has no properties. 


Outputs 


Points 
Standard geometry output. 


Points to Vertices Node 


Y Points to Vertices 
Mesh 


Points 


© Selection 


The Points to Vertices node generate a mesh vertex in the 
output geometry for each point cloud point in the input 
geometry. 


Inputs 


Geometry 
Standard geometry input. 


Selection 
Boolean field used to determine if each point will be 
converted to a vertex. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Points to Volume Node 


Y Points to Volume 
Volume 
Resolution Amount v 


Points 


B Density 1.000 


® Voxel Amount 64.000 
> Radius 0.5m 


The Points to Volume node generates a fog volume sphere 
around every point in the input geometry. The new volume 
grid is named “density”. 


It usually makes sense to combine this node with the 
Volume to Mesh Node. 


Warning 
This node expects that point positions are not extremely 


large. For position values of many billions, the behavior 
isn’t guaranteed, and it may be unstable. 


Inputs 


Points 
Standard geometry input. 


Density 


Value of voxels inside the generated fog volume. 


Voxel Amount 
Specify the approximate number of voxels along the 
diagonal. 


Voxel Size 
Specify the voxel side length. 


Radius 
Specify the radius of the sohere generated at each point. 


Properties 


Resolution 
How the voxel size is specified. 


Amount: Specify the approximate number of 
voxels along the diagonal. 
Size: Specify the voxel side length. It is 


recommended to be careful when 
tweaking this value, because small 
changes can have a large effect on the 
processing time. 


Outputs 


Volume 
Standard geometry output. 


Set Point Radius Node 


The Set Point Radius node controls the 
size each selected point cloud point 
should display with in the viewport. 


Y Set Point Radius 


Points 
Points 
The input node for this data is the © Selection 
Radius Node. © Radius 0.05m 


Inputs 


Geometry 
Standard geometry input. 


Radius 
Float value indicating the radius of the point geometry at 
each point. 

Selection 


Boolean input for selecting which points will have the 
radius value applied. 


Properties 


This node has no properties. 


Outputs 


Geometry 
Standard geometry output. 


Text Nodes 


Nodes to manipulate strings. 


e Join Strings Node 
Replace String Node 
Slice String Node 
Special Characters Node 
String Length Node 
String_to Curves Node 
Value to String Node 


Join Strings Node 


¥Y Join Strings 
String 


Delimit... 


Strings 


The Join Strings node combines any number of input strings 
into the output string. The order of the result depends on 
the vertical ordering of the inputs in the multi-input socket. 


Tip 


This node can be used to create a multi-line string for the 
String_to Curves Node, when combined with the line break 
output from the Special Characters Node. 


Inputs 


Delimiter 
String value to place between each concatenated string. 


Strings 


Multiple string values to be combined in connection 
order. 


Properties 


This node has no properties. 


Outputs 


String 
String result of the concatenation. 


Replace String Node 


The Replace String node replaces a 
string segment with another. 


Y Replace String 
String 


String 
Find 


Replace 


Inputs 


String 
Standard string input. 


Find 
The substring to find in String to be replaced. 


Replace 
A string segment which replaces occurrences of the Find 
substring. 


Properties 


This node has no properties. 


Outputs 


String 
Standard string output. 


xamples 


Two 
Lines 


* 


¥ String to Curves v v Group Output 


Curves 


Triangles 


Curve 
String 

String = 

Top Baseline 


String - 
String 


Find 


Bist Dat mania Character Spacing 


Line Break Word Spacing 
Tab Line Spacing 
Max Width 


Using the node to add the newline character to a 
string. 


Slice String Node 


Y Slice String 
String 


String 


Position 


Length 


The Slice String node extracts a string segment from a 
larger string. 


Inputs 


String 
String value to be sliced. 


Position 
Integer value used to determine the starting point of the 
new string within the input string. The first letter of the 
string is at index 0. 


Length 
Integer value used to determine how many characters 
are extracted from the input string. 


Properties 


This node has no properties. 


Outputs 


String 
String value of the extracted substring. 


Special Characters Node 


Y Special Characters 


Line Break 


Tab 


The Special Characters node is used to output string 
characters that can’t be typed directly with the keyboard. 


Tip 
This node can be used to create a multi-line string for the 


String to Curves Node, when combined with the Join 
Strings Node or the Replace String_Node. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Line Break 
A new line character (escape character \n). 


Tab 
A tab character used to add an indentation in the output. 


String Length Node 


Y String Length 


Length 


The String Length node outputs the number of characters in 
the input string. 


Inputs 


String 
String value to be evaluated. 


Properties 


This node has no properties. 


Outputs 


Length 
Integer value representing the length of the input string. 


String to Curves Node 


The String to Curves converts a 
string to curve instances. Each 
unique character used in the 


Y String to Curves 


Curve Instances 


. : Li 
string is converted to a curve ni 
once, and further uses of that Ait etl 
character are more instances of ae 

the same geometry. OuertiGe 

This makes processing the a 

output geometry very efficient, Top Baseline 

because each unique character Pivot Point Bottom Left 


only has to be processed once. 
However, it means that the 
result will be the same for every 
instance of the same character. 
To process each character 
individually, the Realize 
Instances Node can be used. 


Character Spacing 


Word Spacing 


Line Spacing 
Text Box Width 


Tip 


Socket inspection can be used to see the value of the 
string input used when the node was evaluated, by holding 
the mouse over the socket. 


Inputs 


String 
Standard string input. 


Size 
The size of each character. The values of the other inputs 
are scaled by this value. 


Character Spacing 
A factor by which the space between each character 
(kerning) is scaled on the X axis. 


Word Spacing 
A factor by which whitespace between words is scaled on 
the X axis. 


Line Spacing 
The distance between separate lines in the output. 
Scaled by the Size input. 


Text Box Width 
The maximum width of each line, though individual 
words will not be wrapped. 


Text Box Height 
The maximum height for all the lines of the text. 


Properties 


Font 
Font glyph used to generate the curve. 


Overflow 
Overflow: Wraps the text at the Text Box Width. 
Scale To Fit: Scales the text size to fit the Text Box 


Width and Text Box Height. 
Truncate: 


Alignment 
Left: 
Center: 
Right: 
Justify: 
Flush: 


Align Y 
Top Baseline: 
Top: 
Middle: 


Only outputs text characters that fit 
within the width and height, based on 
the Size input. Any part of the string 
that did not fit is moved to the 
Remainder output. 


Aligns the text to the left. 

Aligns the text to the center. 

Aligns the text to the right. 

Aligns the text to the left and right. 
Aligns the text to the left and right with 
equal character spacing. 


Aligns the text to the top baseline. 
Aligns the text to the top. 
Aligns the text to the middle. 


Bottom Baseline: 


Bottom: 


Pivot Point 


Aligns the text to the bottom baseline. 
Aligns the text to the bottom. 


Controls where on each character the output Pivot Point 


is placed. 
Midpoint: 
Top Left: 
Top Center: 
Top Right: 
Bottom Left: 


Bottom Center: 


Place the pivot points at the center of 
each character’s bounds. 

Place the pivot points at the top left of 
each character’s bounds. 

Place the pivot points at the middle of 
the top of each character’s bounds. 
Place the pivot points at the top right of 
each character’s bounds. 

Place the pivot points at the bottom left 
of each character’s bounds. 


Place the pivot points at the middle of 

bottom of each character’s bounds. 
Bottom Right: Place the pivot points at the bottom 

right of each character’s bounds. 


Outputs 


Curve Instances 
Curve instances geometry. 


Remainder 
The part of the text that did not fit in the box described 
by the Text Box Height and Text Box Width inputs. Only 
used in the Truncate overflow mode. 


Line 
An attribute field containing which the index of the each 
character's line in the text layout (on the instance 
domain). 


Pivot Point 
Outputs the position described by the Pivot Point drop- 
down in the local space of each instance. 


Examples 


Lorem ipsum dolor sit 
amet, consectetur 
adipiscing elit, sed do 
eiusmod tempor 
incididunt ut labore et 


The node can be used to make overflowing text boxes. Here, 
the text that does not fit into the first node’s fix-sized text 
box is passed to a separate String to Curves node. And 
finally added with a Scale to Fit node. 


Value to String Node 


Y Value to String 


String 


& Value 0.000 


Decimals 0 


The Value to String node generates string representation of 
the input value. 


Inputs 


Value 
Floating-point value to be converted. 


Decimals 
Integer value used to determine the precision of the 
output value. 


Properties 


This node has no properties. 


Outputs 


String 
String value representation of the input. 


Texture Nodes 


Nodes to add textures. 
Tip 


Texture nodes can produce details at a higher frequency 
than geometry can show. This is more evident with 
textures that produce abrupt changes such as brick and 
checker. This may cause artifacts such as Moiré type 
patterns or a lack of detail due to insufficient sampling 
points. 


Brick Texture Node 
Checker Texture Node 
Gradient Texture Node 
Image Texture Node 
Magic Texture Node 
Musgrave Texture Node 
Noise Texture Node 
Voronoi Texture Node 
Wave Texture Node 
White Noise Texture Node 


Brick Texture Node 


Note 


This node is ported from shader nodes. The manual and 
images are referencing the shader version of the node. 
This node accepts field inputs and outputs. When not 
connected the Vector input has an implicit position 
attribute value. 


Tip 


Texture nodes can produce details at a higher frequency 
than geometry can show. This may cause artifacts such as 
Moiré type patterns or a lack of detail due to insufficient 
sampling points. 


The Brick Texture is used to add a procedural texture 
producing bricks. 


Y Brick Texture 


Offset 
Frequency 


Squash 1.000 


Frequency 2 


Vector 


Color2 


Mortar 
Scale 5.000 
Mortar Size 0.020 
Mortar Smo 0.100 
Bias 0.000 
Brick Width 0.500 
Row Height 0.250 


Inputs 


Color 1/2 
Color of the bricks. 


Mortar 
The color of the area between bricks. 


Scale 
Overall texture scale. 


Mortar Size 
The size of the filling between the bricks known as 
“mortar”; 0 means no mortar. 


Mortar Smooth 
Blurs/softens the edge between the mortar and the 
bricks. This can be useful with a texture and 
displacement textures. 


Bias 
The color variation between Co/or 1/2. Values of -1 and 1 
only use one of the two colors; values in between mix the 
colors. 


Brick Width 
The width of the bricks. 


Row Height 
The height of the brick rows. 


Properties 


Offset 
Determines the brick offset of the various rows. 


Frequency 
Determines the offset frequency. A value of 2 gives an 
even/uneven pattern of rows. 


Squash 
Amount of brick squashing. 


Frequency 
Brick squashing frequency. 


Outputs 


Color 
Texture color output. 


Factor 
Mortar mask (1 = mortar). 


Examples 


Brick texture: Colors changed, Squash 0.62, Squash 
Frequency 3. 


Checker Texture Node 


Note 


This node is ported from shader nodes. The manual and 
images are referencing the shader version of the node. 
This node accepts field inputs and outputs. When not 
connected the Vector input has an implicit position 
attribute value. 


Tip 


Texture nodes can produce details at a higher frequency 
than geometry can show. This may cause artifacts such as 
Moiré type patterns or a lack of detail due to insufficient 
sampling points. 


The Checker Texture is used to adda Y Checker Texture 
checkerboard texture. 


Color 


Fac ®@ 


Vector 


Color2 


i) Scale 


Inputs 


Vector 


Texture coordinate to sample texture at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


Warning 


This node can have precision issues with some vector 
inputs. See the notes for the White Noise Texture for 
ways to mitigate this issue. 


Color1, Color 2 
Color of the checkers. 


Scale 
Overall texture scale. The scale is a factor of the 
bounding box of the face divided by the scale. For 
example, a scale of 15 will result in 15 alternate patterns 
over the overall UV bounding box. Different patterns 
could be achieved using other nodes to give different 
input patterns to this socket. For example, using the 
Math node. 


Properties 


This node has no properties. 


Outputs 


Color 
Texture color output. 


Factor 
Checker 1 mask (1 = Checker 1). 


Examples 


Default Checker texture. 


Gradient Texture Node 


Note 


This node is ported from shader nodes. The manual and 
images are referencing the shader version of the node. 
This node accepts field inputs and outputs. When not 
connected the Vector input has an implicit position 
attribute value. 


The Gradient Texture node generates Y Gradient Texture 
interpolated color and intensity values ne 
based on the input vector. cate 


Linear v 


Vector 


Inputs 


Vector 
Texture coordinate to sample texture at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


Properties 


Type 
Controls the type of gradient generated. 


Linear: Directly outputs the input X coordinate. 


Quadratic: Interpolates the input X coordinate 
quadratically. 

Easing: Uses a combination of quadratic and 
linear interpolation to generate a 
smooth gradient from the input X 


coordinate. 

Diagonal: Averages the input X and Y 
coordinates. 

Spherical: Creates an inverse gradient using the 


length of the input vector; the 
maximum value is at (0, 0, 0). 
Quadratic Sphere: 
The same as Spherical, except 
interpolated quadratically. 
Radial: Outputs a value based on the angle of 
the input around the Z axis. 


Outputs 


Color 
Texture color output. 


Factor 
Texture intensity output. 


Examples 


_ 


Gradient texture using object coordinates. 


Image Texture Node 


Note 


Unlike the other texture nodes, this node operates 
differently in geometry nodes compared to the equivalent 
Shader node. When not connected the Vector input has an 
implicit position attribute value. 


The Image Texture node is v Image Texture 
used to add an image file 
as a texture. The image 
data is sampled with the 
input Vector and outputs a Aaa! 
Color and Alpha value. Repeat 
Aly + 


Vector 


Color 


Alpha @ 


Frame 


Inputs 


Image 
The image socket can be used to connect to the Group 
Input node. If this is not connected the image can be 
opened or selected from the node. 


Vector 
Texture coordinate for texture look-up. If this socket is left 
unconnected, the Position attribute is used. 


Frame 


If the Image supports animation, the frame can be set 
here. This can be keyframed so that the image changes 


between frames. 


Properties 


Interpolation 


Method to scale images up or down for sampling. 


Linear: 
Cubic: 


Closest: 


Extension 


Regular quality interpolation. 
Smoother, better quality interpolation. 
For bump maps this should be used to 
get best results. 

No interpolation, use only closest pixel 
for rendering pixel art. 


Extension defines how the image is extrapolated past the 


Original bounds: 


Repeat: 
Extend: 


Clip: 


Outputs 


Color 


Will repeat the image horizontally and 
vertically giving tiled-looking result. 
Will extend the image by repeating 
pixels on its edges. 

Clip to the original image size and set 
all the exterior pixels values to 
transparent black. 


RGBA color from the image. 


Alpha 


Alpha channel from image. 


Examples 


Image Texture displacing a plane. 


Magic Texture Node 


Note 


This node is ported from shader nodes. The manual and 
images are referencing the shader version of the node. 
This node accepts field inputs and outputs. When not 
connected the Vector input has an implicit position 
attribute value. 


The Magic Texture node is used to add VY Magic Texture 
a psychedelic color texture. pie 


Fac @ 


Depth 2 


Vector 
® Scale 5.000 
a Distortion 1.000 


Inputs 


Vector 
Texture coordinate to sample texture at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


Scale 
Scale of the texture. 


Distortion 
Amount of distortion. 


Properties 


Depth 
Number of iterations. 


Outputs 


Color 
Texture color output. 


Factor 
Texture intensity output. 


Examples 


Magic texture: Depth 10, Distortion 2.0. 


Musgrave Texture Node 


Note 


This node is ported from shader nodes. The manual and 
images are referencing the shader version of the node. 
This node accepts field inputs and outputs. When not 
connected the Vector input has an implicit position 
attribute value. 


The Musgrave Texture node evaluates Y Musgrave Texture 

a fractal Perlin noise at the input Height @ 
texture coordinates. Unlike the Noise 

Texture, which is also a fractal Perlin se vl 
noise, the Musgrave Texture allows fBM v 
greater control over how octaves are Vector 


combined. Scale 5.000 


Detail 2.000 
Dimension 2.000 


Lacunarity 2.000 


Inputs 


The inputs are dynamic, they become available if needed 
depending on the node properties. 


Vector 
Texture coordinate to evaluate the noise at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


W 
Texture coordinate to evaluate the noise at. 


Scale 
Scale of the base noise octave. 


Detail 
Number of noise octaves. The fractional part of the input 
is multiplied by the magnitude of the highest octave. 
Higher number of octaves corresponds to a higher render 
time. 


Dimension 
The difference between the magnitude of each two 
consecutive octaves. Larger values corresponds to 
smaller magnitudes for higher octaves. 


Lacunarity 
The difference between the scale of each two 
consecutive octaves. Larger values corresponds to larger 
scale for higher octaves. 


Offset 
An added offset to each octave, determines the level 
where the highest octave will appear. 


Gain 
An extra multiplier to tune the magnitude of octaves. 


Properties 


Dimensions 
The dimensions of the space to evaluate the noise in. 


1D: Evaluate the noise in 1D space at the 
input W. 


2D: Evaluate the noise in 2D space at the 
input Vector. The Z component is 


ignored. 

3D: Evaluate the noise in 3D space at the 
input Vector. 

4D: Evaluate the noise in 4D space at the 


input Vector and the input W as the 
fourth dimension. 


Higher dimensions corresponds to higher render time, so 
lower dimensions should be used unless higher dimensions 
are necessary. 


Type 


Type of the Musgrave texture. 


FBM (Fractal Brownian Motion): 
Produces an unnatural homogeneous 
and isotropic result. Uses an additive 
cascade, the values are simply added 
together. 

Multifractal: The result is more uneven (varies with 
location), more similar to a real terrain. 
Uses a multiplicative cascade. 

Hybrid Multifractal: 
Creates peaks and valleys with 
different roughness values, like real 
mountains rise out of flat plains. 
Combines the additive cascade with a 
multiplicative cascade. 

Ridged Multifractal: 
Creates sharp peaks. Calculates the 
absolute value of the noise, creating 
“canyons”, and then flips the surface 
upside down. 

Hetero Terrain (Heterogeneous Terrain): 


Similar to Hybrid Multifractal creates a 
heterogeneous terrain, but with the 
likeness of river channels. 


Outputs 


Height 
Texture value. 


Examples 


Remapped Musgrave texture such that most values are 
visible. 


vy Map Range 
Result @ 


¥ Clamp 
Value 
From Min -1.000 
From Max 1.000 
To Min 0,000 


To Max 1.000 


Lacunarity 1.550 


Musgrave 
texture. 


Nodes for the image to the 
right. 


Musgrave Types 


Different Musgrave types with the same parameters. 


fBM (fractal Multifractal. 
Brownian Motion). 


Heterogeneous 
Terrain. 


Hybrid Multifractal. 


Ridged Multifractal. 


See also 


Displacement 


Noise Texture Node 


Note 


This node is ported from shader nodes. The manual and 
images are referencing the shader version of the node. 
This node accepts field inputs and outputs. When not 
connected the Vector input has an implicit position 
attribute value. 


The Noise Texture node evaluates a V Noise Texture 
fractal Perlin noise at the input texture 
coordinates. 


Vector 
Scale 5.000 
Detail 2.000 


Roughnes 0.500 


Distortion 0.000 


Inputs 


The inputs are dynamic, they become available if needed 
depending on the node properties. 


Vector 
Texture coordinate to evaluate the noise at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


W 
Texture coordinate to evaluate the noise at. 


Scale 
Scale of the base noise octave. 


Detail 
Number of noise octaves. The fractional part of the input 
is multiplied by the magnitude of the highest octave. 
Higher number of octaves corresponds to a higher render 
time. 


Roughness 
Blend between a smoother noise pattern, and rougher 
with sharper peaks. 


Distortion 
Amount of distortion. 


Properties 


Dimensions 
The dimensions of the space to evaluate the noise in. 


1D: Evaluate the noise in 1D space at the 
input W. 

2D: Evaluate the noise in 2D space at the 
input Vector. The Z component is 
ignored. 

3D: Evaluate the noise in 3D space at the 
input Vector. 

4D: Evaluate the noise in 4D space at the 


input Vector and the input W as the 
fourth dimension. 


Note 


Higher dimensions corresponds to higher render time, 
so lower dimensions should be used unless higher 
dimensions are necessary. 


Outputs 


Factor 
Value of fractal noise. 


Color 
Color with different fractal noise in each component. 


Examples 


Fac @ 


Color @ 


3D 


Vector 
Scale 5.000 
Detail 16.000 


Roughness 0.500 


Distortion 0.000 


Noise Texture with high detail. 


Notes 


While the noise is random in nature, it follows a certain 
pattern that might not evaluate to random values in some 
configurations. For instance, consider the following 
configuration where a grid of objects have a material that 
evaluates a noise texture at their locations. One might 
expect the objects to have random values since they have 
different locations, but this is not the case. 


An example configuration where the noise evaluates 
to a constant value. 


It seems all objects have a value of 0.5. To understand why 


this happens, let us look at the following plot of a 1D noise 
texture. 


A plot of a 1D noise with zero details and zero 
distortion. 


The horizontal line denotes a value of 0.5 and the vertical 
lines denotes whole numbers assuming a noise scale of 1. 
As can be seen, the noise always intersects the 0.5 line at 
whole numbers. Since the aforementioned objects were 


distributed on a grid and have whole number locations, they 
all evaluate to 0.5. Which explains the issue at hand. 


Generally, any discrete evaluation of noise at integer 
multiples of the reciprocal of the noise scale will always 
evaluate to 0.5. It also follows that evaluations closer to that 
will have values close to 0.5. In such cases, it is almost 
always preferred to use the White Noise Texture. 


Regardless, one can mitigate this issue in a number of ways: 


e Adjust the scale of the noise to avoid aligning the noise 
with the evaluation domain. 

e Add an arbitrary offset to the texture coordinates to 

break the alignment with the evaluation domain. 

Evaluate the noise at a higher dimension and adjust the 

extra dimension until a satisfactory result is achieved. 


Constant value idea: i ale 
issue. y agjusting the 
scale. 


Mitigating the issue Mitigating the issue 
by adding an by evaluating ata 
arbitrary offset. higher dimension. 


Similarly, in other configurations, one might experience 
some banding patterns in the noise, where there are bands 
of high contrast areas followed by banding of low contrast 
areas. For instance, planar surfaces that are slightly tilted 
along one of the axis will have such a banding pattern. 


» Viewer 


y Material Output 


168.808 


Distortion 6.000 


An example configuration where the noise have a 
banding pattern. 


This happens because the slight tilt along one of the axis 
causes values along the perpendicular axis to change very 
slowly making the grid structure of the noise more apparent. 
The easiest way to mitigate this issue to rotate the 
coordinates by an arbitrary amount. 


View Select Add Object 


Top Orthographic as ¢ * sant? Racy ¥ Transform 
© Collection | Plane hea aye: ita cee a ¥ Location: 
16 Continaters aL Sty 2 : pines 


z 
Rotation: 
x 
Y 
z 


XYZ Euler 


Oe wl ooject View Select 


¥ Geometry y Vector Rotate 


Position 


y Material Output 
Type Euler 
all 
Invert ” 
Surface 
Vector Vector 


Center: Scale 100.6808 
6.008 Detail 6.008 
6.008 Roughness 6.508 


Volume 


Displacenent 


8.008 Distortion 0.800 
Rotation: 
x 
y 
z 


Material 


Mitigating the issue by rotating the coordinates by 
an arbitrary amount. 


Voronoi Texture Node 


Note 


This node is ported from shader nodes. The manual and images are referencing the 
shader version of the node. This node accepts field inputs and outputs. When not 
connected the Vector input has an implicit position attribute value. 


The Voronoi Texture node evaluates a Worley Noise at the input ’ Voronoi Texture 
texture coordinates. Distance @ 


Color 


Position 


Euclidean 


Vector 


9 Scale 5.000 


t Randomn 1.000 


Inputs 


The inputs are dynamic, they become available if needed depending on the node 
properties. 


Vector 
Texture coordinate to evaluate the noise at; defaults to Generated texture coordinates if 


the socket is left unconnected. 


W 
Texture coordinate to evaluate the noise at. 


Scale 
Scale of the noise. 


Smoothness 
The smoothness of the noise. 


_ 


oo 


~~ ~~ I Pm - a 
Smoothness: Smoothness: Smoothness: Smoothness: 
0.0. 0.25. 0.5. 1.0. 


(ae : “4 

Smoothness: Smoothness: Smoothness: Smoothness: 

0.0. 0.25. 0.5. 1.0. 
Exponent 


Exponent of the Minkowski distance metric. 


a 


Exponent: Exponent: Exponent: Exponent: 


0.5. 1.0. 2.0. 32.0. 
Randomness 


The randomness of the noise. 


y Va 
Randomness: Randomness: Randomness: Randomness: 
1.0. 0.5. 0.25. 0.0. 
Properties 
Dimensions 


The dimensions of the space to evaluate the noise in. 


1D: Evaluate the noise in 1D space at the input W. 

2D: Evaluate the noise in 2D space at the input Vector. The Z component 
is ignored. 

3D: Evaluate the noise in 3D space at the input Vector. 

4D: Evaluate the noise in 4D space at the input Vector and the input W as 


the fourth dimension. 


Higher dimensions corresponds to higher render time, so lower dimensions should be 
used unless higher dimensions are necessary. 


Feature 
The Voronoi feature that the node will compute. 


Fl: The distance to the closest feature point as well as its position and 
color. 


Distance. Color. Position. 


F2: The distance to the second closest feature point as well as its position 
and color. 


el 

\) > 

Lee 

”: : 

al y| 

Distance. Position. 
Smooth F1: A smooth version of F1. 

Distance. Color. Position. 


Distance to Edge: 
The distance to the edges of the Voronoi cells. 


Bee 


Distance smaller than 


Distance. 0.05. 


N-Sphere Radius: 


Distance Metric 


The radius of the n-sphere inscribed in the Voronoi cells. In other 


words, it is half the distance between the closest feature point and the 
feature point closest to it. 


The n-sphere radius can 
be used to create tightly to the left. 
packed n-spheres. 


Node tree for the shader 


The distance metric used to compute the texture. 


Euclidean: 

Manhattan: 
Chebychev: 
Minkowski: 


Minkowski 
Exponent: 
0.5 
(Minkowski 
1/2). 


Outputs 


Distance 
Distance. 


Color 


Use the Euclidean distance metric. 

Use the Manhattan distance metric. 

Use the Chebychev distance metric. 

Use the Minkowski distance metric. The Minkowski distance is a 
generalization of the aforementioned metrics with an Exponent as a 
parameter. Minkowski with an exponent of one is equivalent to the 
Manhattan distance metric. Minkowski with an exponent of two is 
equivalent to the Euclidean distance metric. Minkowski with an infinite 
exponent is equivalent to the Chebychev distance metric. 


Minkowski Minkowski 


Minkowski 
. Exponent: 
‘eee a6 Exponent: 32.0 
ai anata. (Euclidean. (approximation 


of Chebychev). 


Cell color. The color is arbitrary. 


Position 
Position of feature point. 


Ww 
Position of feature point. 


Radius 
N-Sphere radius. 


Notes 


In some configurations of the node, especially for low values of Randomness, rendering 
artifacts may occur. This happens due to the same reasons described in the 
in the White Noise Texture page and can be fixed in a similar manner as described there. 


Examples 


y Voronoi Texture vy Voronoi Texture 


Distance @ Distance @ 


lor 
cae 5 Subtract ‘ Less Than 


Position © Position ©@ 
Clamp Clamp 


2D 2D : @ Value @ Value 


Smooth F1 ‘ Fl v @ Value @ Value 
Euclidean v Euclidean 


@ Vector @ Vector 
Scale 5.000 e Scale 


The difference between F1 and Smooth F1 can be used to create beveled Voronoi 
cells. 


¥ Voronoi Texture vy Glossy BSDF 
Distance @ Normal 


Color ; 
Power v Invert GGX 


Position 
Clamp Strength 0.200 Color Peo 


3D @ Value e Distance 0.700 Roughness 0.400 


Smooth F1 y @ Value @ Height Normal 


Normal 


Euclidean 


Vector 

Scale 5.000 
Smoothness 0.200 
Randomness 1.000 


Creating a hammered metal shader using the Voronoi Texture node. 


Wave Texture Node 


Note 


This node is ported from shader nodes. The manual and 
images are referencing the shader version of the node. 
This node accepts field inputs and outputs. When not 
connected the Vector input has an implicit position 
attribute value. 


The Wave Texture node adds v Wave Texture 
procedural bands or rings with noise 
distortion. 


Xx 
Sine 
Vector 
Scale 5.000 
Distortion 0.000 
Detail 2.000 
Detail Scale 1.000 


Detail Roug 0.500 


Phase Offse 0.000 


Inputs 


Vector 
Texture coordinate to sample texture at; defaults to 
Generated texture coordinates if the socket is left 


unconnected. 


Scale 
Overall texture scale. 


Distortion 
Amount of distortion of the wave. 


Detail 
Amount of distortion noise detail. 


Detail Scale 
Scale of distortion noise. 


Roughness 
Blend between a smoother noise pattern, and rougher 
with sharper peaks. 


Phase Offset 
Position of the wave along the Bands Direction. This can 
be used as an input for more control over the distortion. 


Properties 


Type 
Bands or Rings shaped waves. 


Bands/Rings Direction 
The axis the bands or rings propagate from i.e. which 
axis they are perpendicular to. When using Bands a 
Diagonal axis is an option and when using Rings the rings 
can propagate outwards from a single point by using 
Spherical direction. 


Wave Profile 
Controls the look of the wave type. 


Uses a sawtooth profile. 
Uses the standard sine profile. 


Saw: 
Sine: 


Outputs 


Texture color output. 


Color 
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Examples 


Wave Texture. 


White Noise Texture Node 


Note 


This node is ported from shader nodes. The manual and 
images are referencing the shader version of the node. 
This node accepts field inputs and outputs. When not 
connected the Vector input has an implicit position 
attribute value. 


The White Noise Texture node returns a random number 
based on an input Seed. The seed can be a number, a 2D 
vector, a 3D vector, or a 4D vector; depending on the 
Dimensions property. The output number ranges between 
zero and one. 


Y White Noise Texture 


Value @ 


Color 


7 


Inputs 


The inputs are dynamic, they become available if needed 
depending on the node properties. 


Vector 
Vector used as seed in 2D, 3D, and 4D dimensions. 


W 
Value used as seed in 1D and 4D dimensions. 


Properties 


Dimensions 
The dimensions of the space to evaluate the noise in. 


1D: The W input is used as seed. 

2D: The X and Y components of the Vector 
input are used as seed. 

3D: The Vector input is used as seed. 

4D: Both the Vector input and the W input 


are used as seed. 


Outputs 


Value 
Output random value. 


Color 
Output random color. 


Notes 


The slightest difference in seed values would result in 
completely different outputs. Consequently, bad precision 
may have significant impact on the output. Usually, we can 
mitigate this issue by: 


e Eliminating the problematic seed value. If the 
problematic seed value is constant, it should be 


eliminated by choosing a lower dimension or multiplying 
it by zero. 
e Adding an arbitrary value to the seed. The issue might 
only happen at certain boundaries, like unit boundaries, 
So simply adding an arbitrary value might solve the 
issue. 
Taking the absolute value of the seed. In computing, 
zero may be positive or negative, so taking the absolute 
values unifies the zero into a single value. 


Precision issue due Mitigating the issue 
to signed zeros on by eliminating the Z 
the Z axis. axis. 


Mitigating the issue Mitigating the issue 
by adding an by taking the 
arbitrary value. absolute value. 


Examples 


Generating cell noise using the Snap vector 
operation and the White Noise node. 


Utilities Nodes 


General purpose nodes for modifying data. 


Accumulate Field Node 
Align Euler to Vector Node 
Boolean Math Node 
Clamp Node 

Compare Node 

Field at Index Node 

Float Curve 

Float To Integer Node 
Interpolate Domain Node 
Map Range Node 

Math Node 

Mix Node 

Random Value Node 
Rotate Euler Node 
Switch Node 


Accumulate Field Node 


The Accumulate Field node counts a 

running total of its input values, in the 
order defined by the geometry’s a 
indices. The node’s essential operation Want) Vy 
is just addition, but instead of only Wena) Vg 
outputting the final total, it outputs 
the current value at every element. 


Y Accumulate Field 


Float v 
Point v 


© Value 1.000 


Group Index 0 


Inputs 


Value 
The values to be accumulated. 


Warning 


When accumulating integer values, be careful to make 
sure that there are not too many large values. The 
maximum integer that Blender stores internally is 
around 2 billion. After that, values may wrap around 
and become negative. See wikipedia for more 
information. 


Group Index 


An index used to group values together for multiple 
separate accumulations. This can be thought of as a 


choice of the “bin” in which to place each value. This 
input has no effect when it is only a single value. 


Properties 
Data Type 
Float: The node will accumulate a Float field. 
Integer: The node will accumulate an Integer 
field. 
Vector: The node will accumulate a Vector 
field. 
Domain 


The attribute domain used for accumulation and for 
evaluation of the Value input. 


Output 


Leading 
The running total of values in the corresponding group, 
starting at the first value. 


Trailing 
The running total of values in the corresponding group, 
starting at zero. 


Total 
The total of all of the values in the corresponding group 


Examples 


Table 


Value Group Index Leading Trailing Total 


1 7 1 0 6 
3 7 4 1 6 
2 7 6 4 6 
1 3 1 0 3 
0 3 1 1 3 
2 3 3 1 3 


A few examples of input values and the node’s results. One 
important take-away from this table is that the specific 
values for the Group Input does not matter; it only matters 
that the values are shared between elements. 


Stacking Boxes 


Here, the node is used in combination with the 

to create a stack of randomly scaled boxes. The 
Group Index input is not used, because all boxes are meant 
to be in the same stack. 


% > Multiply by 3 


© Accumulate Field 


A slightly more complicated version of the previous 
example, using the Group Index input to create three 
separate stacks. 


Align Euler to Vector Node 


Y Align Euler to Vector 


Rotation 


Pivot Auto v 


Rotation 
© Factor 1.000 
Vector: 
0.000 
0.000 
1.000 


The Align Euler to Vector node rotates an Euler rotation into 
the given direction. 


Inputs 


Rotation 
The Euler rotation to align. 


Important 


This input has to be a rotation input. Be careful not to 
connect a direction vector like the normal. 


Factor 
Determines how much the points are rotated towards the 
vector. Zero effectively disables the node and one means 
that the points are aligned with the vector perfectly. 


Vector 
The direction vector that points should be rotated to. The 
vector is in the local space of the object that is being 


modified. When it is all zeros for a point, it is not rotated 
at all. 


Properties 


Axis 
Local axis of the object that is to be rotated towards the 
vector input. 


Pivot 

The local axis to rotate around. 

Auto: The best rotation angle is computed 
automatically. This minimizes the angle 
of rotation. 

X, Y, Z: Rotate around a specific local axis. 

Outputs 
Rotation 


The rotated Euler rotation. 


Boolean Math Node 


The Boolean Math node performs a 
basic logical operation on its inputs. 


Boolean © 


And v 


> Boolean 


© Boolean 


Inputs 


Boolean 
Two standard Boolean inputs. 


Properties 
Mode 
AND: True when both inputs are true. (AND) 
OR: True when at least one input is true. 
(OR) 
NOT: Opposite of the input. (NOT) 
NAND: (True when at least one input is false. 
NAND) 
NOR: True when both inputs are false. (NOR) 
EQV: True when both inputs are equal. Also 
known as “exclusive nor”. (XNOR) 
NEQV: (XOR) True when both inputs are 
different. Also known as “exclusive or”. 
IMPLY: True unless the first input is true and 


the second is false. (IMPLY) 


NIMPLY: True when the first input is true and the 
second is false. Also Known as “”not 
imply”. (NIMPLY) 


Output 


Boolean 
Standard Boolean output. 


Clamp Node 


The Clamp node clamps a value 
between a minimum and a maximum. 


Y Clamp 


Result @ 


Min Max 


Value 


Inputs 


Value 
The input value to be clamped. 


Min 
The minimum value. 


Max 
The maximum value. 


Properties 


Clamp Type 
Method to clamp. 


Min Max: Constrain values between Min and Max. 

Range: Constrain values between Min and Max. 
When Min is greater than Max, 
constrain between Max and Min 
instead. 


Outputs 


Result 
The input value after clamping. 


Examples 


The Voronoi Texture node outputs a value whose minimum 
is zero. We can use the Clamp node to clamp this value such 
that the minimum is 0.2. 


y Voronoi Texture 


Distance @ Result @ 


Color 
Position ©® 
3D 
Fl 
Euclidean 
@ Vector 
Scale 5.000 


Example of Clamp node. 


Compare Node 


Y Greater Than 


Result 


Float v 
Greater Than v 


> A 0.000 
o® =B 0.000 


The Compare node takes two inputs and does an operation 
to determine whether they are similar. The node can work 
on all generic data types, and has modes for vectors that 
contain more complex comparisons, which can help to 
reduce the number of necessary nodes, and make a node 
tree more readable. 


Inputs 


A, B 
Standard value inputs of the selected type. 


C 
Compared against the dot product of two input vectors in 
when the Mode property is set to Dot Product. 


Epsilon 
This value is used as a threshold for still considering the 
two inputs as equal for the Equal and Not Equal 
operations. 


Properties 


Mode 
Element-Wise: 


Length: 


Average: 


Dot Product: 


Direction: 


Operation 
Less Than: 


Compare each axis of the input vectors 
separately, and output true only when 
the result is true for each axis. 
Compare the length of the two input 
vectors. 

Compare the average of the elements 
of the input vectors. This is the same 
as the implicit conversion used when 
setting the node’s data type to Float. 
Compare the dot product of the two 
vectors with the separate C input, 
using the selected operation. The dot 
product outputs a single value that 
says how much the two vectors 
“agree”. 

Compare the angle between the two 
vectors with the separate Angle input, 
using the selected operation. The 
vectors are normalized, so their length 
does not matter. 


True when the first input is smaller than 
second input. 


Less Than or Equal: 


Greater Than: 


True when the first input is smaller than 
the second input or equal. 

True when the first input is greater than 
the second input. 


Greater Than or Equal: 


True when the first input is greater than 
the second input or equal. 


Equal: 


Not Equal: 


Brighter: 


Darker: 


Output 


Result 


True when both the difference between 
the two inputs is smaller than the 
Epsilon input. 

True when both the difference between 
the two inputs is larger than the Epsilon 
input. 

True when the first color input is 
brighter than the second. 

True when the first color input is darker 
than the second. 


Standard Boolean output. 


Examples 


v UV Sphere 


Segments 
Rings 
Radius 


¥ Less Than 


Y Normal 


Normal 
Vector 


Direction 


Y Object Info Less Than 


Location @~_ 


Nos 


@A 


Relative 


° 
@ Cube Bnge 


Mesh @ v Delete Geometry ¥v Group Output 


64 Geometry @ @ Geometry 


32 


@ Geometry 


—-® Selection 
Result @—~ 


Here, the compare node is used with the Direction mode to 


compare the direction of the sphere’s 


to the 


“direction” of the cube object’s location. Anywhere that the 
directions are less than 32.9 degrees apart, the faces will be 


selected, and deleted. 


Field at Index Node 


The Field at Index node allows 
accessing data of other elements in 
the context geometry. It is similar to ois Sy 
the Sample Index Node. The main Fisk 

difference is that this node does not 
require a geometry input, because the 


geometry from the field context is pee 
used. © Value 0.000 


Y Field at Index 


Point 


This node is also similar to the 

Interpolate Domain Node node, except 

that the value to retrieve from the specified domain is 
specified by an index rather than an automatic domain 
interpolation. 


Inputs 


Index 
The index of the element in the selected domain to 
retrieve data from, i.e. “the fourth face”, or “the first 
control point”. 


Value 
The field to retrieve data from. 


Properties 


Domain 
The attribute domain used for for evaluation of the Value 
input. This is useful because it can be a different domain 


than the domain from the field context, i.e. to choose a 
vertex for each face. 


Output 


Value 
The value of the input field at the given index. 


Float Curve 


The Float Curve node maps 
an input float to a curve 
and outputs a float value. 


Y Float Curve 


Value @ 


ONe -v 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output value. 


Value 
Standard float input. 


Properties 


Curve 
For the curve controls see: Curve widget. 


Outputs 


Float 
Standard float output. 


Float To Integer Node 


The Float To Integer node takes a 

single floating point number input and 
converts it to an integer with a choice aad 
of methods. Round v 


> Float 


Inputs 


Float 
Standard float value input. 


Properties 
Rounding Mode 
Round: Outputs the closest integer to Float, 
rounding either up or down based on 
the value. 
Floor: Outputs the closest integer less than 
Float, always rounding down. 
Ceiling: Outputs the closest integer greater 
than Float, always rounding up. 
Truncate: Outputs the closest integer between 


Float and zero. For positive numbers, 
acts like Floor. For negative numbers, 
acts as Ceiling. 


Output 


Result 


Standard integer output. 


Examples 


Input Value Round 


-69.6574 -70 
-3.14159 -3 
-1.5 -2 
1.5 2 
3.14159 3 
69.6574 70 


Floor 


-10 


69 


Ceiling 


-69 


70 


Truncate 


-69 


69 


Interpolate Domain Node 


The Interpolate Domain allows 

evaluating a field for a different 
attribute domain than the domain Value 
from the field context. For example, 


Y Interpolate Domain 


the face index could be used instead flere a 
of the face corner index, when Point v 
setting the values of a UV Map © VCS UPOGd 


Note 


This node is not necessary to retrieve data from other 
attribute domains; that is done automatically. Its utility 
comes from the fact that it’s possible to control when the 
domain interpolation happens. Normally, input nodes 
interpolate their data to the current context’s domain as 
soon as they create their output. 


Tip 


It may be preferrable to use this node over the Capture 
Attribute Node, since it allows using a specific attribute 
domain without requiring a geometry socket input, which 
allows creating more reusable node groups. 


See also 


The method of retrieving data from another domain is 
somewhat similar to the Field at Index Node. 


Inputs 


Value 
The field to evaluate on the chosen attribute domain. 


Properties 


Domain 
The attribute domain used for for evaluation of the Va/ue 


input. 


Output 


Value 
The values from the input, evaluated on the chosen 
domain, then interpolated to the domain from the field 
context. 


Map Range Node 


The Map Range node remaps a value 
from a range to a target range. 


Y Map Range 


Result @ 


Float v 


Linear v 


¥ Clamp 


Value 1.000 
From Min 0.000 
From Max 1.000 
To Min 0.000 
To Max 1.000 


Inputs 


Value/Vector 
The input value or vector to be remapped. 


From Min 
The lower bound of the range to remap from. 


From Max 
The higher bound of the range to remap from. 


To Min 
The lower bound of the target range. 


To Max 
The higher bound of the target range. 


Steps 
The number of values allowed between To Min and To 
Max when using Stepped Linear interpolation. A higher 
value will give a smoother interpolation while lower 
values will progressively quantize the input. 


Properties 


Data Type 
Map Range supports both Float and Vector data types. 
Changing the data type will also update the sockets to 
reflect the data type chosen. 


Interpolation Type 
The mathematical method used to transition between 
gaps in the numerical inputs. 


Linear: Linear interpolation between From Min 
and From Max values. 

Stepped Linear: 
Stepped linear interpolation between 
From Min and From Max values. 

Smooth Step: Smooth Hermite edge interpolation 
between From Min and From Max 
values. 

Smoother Step: 
Smoother Hermite edge interpolation 
between From Min and From Max 
values. 


Clamp 
If enabled, the output is clamped to the target range. 


Outputs 


Result/Vector 
The input value after remapping. 


Examples 


The Noise Texture node outputs a value in the range [0, 1]. 
We can use the Map Range node to remap this value into 
the range [-1, 1]. 


Fac @ Result @ 


Color @ 
¥ Clamp 


Position Vector From Min 0.000 
@ Scale 5.000 From Max 1.000 
e Detail 2.000 To Min -1.000 
8 Distortion 0.000 To Max 1.000 


Example of Map Range node. 


Math Node 


The Math Node performs math 


operations. 
Value @ 


v 


Clamp 


o Value 0.500 
@ Value 0.500 


Inputs 


The inputs of the node are dynamic. Some inputs are only 
available in certain operations. For instance, the Addend 
input is only available in the Multiply Add operator. 


Value 
Input Value. Trigonometric functions read this value as 
radians. 


Addend 
Input Addend. 


Base 
Input Base. 


Exponent 
Input Exponent. 


Epsilon 
Input Epsilon. 


Distance 
Input Distance. 


Min 
Input Minimum. 


Max 
Input Maximum. 


Increment 
Input Increment. 


Scale 
Input Scale. 


Degrees 
Input Degrees. 


Radians 
Input Radians. 


Properties 


Operation 


The mathematical operator to be applied to the input 


values: 


Functions 
Add: 
Subtract: 


Multiply: 
Divide: 


Multiply Add: 


The sum of the two values. 

The difference between the two 
values. 

The product of the two values. 

The division of the first value by the 
second value. 

The sum of the product of the two 
values with Addend. 


Power: 
Logarithm: 
Square Root: 
Inverse Square 


Absolute: 


Exponent: 


Comparison 
Minimum: 


Maximum: 


Less Than: 


Greater Than: 


Sign: 


Compare: 


The Base raised to the power of 
Exponent. 

The log of the value with a Base as 
its base. 

The square root of the value. 

Root: 

One divided by the square root of 
the value. 

The input value is read without 
regard to its sign. This turns 
negative values into positive values. 
Raises Euler’s number to the power 
of the value. 


Outputs the smallest of the input 
values. 

Outputs the largest of two input 
values. 

Outputs 1.0 if the first value is 
Smaller than the second value. 
Otherwise the output is 0.0. 
Outputs 1.0 if the first value is larger 
than the second value. Otherwise 
the output is 0.0. 

Extracts the sign of the input value. 
All positive numbers will output 1.0. 
All negative numbers will output 
-1.0. And 0.0 will output 0.0. 
Outputs 1.0 if the difference 
between the two input values is less 
than or equal to Epsilon. 


Smooth Minimum: 


Smooth Minimum. 


Smooth Maximum: 


Smooth Maximum. 


Rounding 


Round: 
Floor: 
Ceil: 
Truncate: 
Fraction: 


Modulo: 


Wrap: 


Snap: 


Ping-pong: 


Trigonometric 


Sine: 
Cosine: 
Tangent: 
Arcsine: 
Arccosine: 


Arctangent: 


Arctan2: 


Rounds the input value to the 
nearest integer. 

Rounds the input value down to the 
nearest integer. 

Rounds the input value up to the 
nearest integer. 

Outputs the integer part of the 
value. 

Returns the fractional part of the 
value. 

Outputs the remainder once the first 
value is divided by the second 
value. 

Outputs a value between Min and 
Max based on the absolute 
difference between the input value 
and the nearest integer multiple of 
Max less than the value. 

Rounds the input value down to the 
nearest integer multiple of 
Increment. 

The output value is moved between 
0.0 and the Scale based on the input 
value. 


The Sine of the input value. 

The Cosine of the input value. 

The Tangent of the input value. 
The Arcsine of the input value. 
The Arccosine of the input value. 
The Arctangent of the input value. 
Outputs the Inverse Tangent of the 
first value divided by the second 
value measured in radians. 


Hyperbolic Sine: 
The Hyperbolic Sine of the input 
value. 

Hyperbolic Cosine: 
The Hyperbolic Cosine of the input 
value. 

Hyperbolic Tangent: 
The Hyperbolic Tangent of the input 


value. 
Conversion 
To Radians: Converts the input from degrees to 
radians. 
To Degrees: Converts the input from radians to 
degrees. 
Clamp 


Limits the output to the range (0.0 to 1.0). See Clamp. 


Outputs 


Value 
Numerical value output. 


Examples 


Manual Z-Mask 


Minimum and maximum function example. 


This example has one scene input by the top Render Layers 
node, which has a cube that is about 10 units from the 
camera. The bottom Render Layers node inputs a scene 
with a plane that covers the left half of the view and is 7 
units from the camera. Both are fed through their respective 
Map Value nodes to divide the Z-buffer by 20 (multiply by 
0.05, as shown in the Size field) and clamped to be a 
min/max of 0.0/1.0 respectively. 


For the minimum function, the node selects those Z values 
where the corresponding pixel is closer to the camera; so it 
chooses the Z values for the plane and part of the cube. The 
background has an infinite Z value, so it is clamped to 1.0 
(shown as white). In the maximum example, the Z values of 
the cube are greater than the plane, so they are chosen for 


the left side, but the plane Render Layers Z are infinite 
(mapped to 1.0) for the right side, so they are chosen. 


Using Sine Function to Pulsate 


Using sine function example. 


This example has a Time node putting out a linear sequence 
from O to 1 over the course of 101 frames. At frame 25, the 
output value is 0.25. That value is multiplied by 2 x pi 
(6.28) and converted to 1.0 by the Sine function, since \ 
(sin(2 x pi/ 4) = sin(pi/ 2) = +1.0\). 


Since the sine function can put out values between (-1.0 to 
1.0), the Map Value node scales that to 0.0 to 1.0 by taking 
the input (-1 to 1), adding 1 (making O to 2), and multiplying 
the result by one-half (thus scaling the output between 0 to 
1). The default Color Ramp converts those values to a gray- 
scale. Thus, medium gray corresponds to a 0.0 output by 
the sine, black to -1.0, and white to 1.0. As you can see, \ 
(sin(pi/ 2) = 1.0\). Like having your own visual color 
calculator! Animating this node setup provides a smooth 
cyclic sequence through the range of grays. 


Use this function to vary, for example, the alpha channel of 
an image to produce a fading in/out effect. Alter the Z 
channel to move a scene in/out of focus. Alter a color 
channel value to make a color “pulse”. 


Brightening (Scaling) a Channel 


Scaling a channel example. 


This example has a Math (Multiply) node increasing the 
luminance channel (Y) of the image to make it brighter. Note 
that you should use a Map Value node with min() and max() 
enabled to clamp the output to valid values. With this 
approach, you could use a logarithmic function to make a 
high dynamic range image. For this particular example, 
there is also a Bright/Contrast node that might give simpler 
control over brightness. 


Restrict Color Selection (Posterization) 


Posterization example. 


In this example, we restrict the color values to be one of the 
six values: 0, 0.2, 0.4, 0.6, 0.8, 1. 


To split up a continuous range of values between 0 and 1 to 
certain set of values, the following function is used: \ 
(round(x x n- 0.5) / (n- 1)\), where “n” is the number of 
possible output values, and “x” is the input pixel color. Read 
more about this function. 


To implement this function in Blender, consider the node 
setup above. We string the Math nodes into a function that 
takes each color (values from 0 to 1), multiplies it up by six, 
the desired number of divisions (values become from 0 to 
6), offsets it by 0.5 (-0.5 to 5.5), rounds the value to the 
nearest whole number (produces O, 1, 2, 3, 4, 5), and then 
divides the image pixel color by five (0.0, 0.2, 0.4, 0.6, 0.8, 
1.0). 


In the case of a color image, you need to split it into 
separate RGB channels using Separate/Combine RGBA 
nodes and perform this operation on each channel 
independently. 


Mix Node 


The Mix Node mixes values, colors and vectors inputs using 
a factor to control the amount of interpolation. The Color 
mode has additional blending modes. 


Result @ Result @ 


Float Vector 


Y Clamp Factor Uniform 
Y Clamp Factor Clamp Result 
Y Clamp Factor 


Factor 1.000 


Important 


This is a new node as of Blender 3.4. The previous Mix RGB 
node is automatically converted to the Color version of this 
node in Shader and Geometry node editors. Files saved 
with the new node are not forward compatible. 


Inputs 


Factor 
Controls the amount of mixing between the A and B 
inputs. 


A/B 
The two inputs that are mixed together. 


Properties 


Data Type 
The data type that is used for mixing. The node supports 
float, vector and color data types. 


Factor Mode (Vector only) 
The factor mode can be set to Uniform and Non-Uniform. 
In uniform mode, a single float controls the factor. In non- 
uniform mode, a vector controls the factor for each XYZ 
channel separately. 


Mix (Color only) 
The Blend modes can be selected in the select menu. 
See Color Blend Modes for details on each blending 
mode. 


Add, Subtract, Multiply, Screen, Divide, Difference, 
Darken, Lighten, Overlay, Color Dodge, Color Burn, Hue, 
Saturation, Value, Color, Soft Light, Linear Light 


Clamp Factor 
Limit the factor value between 0.0 and 1.0. If this option 
is unchecked then the node operates using Extrapolation. 


Clamp Result (Color only) 
Limit the Result to the range between 0.0 and 1.0. 


Outputs 


Result 
Output the result of the mix using the data type selected. 


Examples 


See the Color > Mix page for additional examples: Mix Color 
Node 


Random Value Node 


The Random Value node outputs a 
white noise like value as a Float, 
Integer, Vector, or Boolean field. oh Ng 


Y Random Value 


Inputs 


Min 
The minimum value of the range where random values 
are sampled from. This input is only available for Float, 
Integer, and Vector types. 


Max 
The maximum value of the range where random values 
are sampled from. This input is only available for Float, 
Integer, and Vector types. 


Probability 
The probability ratio for the random Boolean output to be 
True. This input is only available for Boolean types. 


ID 


An ID to drive the random number generator seed. By 
default, this input uses the same value as of the ID Node, 


which is the id attribute of the context geometry if it 
exists, and otherwise the index. 


Tip 
Single Random Value 


By default, the random value node generates a value 
for each unique index. If a single random value is 


desired, connect a single value (Such as an Integer 
Node ) to the ID input. 


Seed 


A field to Seed the random number generator. This can 
be used to generate a different set of random values, 
even for two nodes with the same /D input. 


Properties 

Data Type 
Float: The output will be a Float field. 
Integer: The output will be an Integer field. 
Vector: The output will be a Vector field. 
Boolean: The output will be a Boolean field. 


Outputs 


Value 


Random values as a field. 


Rotate Euler Node 


The Rotate Euler node rotates an Euler 
rotation. 


Y Rotate Euler 


Rotation 


Axis Angle _ Euler 


Object | eler=) 


Rotation 


Rotate By: 


Inputs 


Rotation 
The Euler rotation to rotate. 


Rotate By 
Specifies how much an Euler rotation is rotated. This 
input is only available when the rotation type is set to 
Euler. 


Axis 
The axis to rotate around. This input is only available 
when the rotation type is set to Axis Angle. 


Angle 
The angle to rotate by around the specified axis. This 
input is only available when the rotation type is set to 
Axis Angle. 


Properties 


Rotation Type 


Axis Angle: Use separate axis and angle inputs to 
control the rotation. 
Euler: Use an Euler input to control the 
rotation. 
Space 
Object: Rotate an Euler rotation in the 
evaluated object’s space. 
Local: Rotate an Euler rotation in local space. 
Outputs 
Rotation 


The rotated Euler rotation. 


Switch Node 


The Switch node outputs one of two 
inputs depending on a condition. Only 
the input that is passed through the 
node is computed. Geometry 7 


Y Switch 


Output 


@ Switch 
False 


True 


Inputs 


Switch 
Determines which of the two inputs below will be passed 
through. 


False 
Is passed through when the switch is set to false. 


True 
Is passed through when the switch is set to true. 


Properties 


Type 
Determines the type of the data that is handled by the 
node. 


Outputs 


Output 
One of the two inputs without any modifications. 


Vector Nodes 


Nodes for modifying vector quantities. 


Combine XYZ Node 
Separate XYZ Node 
Vector Curves Node 
Vector Math Node 

Vector Rotate Node 


Combine XYZ Node 


The Combine XYZ Node combines a 

vector from its individual 

components. ca 
0.000 


Y Combine XYZ 


0.000 
0.000 


Inputs 


eee 
N ~< xX 


Properties 


This node has no properties. 


Output 


Vector 
Standard vector output. 


Note 


The vector is not normalized. 


Separate XYZ Node 


The Separate XYZ Node splits a 
vector into its individual components. 


v Separate XYZ 


Vector: 
0.000 
0.000 
0.000 


Input 


Vector 
Standard vector input. 


Properties 


This node has no properties. 


Outputs 


eee 
N ~< &X 


Vector Curves Node 


The Vector Curves node maps 
an input vector components to 
a Curve. Vector 


Y Vector Curves 


Use this curve node to slow 
things down or speed them up 
from the original scene. 


Vector: 


Inputs 


In the shader context the node also has an additional Factor 
property. 


Factor 
Controls the amount of influence the node exerts on the 
output vector. 


Vector 
Standard vector input. 


Properties 


Channel 
xX, Y,Z 


Curve 
For the curve controls see: Curve widget. 


Outputs 


Vector 
Standard vector output. 


Vector Math Node 


The Vector Math node performs the 
selected math operation on the input 
vectors. 


Inputs 


The inputs of the node are dynamic. Some inputs are only 
available in certain operations. For instance, the Scale input 
is only available in the Scale operator. 


Vector 
Input vector \(A = \begin{pmatrix} A x\\A y\\A z 
\end{pmatrix}\). 


Vector 
Input vector \(B = \begin{pmatrix} B x \\B_ y\\B z 
\end{pmatrix}\). 


Scale 
Input Scale \(s\). 


Properties 


Operation 


The vector math operator to be applied on the input 


vectors. 


Add: 


Subtract: 


Multiply: 


Divide: 


Multiply Add: 


Cross Product: 


Project: 
Reflect: 


Refract: 


The sum of A and B. \(\begin{pmatrix} 
AX+Bx\AYtBy\N\AZ+B2Z 
\end{pmatrix}\) 

The difference between A and B. \ 
(\oegin{pmatrix} Ax-B x\\Ay-By 
\\A_z - B_z \end{pmatrix}\) 

The entrywise product of A and B. \ 
(\oegin{pmatrix} A_x \cdot B_ x \\A_y 
\cdot B y \\A z \cdot B z 
\end{pmatrix}\) 

The entrywise division of A by B. 
Division by zero results in zero. \ 
(\oegin{pmatrix} Ax/B x\\A y/B_y 
\\A_z/B_z \end{pmatrix}\) 

The entrywise combination of the 
multiply and addition operations. \(A * 
B + C\) 

The cross product of A and B. \ 
(\oegin{pmatrix} A_y \cdot B_z-Az 
\cdot B_y \\A z \cdot B _x - A x \cdot 

B z\\A_x\cdot B y-A y \cdot B x 
\end{pmatrix}\) 

The projection of A onto B. 

The reflection of A around the normal 
B. B need not be normalized. 

For a given incident vector A, surface 
normal B and ratio of indices of 
refraction (IOR), refract outputs the 
refraction vector R. 


Faceforward: 


Dot Product: 


Distance: 
Length: 


Scale: 


Normalize: 


Wrap: 


Snap: 


Floor: 
Ceil: 


Modulo: 
Fraction: 


Absolute: 
Minimum: 


Maximum: 


Orients a vector A to point away from a 
surface B as defined by its normal C. 
Computes \((dot(B, C) < 0) ? A: -A\). 
The dot product of A and B. \(A_x \cdot 
Bx+A y\cdot B y +A z\cdot B Z\) 
The distance between A and B. 

The length of A. \(\sqrt{A_x*2 + A _y*2 
+ A 2*2}\) 

The result of multiplying A by the scalar 
input Scale. \(\begin{ pmatrix} s \cdot 
A x\\s\cdotA y \\s \cdot A z 
\end{pmatrix}\) 

The result of normalizing A. The result 
vector points to the same direction as 
A and has a length of 1. If A is (0, 0, 0), 
the result is (0, 0, 0) as well. 

The entrywise output of a value 
between Min and Max based on the 
absolute difference between the input 
value and the nearest integer multiple 
of Max less than the value. 

The result of rounding A to the largest 
integer multiple of B less than or equal 
A. 

Rounds the input value entrywise down 
to the nearest integer. 

Rounds the input value entrywise up to 
the nearest integer. 

The entrywise modulo of A by B. 
Returns the fractional part of the va/ue 
entrywise. 

The entrywise absolute value of A. 

The entrywise minimum value from A 
and B. 

The entrywise maximum value from A 
and B. 


Sine: The entrywise Sine of A. 


Cosine: The entrywise Cosine of A. 
Tangent: The entrywise Tangent of A. 
Outputs 


The output of the node is dynamic. It is either a vector ora 
scalar depending on the operator. For instance, the Length 
operator has a scalar output while the Add operator has a 
vector output. 


Vector 
Output vector. 


Value 
Output value. 


Vector Rotate Node 


Y Vector Rotate 


Vector 


Type: Axis Angle v 


Invert 
Vector 


Center: 


The Vector Rotate Node provides the ability to rotate a 
vector around a pivot point (Center). 


Inputs 


Vector 
Vector to be rotated. 


Center 
Point to rotate around. 


Axis 
Axis to rotate around. 


Angle 
Angle to rotate the input vector by. 


Rotation 
When Type is set to Euler, rotate the input vector by 
these angles around the X, Y, then Z axes in that order. 


Properties 


Type 
The type of angle input. 


X/Y/Z Axis: Rotates the vector around the defined 
axis and the amount of rotation is 
defined by the Angle input. 

Axis Angle: Rotates the vector around an arbitrary 
axis defined by the Axis input vector. 
The amount of rotation is defined by 
the Angle input. 

Euler: Rotates the vector about a center point 
defined by the Center input vector. The 
amount of rotation on each axis is 
defined by the Rotation input vector. 


Invert 
Inverts the rotation angle. 


Outputs 


Vector 
The rotated vector. 


Examples 


vy Vector Rotate vy Vector Rotate vy Vector Rotate 


Vector Vector Vector 


Type: Axis Angle + Type: Z Axis Type: XYZ Euler 


Vector Vector Vector 

Center: Center: Center: 
0.000 0.000 0.000 
0.000 0.000 0.000 
0.000 0.000 0.000 

@ Angle : Rotation: 
0.000 X 
1.000 Y 
0.000 Z 
@ Angle 


Vector Rotate node example. 


Volume Nodes 


Nodes for creating or working with volumes. 


e Volume Cube Node 
e Volume to Mesh Node 


Volume Cube Node 


The Volume Cube generates a 
volume from scratch by evaluating 
an input field on every single voxel in la 
a rectangular prism. The Density © Density 1.000 
field defines the output volume @ Background 0.000 
grid’s value at every voxel. The field 
can only depend on the Position 
Node. 


Yv Volume Cube 


Min: 
-1.000 
-1.000 
-1.000 


1.000 
1.000 
1.000 


Resolution X 


Resolution Y 


Resolution Z 


Inputs 


Density 
The value for the new grid at each voxel. 


Background 
The value of the grid outside the rectangular prism 
controlled by the Min and Max inputs. The node can 
generate a more memory-efficient volume when the 
values of the Density input are the same as the 
background value. 


Min 
One corner of the rectangular prism in which to fill 
evaluate the field. 


Max 
The other corner of the rectangular prism in which to fill 
evaluate the field. 


Resolution X,Y,Z 
The number of voxels to evaluate the field in on each 
axis. 


Note 


Changing these values can have a significant impact on 
performance. For example, the default values of 32 
mean the input field will be evaluated about 33 
thousand times. Increasing the values to 100 will give 1 
million evaluations, and 1000 would give 1 billion. 


Properties 


This node has no properties. 


Outputs 


Volume 
Geometry containing the generated volume. 


Volume to Mesh Node 


Y Volume to Mesh 


Resolution Grid 


Volume 


® Threshold 


& Adaptivity 


The Volume to Mesh node generates a mesh on the 
“surface” of a volume. The surface is defined by a threshold 
value. All voxels with a larger value than the threshold are 
considered to be inside. 


Inputs 


Volume 
Standard geometry input. 


Voxel Amount 
Specifies the approximate resolution of the final mesh. 
The voxel size is adapted to the size of the entire volume. 


Voxel Size 
Use a fixed resolution that does not change when the 
volume changes. 


Threshold 
Voxels with a larger value are considered to be inside the 
mesh. The mesh will be generated on the boundary of 


inside and outside voxels. This is also called “iso value”. 


Adaptivity 
Reduces the final face count by simplifying geometry 
where detail is not needed. This is similar to decimating 
the final to reduce resolution where it is not needed. 


Properties 


Resolution Mode 


Mode for how the resolution of the final mesh is 
controlled. 


Grid: This makes the resolution dependent 
on the resolution of the grid that is 
converted. Higher resolution grids 
result in a higher resolution mesh. In 
many cases, that is the most efficient 
mode. 

Voxel Amount: Specifies the approximate resolution of 
the final mesh. The voxel size is 
adapted to the size of the entire 
volume. 

Voxel Size: Use a fixed resolution that does not 
change when the volume changes. 


Note 


This option applies individually for every grid in the 
input geometry. 


Outputs 


Mesh 


Standard geometry output. 


UV Nodes 


Nodes for creating or modifying UV Maps. 


e Pack UV Islands Node 
e UV Unwrap Node 


Pack UV Islands Node 


The Pack UV Islands Node scales 
islands of a UV map and moves them 
so they fill the UV space as much as 
possible. wd 


Y Pack UV Islands 


© Selection 
See also 8 Margin 0.001 


@ Y Rotate 


The Pack Islands operator performs a 
similar operation in the UV editor. 


Inputs 
UV 
The UV map to modify. 


Selection 


Faces to consider when packing islands. UVs that are part 
of any other face will not be affected. 


Margin 
The distance to leave between UV islands. 


Rotate 
Allow Rotating islands for best fit. 


Properties 


This node has no properties. 


Output 


UV 
The modified UVs. 


UV Unwrap Node 


The UV Unwrap Node generates a UV 
map islands based on a selection of 
seam edges. The node implicitly 
performs a Pack Islands operation Angle Based 
upon completion, because the results 
may not be generally useful otherwise. 


v UV Unwrap 


© Selection 


© Seam 


i) Margin 0.001 


See also . 
@ ¥ Fill Holes 


The Unwrap operator performs a 
Similar operation in the UV editor. 
Unlike the Unwrap operator, the node doesn’t perform 
aspect ratio correction, because it is trivial to implement 
with a Vector Math Node. 


Inputs 


Selection 
Faces to participate in the unwrap operation. UVs that 
are part of any other face will not be affected. 


Seam 
Edges to mark where the mesh is “cut” for the purposes 
of unwrapping. 


Margin 
The distance to leave between UV islands. 


Fill Holes 


Virtually fill holes in mesh before unwrapping, to better 
avoid overlaps and preserve symmetry. 


Properties 


Method 

Angle Based: — This method gives a good 2D 
representation of a mesh 

Conformal: Uses LSCM (Least Squares Conformal 
Mapping). This usually gives a less 
accurate UV mapping than Angle 
Based, but works better for simpler 
objects 


Output 


UV 
The generated UV coordinates between 0 and 1 for each 
face corner in the selected faces. 


Group 


Group Nodes are a collection of nodes that can be combined 
into a single node while selectively exposing inputs of the 
embedded nodes. Group nodes can simplify a node tree by 
allowing instancing and hiding parts of the tree. 


Make Group 


Creates a node group from the selected nodes, see Make 
Group for more information. 


Ungroup 


Removes the selected nodes from a group, see Ungroup for 
more information. 


Group Input 


Adds a group input node, this serves as a convenient way to 
re-add the input node in case it is accidentally deleted. 
Note, groups can only have one input, if more than one is 
added they are duplicates of each other. 


Group Output 


Adds a group output node, this serves as a convenient way 
to re-add the output node in case it is accidentally deleted. 
Note, groups can only have one output, if more than one is 
added they are duplicates of each other. 


Node Groups 


This section lists all the node groups either from the current 
blend-file or Linked or Appended from another blend-file. 


Sculpting & Painting 


e Introduction 
e Brush 

o Introduction 

o Brush Settings 
e Navigation 


Modes 


Tool Settings 
Controls 
Adaptive Sculpting 
o Editing 
e Texture Paint 
o Introduction 
o Jexture Paint Tools 
o Tool Settings 
Vertex Paint 
o Introduction 
o Vertex Paint Tools 
o Tool Settings 
o Editing 
Weight Paint 
o Introduction 
Weight Paint Tools 
Tool Settings 
Using Vertex Groups 
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o Editing 
e Curves Sculpting 
o Introduction 
o Tools 
o Common Settings 


Introduction 


Sculpting and painting use brushes to paint directly on 
meshes. There are several modes that use this. 


Sculpting: Change the topology of the mesh. 

Vertex Paint: Change the color of vertices in the active 

Color Attribute. 

e Weight Paint: Change the weight of vertices in the active 
vertex group. 

e Texture Paint: Change the pixels of the active image 

texture. 


Brush 


e Introduction 
o Brush Control 
o Selection Masking 


Brush Settings 


Brushes 
Texture 
Texture Mask 
Stroke 

Falloff 

Cursor 


Introduction 


Brush cursor. 


Brush Control 


e Set brush size F 

e Set brush strength Shift-F 
e Rotate brush texture Ctrl-F 
e Invert stroke toggle ctrl 


You can then either adjust the value interactively or by 
typing in numbers. After pressing the hotkey move the 
mouse to increase/reduce the value (additionally with 
precision and/or snapping activated). Finally confirm (LB, 
Return) Or Cancel (RMB, Esc). 


Selection Masking 


If you have a complex mesh, it is sometimes not easy to 
paint on all vertices. Suppose you only want to paint ona 
Small area of the Mesh and keep the rest untouched. This is 
where “selection masking” comes into play. When this mode 


is enabled, a brush will only paint on the selected vertices or 
faces. The option is available from the header of the 3D 
Viewport (see icons surrounded by the yellow frame): 


Weight Paint » |g)" )| View Weights Brush 
o 


You can choose between Face Selection masking 
(left button) and Vertex selection masking (right 
button). 


Selection masking has some advantages over the default 
paint mode: 


e The original mesh edges are shown, even when 
modifiers are active. 

e You can select faces to restrict painting to the vertices 
of the selected faces. 


Details About Selecting 


The following standard selection operations are supported: 


e RMB - Single faces. Use Shift-RMB to select multiple. 
A - All faces, also to deselect. 

B - Box selection. 

c - Circle select with brush. 

L - Pick linked (under the mouse cursor). 

Ctri-L - Select linked. 

Ctrl-1I - Invert selection /nverse. 


Vertex Selection Masking 


Reference 


Mode: Vertex and Weight Paint Modes 


Header: Vertex Selection 
Shortcut: V 


In this mode you can select one or more vertices and then 
paint only on the selection. All unselected vertices are 
protected from unintentional changes. 


Vertex Selection masking. 


Face Selection Masking 


Reference 
Mode: Texture, Vertex, and Weight Paint Modes 
Header: Paint Mask 


The Face Selection masking allows you to select faces and 
limit the paint tool to those faces, very similar to Vertex 
selection masking. 


Face Selection masking. 


Hide/Unhide Faces 


Hidden faces. 


You also can hide selected faces as in Edit Mode with the 
keyboard Shortcut H, then paint on the remaining visible 
faces and finally unhide the hidden faces again by using Alt- 
H. 


Hide/Unhide Vertices 


You cannot directly hide selected faces in vertex mask 
selection mode. However, you can use a trick: 


1. First go to Face selection mask mode. 

2. Select the areas you want to hide and then hide the 
faces (as explained above). 

3. Switch back to Vertex Selection mask mode. 


Now the vertices belonging to the hidden Faces will remain 
hidden. 


The Clipping Region 


To constrain the paint area further you can use the Clipping 
Region. Press Alt-B and LMB-drag a rectangular area. The 
selected area will be “cut out” as the area of interest. The 
rest of the 3D Viewport gets hidden. 


The Clipping Region is used to select interesting 
parts for local painting. 


You make the entire mesh visible again by pressing Alt-Ba 
second time. 


All paint tools that use the view respect this clipping, 
including box select, and of course brush strokes. 


Brushes 


Reference 
Mode: Sculpt Mode 
Panel: Sidebar > Tools >» Brushes 


For painting/sculpting modes each brush type is exposed as 
a tool, the brush can be changed from the tool setting. 


Brushes 
The Data-Block Menu 
to select a preset 
brush type ora * Brush 
custom brush. They 
are a combination of 
a “tool”, along with 
stroke, texture, and 
options. 


SculptDraw 


Add Brush 
When you adda 
brush, the new 
brush is a clone of 
the current one. 


Brush data-block menu. 


Brush Specials 


Enabled Modes 
Todo. 


Tool Selection 
Todo. 


Reset Brush 


Todo. 


Custom Icon 
Allows definition of a custom brush icon. 


Note 


In order to save a custom brush in a blend-user, enable 
Fake User. 


Texture 


Y Texture 


Texture 


Mapping 


Angle 
Offset X 


Texture options and example. 


Use the texture data-block at the bottom of the paint panel 
to select a preloaded image or procedural texture to use as 
your brush pattern. 


Note that in order to use it, you must have a placeholder 
material defined, and that particular texture defined using 
the Material and Texture buttons. It is not necessary to have 
that material or texture applied to any mesh anywhere; it 
must only be defined. 


The example to the right shows the effects of painting with 
a Voronoi texture. 


Texture 


In paint modes the texture is used as a color source, 
while for sculpting it is used to determine the strength of 


the brush. 


Mapping 


Sets the way the texture is applied to the brush stroke. 


View Plane: 


Area Plane: 


Tiled: 


3D: 


Random: 


Stencil: 


If View Plane is enabled, the current 
view angle is used to project the brush 
texture onto the model. |.e. the texture 
follows the mouse, so it appears that 
the texture is being dragged across the 
model. In 2D painting, the texture 
moves with the brush. 


Projects the brush texture along the 
local surface normal, which keeps the 
texture from stretching when sculpting 
on a portion of the mesh that is at an 
extreme angle to the viewpoint. 


The Tile option tiles the texture across 
the screen, So moving the brush 
appears to move separately from the 
texture. The Tile option is most useful 
with tileable images, rather than 
procedural textures. 


The 3D option allows the brush to take 
full advantage of procedural textures. 
This mode uses vertex coordinates 
rather than the brush location to 
determine what area of the texture to 
use. 


Picks a random texture coordinate to 
Sample from for each dab. 


Stencil mapping works by projecting 
the paint from the camera space on the 
mesh or canvas. Painting is applied 
only inside the boundaries of the 
stencil. The stencil is displayed as a 
screen space overlay on the viewport. 
To the transform the stencil texture and 
the stencil mask with additional Att 
pressed: 
e Move RMB 
e Scale Shift -RMB 
e Rotate Ctr1l-RMB 
When using stencil scaling, xX and Y are 
used to constrain the scaling to one 
axis. Pressing one of the buttons twice 
reverts to unconstrained scaling. 
Image Aspect 
Restore the aspect ratio of the 
Original image to reset stretching 
introduce by scaling, (Image 
textures only.) This operator can use 
the tiling and scale values of the 
brush texture if the relevant are 
enabled in Adjust Last Operation 
panel. 


Reset Transform 
Restores the position of the stencil. 


Angle Ctrt-F 
This is the rotation angle of the texture brush. It can be 
changed interactively via Ctri-F in the 3D Viewport. While 
in the interactive rotation you can enter a value 
numerically as well. 


Rake R 


Angle follows the direction of the brush stroke. Not 
available with 3D textures. (Shortcut sculpting only.) 


Random R 
Angle is randomized per dab. 


Random Angle 
Constraints the random deviation to a range. 


Offset X, Y, Z 
Offset the texture map placement in X, Y, and Z axes. 


Size X, Y, Z 
Set the scale of the texture in each axis. Not available for 
Drag sculpting textures. 


Sample Bias Sculpt Mode 
Value added to texture samples. 


Texture Mask 


With a Texture Mask the brush strength is masked by a 


texture. 


Texture 


In paint modes the texture is used as a color source, 
while for sculpting it is used to determine the strength of 


the brush. 


Mask Mapping 


Sets the way the texture is applied to the brush stroke. 


View Plane: 


Tiled: 


Random: 


Stencil: 


If View Plane is enabled, the current 
view angle is used to project the brush 
texture onto the model. |.e. the texture 
follows the mouse, so it appears that 
the texture is being dragged across the 
model. In 2D painting, the texture 
moves with the brush. 


The Tile option tiles the texture across 
the screen, So moving the brush 
appears to move separately from the 
texture. The Tile option is most useful 
with tileable images, rather than 
procedural textures. 


Picks a random texture coordinate to 
Sample from for each dab. 


Stencil mapping works by projecting 
the paint from the camera space on the 
mesh or canvas. Painting is applied 
only inside the boundaries of the 
stencil. The stencil is displayed as a 
screen space overlay on the viewport. 
To the transform the stencil texture and 
the stencil mask with additional Alt 
pressed: 
e Move RMB 
e Scale Shift -RMB 
e Rotate Ctr1l-RMB 
When using stencil scaling, xX and Y are 
used to constrain the scaling to one 
axis. Pressing one of the buttons twice 
reverts to unconstrained scaling. 
Image Aspect 
Restore the aspect ratio of the 
Original image to reset stretching 
introduce by scaling, (Image 
textures only.) This operator can use 
the tiling and scale values of the 
brush texture if the relevant are 
enabled in Adjust Last Operation 
panel. 
Reset Transform 
Restores the position of the stencil. 


Pressure Masking 
A mask cut-off function. It allows to clip the mask result 
based on pressure, creating areas of no paint when low 
pressure is applied to the brush, similar to how a real 
brush would behave. 


Off: Deactivated. 
Ramp: 


Distributes the mask effect above the 
pressure value. 

Cutoff: Simply selects between zero and one 
based on stylus pressure. 


Angle 
This is the rotation angle of the texture brush. 


Rake 
Angle follows the direction of the brush stroke. 


Random 
Angle is randomized per dab. 


Random Angle 
Constraints the random deviation to a range. 


Offset X, Y, Z 
Offset the texture map placement in X, Y, and Z axes. 


Size X, Y, Z 
Set the scale of the texture in each axis. Not available for 
Drag sculpting textures. 


Stroke 


Stroke Method £ 
Defines the way brush 
strokes are applied to 


¥ Stroke 


Stroke Method Space 


Spacing 10% 


the canvas. Jitter 0.0000 
Input Samples 1 
Dots: 
Smooth Stroke 
Stroke panel. 

Apply paint on each mouse move step. 
Drag Dot: Leaves only one dab on the canvas 

which can be placed by dragging. 
Space: Creates brush stroke as a series of 


dots, whose distance (Spacing) is 
determined by the Spacing setting. 
Spacing 
Limits brush application to the 
distance specified by the 
percentage of the brush radius. 


Airbrush: 


Anchored: 


Line: 


Curve: 


Flow of the brush continues as long as 
the mouse click is held (spray), 
determined by the Rate setting. With 
other methods the brush only modifies 
the color when the brush changes its 
location. This option is not available for 
the Grab sculpting brush. 
Rate 

Interval between paints for airbrush. 


Creates a single dab at the brush 
location. Clicking and dragging will 
resize the dab diameter. 
Edge to Edge 
The brush location and orientation 
are determined by a two point circle, 
where the first click is one point, and 
dragging places the second point, 
opposite from the first. 


Clicking and dragging lets you define a 
line in screen space. The line dabs are 
separated by Spacing, similar to space 
strokes. With ait the line stroke is 
constrained to 45 degree increments. 


Defines the stroke curve with a Bézier 
curve (dabs are separated according to 
Spacing). This Bézier curve is stored in 
Blender as a “Paint Curve” data-block. 
Use Ctri-RMB to create the initial control 
point of the curve. 
Paint Curves 
Paint Curves are reusable and can 
be stored and selected by using the 
Data-Block Menu menu. 


e Add Points: Use cCtri-RMmB to 
create the initial control point of 
the curve. You can define 
additional curve control points by 
using Ctrl-RMB. The handles can be 
defined by dragging the mouse. 
The stroke flows in the direction of 
the first control point to the 
second control point. If another 
control point is added after the 
second control point, instead of 
extending it from the first control 
point in a different direction, it will 
become the initial control point, 
and thus the stroke still flows in 
the direction of the first to the 
second. 

Transforming Points: The 
control points and handles can be 
dragged with LmMB. To make sure 
that the handles of a control point 
are symmetrical, drag them using 
Shift-RMB. A few transform 
operators are supported such as 
moving, scaling and rotating. 
Selection: The handles can be 
selected individually by using RMB, 
extend the selection by Shift-RMB 
and deselect/select all by using A. 
Delete Points :kbd: X°: To 
delete a curve point, use x. 


Draw Curve Return 
To confirm and execute the curved 
stroke, press Return or use the Draw 
Curve button. 


Spacing Distance Sculpt Mode Only 
Method used to calculate the distance to generate a new 
brush step. 


View: Calculates the brush spacing relative to 
the view. 
Scene: Calculates the brush spacing relative to 


the scene using the stroke location. 
This avoids artifacts when sculpting 
across curved surfaces. 


Adjust Strength for Spacing 
Attenuate the brush strength according to spacing. 
Available for the Space, Line, and Curve stroke methods. 


Dash Ratio 
Ratio of samples in a cycle that the brush is enabled. This 
is useful to create dashed lines in texture paint or 
stitches in Sculpt Mode. Available for the Space, Line, and 
Curve stroke methods. 


Dash Length 
Length of a dash cycle measured in stroke samples. This 
is useful to create dashed lines in texture paint or 
stitches in Sculpt Mode. Available for the Space, Line, and 
Curve stroke methods. 


Jitter 
Jitter the position of the brush while painting. 


Jitter Pressure 
Brush Jitter can be affected by enabling the pressure 
sensitivity icon, if you are using a Graphics Tablet. 


Jitter Unit 
Controls how the brush Jitter is measured. 


View: The Jitter is measured based on how 
the cursor appears on the monitor i.e. 
“screen space”. 

Scene: The Jitter is measured based on real 
world units. The unit type and scaling 
can be configured in the Scene Units. 


Input Samples 
Recent mouse locations (input samples) are averaged 
together to smooth brush strokes. 


Stabilize Stroke 


Stabilize Stroke makes the stroke lag behind the cursor and 
applies a smoothed curve to the path of the cursor. This can 
be enabled temporary by holding shift while painting or 
permanently by clicking the checkbox found in the header. 


Radius 
Minimum distance from the last point before the stroke 
continues. 


Factor 
A smooth factor, where higher values result in smoother 
strokes but the drawing sensation feels like as if you 
were pulling the stroke. 


Falloff 


The Falloff allows you to control the Strength falloff of the brush. The 
falloff is mapped from the center of the brush (left part of the curve) 
towards its borders (right part of the curve). Changing the shape of the 
curve will make the brush softer or harder. Read more about using the 
Curve Widget. 


x 0.67708 Y 0.58750 
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Frontface Falloff 


Brush curve example. 


Curve Preset 
Custom: You can choose how the strength of the falloff is 
determined from the center of the brush to the 
borders by manually manipulating the control points 
within the curve widget. There are also a couple of 
preset custom curves displayed at the bottom of the 
curve widget that can be used on their own or as a 
starting point for tweaking. 
Custom Preset types. 


Smooth. Sphere. 


Smooth: 


Smoother: 


Sphere: 


Root: 


Sharp: 


Linear: 


Sharper: 
Inverse Square: 


Constant: 


Sharp. Pingel Constant. 


The center strength, the border strength, and the 
falloff transition between them are evenly 
distributed. 


Similar to Smooth but produces a wider center point 
of the brush before tapering off. 


The strength of the brush is predominately at its 
strongest point with a steep falloff near the border 
of the brush. 


Similar to a Sphere but the center is a more 
concentrated point. 


The center of the brush is the strongest point then 
exponentially tapers off to a lower strength, creating 
a fine point. 


With the center being the strongest, the strength 
will consistently weaken as it reaches the border of 
the brush. 


Similar to Sharp but the center point is more 
condensed. 


A hybrid between Smooth and Sphere. 


The strength of the brush remains unified across the 
entire brush. This will create a sharp edge at the 
border of the brush. 


he Paint » je vi oR. S 


(From Left to Right) Smooth, Smoother, Sphere, Root, Sharp, 
Linear, Sharper, Inverse square, Constant. 


Falloff Shape 
Use projected or spherical falloff. Note, this is not Supported in Texture 
Paint Mode. 


Sphere: Applies brushes influence in a sphere, outwards 
from the center. 
Projected: This turns the brush influence into a cylinder (the 


depth along the view is ignored) instead of a sphere. 
It can be used along the outline of a mesh to adjust 
its silhouette. 


Normal Falloff 


As faces point away from the view the brush strokes fade away to 
prevent harsh edges. 


Angle 
The angle at which the falloff begins. 


Cursor 


Reference 

Mode: All Paint Modes 

Header: Tool Settings >» Brush Settings » Cursor 
Panel: Sidebar > Tool >» Brush Settings » Cursor 
While painting or > Falloff 


sculpting a special 
cursor is shown to 
display Cursor Color 
information about 
the active brush. 
The cursor is 
shown as a circle 
in the 3D Texture Opacity 
Viewport, the 
radius of the circle 
matches the size 
of the brush. 


Y Y Cursor 


Inverse Color 


Falloff Opacity 


Cursor options. 


The cursor can be disabled by toggling the checkbox in the 
panel’s header. 


Cursor Color 
Set the color of the brush ring while performing an 
add/positive stroke. 


Inverse Color 
In some paint/sculpt modes the brush can be negative 
and subtract information from the paint target; these 
brushes can be given a separate color. 


Opacity Options 
Depending on the paint or sculpt mode different overlays 
are shown within the cursor to give information on how 
the brush is textured. This is most commonly used to 
Show the brush falloff with a gradient from the circle 
center to the perimeter. 


Alpha 
You can change the amount of transparency used 
when showing the texture using the slider. 


Override Overlay (brush icon) 
Allows you to turn off the viewport overlay during 
strokes. 


View (eye icon) 
Toggles whether to show or hide the given brush 
texture overlay. 


Navigation 


Center on Last Stroke NumpadPeriod 
Center the View on the average position of the last 
stroke. 


Orbit Around the Last Stroke 
You can orbit the view around the average position of the 
last stroke, if you enable Orbit Around Selection. 


Sculpting 


e Introduction 


O° 


O° 


The Brush 
Usage 


e Toolbar 
e Tools 


O° 
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Draw 

Draw Sharp 
Clay 

Clay Strips 
Clay Thumb 


scrape 
Multiplane Scrape 
Pinch 

Grab 

Elastic Deform 
Snake Hook 
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Mask 

Draw Face Sets 

Multires Displacement Eraser 
Multires Displacement Smear 
Paint 

Smear 

Box Mask 

Lasso Mask 

Line Mask 

Box Face Set 

Lasso Face Set 

Box Trim 

Lasso Trim 

Line Project 

Mesh Filter 

Cloth Filter 

Color Filter 

Edit Face Set 


Mask by Color 
Transforms 


Tool Settings 


° 


° 


° 
O° 
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Brushes 

Brush Settings 
Dyntopo 
Remesh 
Symmetry 
Options 


Controls 


(eo) 


Auto-Masking 


Adaptive Sculpting 


O° 


oO 


Dynamic Topology 
Multiresolution Modifier 


Editing 


(e) 


(eo) 


(e) 


Sculpt 
Mask 
Face Sets 


Introduction 


Sculpt Mode is similar to Edit Mode in that it is used to alter 
the shape of a model, but Sculpt Mode uses a very different 
workflow: instead of dealing with individual elements 
(vertices, edges, and faces), an area of the model is altered 
using a brush. In other words, instead of selecting a group of 
vertices, Sculpt Mode manipulates geometry in the brush 
region of influence. 


Sculpting Mode Example. 


Sculpt Mode is selected from the mode menu of the 3D 
Viewport header. Once Sculpt Mode is activated, the Toolbar 
of the 3D Viewport will change to Sculpt Mode specific 
panels. A red circle will appear and follow the location of the 
cursor in the 3D Viewport. 


Note 


To have a predictable brush behavior, apply the scale of 
your mesh. 


The Brush 


Sculpt Mode uses a similar brush to the other painting 
modes, but it is slightly more advanced. All the normal 
brush controls still apply, and it functions exactly the same, 
yet the brush for sculpting is displayed in 3D. This means 
that the brush will follow the contours of the mesh and the 
radius is displayed by orienting the brush to match the 
topology Normal. How closely the cursor follows the 
curvature of the mesh can be changed in the Brush 
Settings. 


The brush can also change depending on the currently 
active tool to better display how that tool works. 


Usage 


Limiting Brush Interactions 


While sculpting, areas might be hidden behind parts of the 
mesh or they might be too close to other parts. To work 
through these, it is useful to isolate parts of a mesh to 
sculpt on. This can be done by either completely hiding 
parts of the mesh or by masking areas that can not be 
sculpted on. 


Toolbar 


Draw 
Moves vertices inward or outward based 
on the average normal. 


Draw Sharp 
Moves vertices inward or outward based 
the original coordinates and uses the 
Sharper Falloff. 


Clay 
Similar to the Draw brush, but includes 
settings to adjust the plane on which the 
brush acts. 


Clay Strips 
The same as the Clay brush, but it uses 
a cube to define the brush area of 
influence rather than a sphere. 


Layer 
Moves all vertices to an exact height 
creating a flat layer. 


Inflate 
Displaces the mesh in the direction of 
the vertex normals. 


Blob 
Pushes mesh outward or inward into a 
spherical shape. 


Crease 
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Draw 


Clay 


Clay Strips 


Layer 


Inflate 


Blob 


Crease 


Smooth 


Flatten 


Fill 


Scrape 


Pinch 


Grab 


Snake Hook 


Thumb 


Nudge 


Rotate 


Simplify 


Mask 


Creates sharp indents or ridges by pushing or pulling the 
mesh, while pinching the vertices together. 


Smooth 
Eliminates irregularities in the mesh by averaging the 
positions of the vertices. 


Flatten 
Smooths vertices to a flat plane by finding an average 
height and moves vertices towards that height. 

Fill 


Brings vertices below the brush plane upwards. 


Scrape 
Brings vertices above the plane downwards. 


Multiplane Scrape 
Scrapes the mesh with two angled planes at the same 
time, producing a sharp edge between them. 


Pinch 
Pulls vertices towards the center of the brush. 


Grab 
Selects a group of vertices and pulls them to follow the 
mouse. 


Elastic Deform 


Used to simulate realistic deformations such as grabbing 
or twisting of Elastic objects. 


Snake Hook 
Pulls vertices along with the movement of the brush to 
create long, snake-like forms. 


Thumb 


Flattens the mesh in the brush area, while moving it in 
the direction of the brush stroke. 


Pose 
Poses a model simulating an armature-like deformations. 


Nudge 
Moves vertices in the direction of the brush stroke. 


Rotate 


Rotates vertices within the brush in the direction the 
cursor is moved. 


Slide Relax 


Slides the topology of the mesh in the direction of the 
stroke without changing the geometrical shape of the 
mesh. 


Boundary 
Transforms and deforms the mesh boundaries. 


Cloth 
Simulates cloth that can be sculpted. 


Simplify 
Cleans up geometry by collapsing short edges. 


Mask 


Paints a selection on parts of the mesh to be unaffected 
by other brushes. 


Draw Face Sets 
Paints a new Face Set with each stroke. 


Multires Displacement Eraser 


Deletes displacement information applied ona 
Multiresolution modifier. 


Multires Displacement Smear 
Deforms displacement information applied on a 
Multiresolution modifier. 


Paint 
Paints on the active color attribute. 


Smear 
Smears the colors of the active color attribute. 


Box Trim 
Creates a mask based on box select. 


Lasso Trim 
Creates a mask based on lasso select. 


Line Mask 
Creates a mask based on a line. 


Box Face Set 
Creates a face set based on box select. 


Lasso Face Set 
Creates a face set based on lasso select. 


Box Trim 
Performs a Boolean operation based on box select. 


Lasso Trim 
Performs a Boolean operation based on lasso select. 


Line Project 
Flattens the geometry along a drawn line. 


Mesh Filter 
Applies a deformation to all vertices in the mesh at the 
same time. 


Cloth Filter 
Applies a cloth simulation to all vertices in the mesh at 
the same time. 


Color Filter 
Changes the active color attribute on all vertices in the 
mesh at the same time. 


Edit Face Set 
Modifies the face set under the cursor. 


Mask by Color 
Creates a mask from the color attribute. Click on any 
color on the mesh to create a new mask. 


Move 
Translation tool. 


Rotate 
Rotation tool. 


Scale 
Scale tool. 


Transform 
Tool to adjust the objects translation, rotations and scale. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 
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Draw 


Reference 

Mode: Sculpt Mode 
Tool: Toolbar >» Draw 
Shortcut: X 


Moves vertices inward or outward, based the average 
normal of the vertices contained within the drawn brush 
stroke. 


Draw Sharp 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Draw Sharp 


Similar to the Draw brush however, it deforms the mesh 
from the original coordinates and uses the Sharper Falloff. 
This is useful for creating cloth wrinkles, stylized hair or hard 


Surface edges. 


Clay 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Clay 
Shortcut: C 


Similar to the Draw brush, but includes settings to adjust 
the plane on which the brush acts. It behaves like a 
combination of the Flatten and Draw brushes. 


Clay Strips 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Clay Strips 


Similar to the Clay brush, but it uses a cube to define the 
brush area of influence rather than a sphere. 


Brush Settings 


Tip Roundness 
Factor to control how round the brush is, a value of zero 


will make the brush square. Note, the Brush Falloff is only 
applied to the rounded portions of the brush. 


Clay Thumb 


Reference 


Mode: Sculpt Mode 
Tool: Toolbar >» Clay Thumb 


This brush simulates deforming clay with the finger, 


accumulating material during the stroke. It has a plane that 


tilts during the stroke in the front part of the brush to 
achieve this effect. 


Layer 


Reference 

Mode: Sculpt Mode 
Tool: Toolbar >» Layer 
Shortcut: L 


This brush is similar to Draw, except that the height of the 
displacement layer is capped. This creates the appearance 
of a solid layer being drawn. This brush does not draw on 
top of itself; a brush stroke intersects itself. Releasing the 
mouse button and starting a new stroke will reset the depth 
and paint on top of the previous stroke. 


Brush Settings 


Height 
The amount of displacement for each layer. 


Persistent 
You can keep sculpting on the same layer between 
strokes when this is on. 


Set Persistent Base 
This button resets the base so that you can add another 
layer. 


Inflate 


Reference 

Mode: Sculpt Mode 
Tool: Toolbar > Inflate 
Shortcut: I 


Similar to Draw, except that vertices in /nflate mode are 
displaced in the direction of their own normals. 


Blob 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Blob 


Pushes mesh outward or inward into a spherical shape with 
settings to control the amount of magnification at the edge 


of the sphere. 


Crease 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Crease 
Shortcut: Shift-C 


Creates sharp indents or ridges by pushing or pulling the 
mesh, while pinching the vertices together. 


Smooth 


Reference 

Mode: Sculpt Mode 
Tool: Toolbar » Smooth 
Shortcut: Shift-S 


Eliminates irregularities in the area of the mesh within the 
brush’s influence by smoothing the positions of the vertices. 
The inverse of this tool is to sharpen the details in a mesh 
by applying a Laplacian smooth in the opposite direction. 


Brush Settings 


Direction 
The operation to apply to the mesh. This setting can be 


toggled with ctri while sculpting. 


Smooth 
Smooths the surface of the mesh by decreasing the 


difference between creases and valleys. 


Enhance Details 
Sharpens details on the surface of the mesh by 


intensifying the difference between creases and 
valleys. 


Deformation 
Deformation type that is used in the brush. 


Laplacian 


Smooths the surface and the volume. 


Surface 


Smooths the surface of the mesh, while preserving the 
volume. 


Shape Preservation 
How much of the original shape is preserved when 
smoothing. Increasing the value reduces the effect 
of having multiple iterations on the strength of 
smoothing. 


Per-Vertex Displacement 
How much the position of each individual vertex 
influences the final result. Increasing the value 
reduces the overall strength of smoothing. 


Iterations 
Number of smoothing iterations per brush step. 


Note 


This method works by applying regular smoothing, 
computing the difference between the original 
(blended between start of iteration and fully original 
based on Shape Preservation) and the smoothed 
mesh, smoothing these offsets, pushing vertices 
back using the smoothed offsets, and finally 
blending in the original mesh based on Per-Vertex 
Displacement. 


Flatten 


Reference 

Mode: Sculpt Mode 
Tool: Toolbar > Flatten 
Shortcut: Shift-T 


The Flatten brush determines an “area plane” located by 
default at the average height above/below the vertices 
within the brush area. The vertices are then pulled towards 
this plane. The inverse of the Flatten brush is the Contrast 


brush which pushes vertices up or down away from the 
brush plane. 


Fill 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Fill 


Works like the Flatten brush, but only brings vertices below 
the brush plane upwards. 


Brush Settings 


Area Radius 


Ratio between the brush radius and the radius that is 
going to be used to sample the area center. 


Use Pressure (pressure sensitivity icon) 
Uses stylus pressure to control how strong the effect 
is. The gradient of the pressure can be customized 
using the curve widget. 


Invert to Scrape 


When enabled, holding ctri while sculpting changes the 
brush behavior to be the same as the Scrape brush. 
When disabled, holding ctrl while sculpting, will push 
vertices below the cursor downward. 


Scrape 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Scrape 


The Scrape brush works like the Flatten brush, but only 
brings vertices above the plane downwards. 


Brush Settings 


Area Radius 


Ratio between the brush radius and the radius that is 
going to be used to sample the area center. 


Use Pressure (pressure sensitivity icon) 
Uses stylus pressure to control how strong the effect 
is. The gradient of the pressure can be customized 
using the curve widget. 


Invert to Fill 


When enabled, holding ctri while sculpting changes the 
brush behavior to be the same as the Fil! brush. When 
disabled, holding ctri while sculpting, will push vertices 
above the cursor up away from the cursor. 


Multiplane Scrape 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Multiplane Scrape 


Scrapes the mesh with two angled planes at the same time, 
producing a sharp edge between them. This is useful for 
creating edges when sculpting hard surface objects. 


Brush Settings 


Plane Angle 
The angle between the two planes of the brush, pressing 


Ctrl inverts the angle. 


Dynamic Mode 
When enabled, the base angle is sampled from the mesh 
surface. The Plane Angle controls how much the angle 
will increase when applying pen pressure. When pressing 
Ctrl, it locks the plane angle to 0 degrees. 


Show Cursor Preview 
Displays a preview of the two scrape planes and the 
angle they form instead of the cursor while performing 


the stroke. 


Pinch 


Reference 

Mode: Sculpt Mode 
Tool: Toolbar > Pinch 
Shortcut: p 


Pulls vertices towards the center of the brush. The inverse 
setting is Magnify, in which vertices are pushed away from 
the center of the brush. 


Grab 


Reference 

Mode: Sculpt Mode 
Tool: Toolbar » Grab 
Shortcut: G 


Used to drag a group of vertices around. Grab selects a 
group of vertices on mouse-down, and pulls them to follow 
the mouse. And unlike other brushes, Grab does not move 
different vertices as the brush is dragged across the model. 
The effect is like moving a group of vertices in Edit Mode 
with Proportional Editing enabled, except that Grab can 
make use of other Sculpt Mode options (like textures and 
symmetry). 


Brush Settings 


Grab Active Vertex 
Snaps the maximum strength of the brush to the 
highlighted active vertex, making it easier to manipulate 
low-poly models or meshes with subdivision surfaces. 


Enabling this option also enables a dynamic mesh 
preview which generates a preview of vertices connected 
to the active vertex. This helps to visualize the real 
geometry that is being manipulating while sculpting with 
Modifiers. 


Grab Silhouette 


Attempts to preserves the object’s silhouette shape. The 
Shape of the silhouette is determined by the orientation 
of the 3D Viewport. 


Elastic Deform 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Elastic Deform 


Used to simulate realistic deformations such as grabbing or 
twisting of Elastic objects. For example, this tool works great 
for modeling the shape of flesh like objects such as humans 
or animals. When pressing ctr1i, the brush deforms vertices 
along the normal of the active vertex. 


Brush Settings 


Deformation 
The surface alteration that is used in the brush. 


Grab 
Used to drag a group of vertices around. 


Bi-scale Grab 
Like Grab but the falloff is more localized to the center 


of the brush. 

Tri-scale Grab 
Like Bi-scale Grab but the falloff is more localized to 
the center of the brush. 


Scale 
Displaces vertices away from the active vertex. 


Twist 


Vertices are rotated around the active vertex. 


Volume Preservation 
Poisson ratio for elastic deformation. Higher values 
preserve volume more, but also lead to more bulging. 


Snake Hook 


Reference 

Mode: Sculpt Mode 

Tool: Toolbar » Snake Hook 
Shortcut: K 


Pulls vertices along with the movement of the brush to 
create long, snake-like forms. 


Brush Settings 


Magnify 
The Snake Hook brush tends to loose volume along the 
stroke, with Magnify value greater than 0.5 it’s possible 
to sculpt shapes without losing volume. 


Rake 
A factor to support moving the mesh with rotation 


following the cursor’s motion. 


Deformation 
Deformation type that is used by the brush. 


Radius Falloff 
Applies the brush falloff to the tip of the brush. 


Elastic 
Modifies the entire mesh using an Elastic deformation, 


see also the Elastic Deform tool. 


Thumb 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Thumb 


Similar to the Nudge brush, this one flattens the mesh in the 
brush area, while moving it in the direction of the brush 


stroke. 


Pose 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Pose 


This brush is used to pose a model simulating armature-like 
deformations. Several different deformation modes can be 
used to perform IK deformations or altering and moving the 
proportions of the mesh. The falloff of the deformation 
across multiple segments is controlled by the brush falloff 
curve. 


Brush Settings 


Deformation Target 
How the deformation of the brush will affect the object. 


Geometry 
Brush deformation displaces the vertices of the mesh. 


Cloth Simulation 
Brush deforms the mesh by deforming the constraints 
of a cloth simulation. 


Deformation 
Deformation type that is used by the brush. 


Rotate/Twist 
Rotates segments around a pivot point that is 
calculated automatically based on the radius of the 
brush and the topology of the model. When pressing 


ctri, the brush applies a twist rotation to the posing 
segments instead of using the rotation or an IK 
deformation. 


Scale/Translate 
Alters the proportions of the mesh, using the origin of 
the segment as a pivot. While holding ctri the brush 
moves the entire segment. 


Squash/Stretch 
Works similar to Scale/Translate however, it applies 
different scale values along different axes to achieve 
the stretching effect. The pivot point for this mode is 
calculated by using the local space aligned to the 
segment. 


Rotation Origins 


Method to set the rotation origins for the segments of the 
brush. 


Topology 
Sets the rotation origin automatically using the 
topology and shape of the mesh as a guide. 


Face Sets 
Creates a pose segment per Face Set, starting from 
the active face set. 


Face Sets FK 
Simulates a Forward Kinematics deformation using the 
Face Set under the cursor as control. 


Pose Origin Offset 
Offset of the pose origin in relation to the brush radius. 
This is useful to manipulate areas with a lot of complex 
Shapes like fingers. 


Smooth Iterations 
Controls the smoothness of the falloff of the deformation. 


Pose IK Segments 
Controls how many IK bones are going to be created for 
posing. 


Lock Rotation when Scaling 
When using Scale/Translate Deformation, do not rotate 
the segment; only scaling is applied. 


Keep Anchor Point 
Keeps the position of the last segment in the IK chain 
fixed. 


Connected Only 
Causes the brush to only affect topologically connected 
elements. Disabling this can have an impact on 
performance; when disabled, keeping the Max Element 
Distance as low as possible will help counteract the 
performance impact. 


Max Element Distance 
Maximum distance to search for disconnected loose parts 
in the mesh. 


Nudge 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Nudge 


Moves vertices in the direction of the brush stroke. 


Rotate 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Rotate 


Rotates vertices within the brush in the direction in which 
the cursor is moved. The initial drag direction is the zero 
angle and by rotating around the center you can create a 


vortex effect. 


Slide Relax 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Slide Relax 


This brush slides the topology of the mesh to areas that 
require more detail. The brush does this while minimizing 
changes to the geometrical shape of the mesh. When 
pressing Shift, the brush enters Relax mode which tries to 
create an even distribution of quads without deforming the 
volume of the mesh. 


Brush Settings 


Deformation 
Deformation type that is used by the brush. 


Drag 


Slides or pulls the topology of the mesh in the 
direction of the stroke. 


Pinch 


Slides the topology of the mesh towards the center of 
the stroke. 


Expand 


Slides the topology of the mesh away from the center 
of the stroke. 


Boundary 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Boundary 


This tool is used to transform and deform the boundaries i.e. 
the unconnected edges of a mesh. The tool detects the 
mesh boundary closest to the active vertex and propagates 
the deformation using the brush Falloff into the mesh. 


Note 


Even if this brush can produce deformations in triangle 
meshes and meshes with a non-regular quad grid, the 

more regular and clean the topology is, the better the 

result. 


Brush Settings 


Deformation Target 
How the deformation of the brush will affect the object. 


Geometry 
Brush deformation displaces the vertices of the mesh. 


Cloth Simulation 
Brush deforms the mesh by deforming the constraints 


of a cloth simulation. 


Deformation 
Deformation type that is used by the brush. 


Bend 
Rotates the active boundary around the local Y axis. 


Expand 
Moves/extends the mesh boundary in the local X 
direction. 


Inflate 
Works similar to the Inflate tool but, the vertices that 
are inflated are constrained to the mesh boundary. 


Grab 
Works similar to the Grab tool but, the vertices that 
are grabbed are constrained to the mesh boundary. 


Twist 
Rotates the active boundary around the local Z axis. 


Smooth 
Works similar to the Grab tool but, the vertices that 
are smoothed are constrained to the the mesh 
boundary. 


Boundary Falloff 
How the brush Falloff is applied across the boundary. 


Boundary Origin Offset 
Offset of the boundary origin in relation to the brush 
radius. 


Constant 
Applies the same deformation in the entire boundary. 


Brush Radius 


Applies the deformation in a localized area limited by 
the brush radius. 


Loop 
Applies the brush falloff in a loop pattern. 


Loop and Invert 
Applies the falloff radius in a loop pattern, inverting 
the displacement direction in each pattern repetition. 


Usage 


The main use cases of this brush are the Bend and Expand 
deformation modes, which depend on a grid topology to 
create the best results. In order to do further adjustments 
and tweaks to the result of these deformations, use the 
Inflate, Grab, Twist, and Smooth deformation modes, which 
do not depend that much on the topology. 


Cloth 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Cloth 


The Cloth brush uses a simplified Cloth Solver to simulate 
cloth physics on the mesh under the brush. Masked vertices 
are pinned in the simulation, and it applies the sculpt 
gravity directly in the solver. Note, using a relatively small 
brush makes the solver’s calculations much faster, larger 
brush sizes might be too slow to get a usable brush. 


Brush Settings 


Persistent 


Allows the cloth brush to not accumulate deformation 
after each stroke. This is convenient to always simulate 
the based on the same initial shape, but applying 
different forces to it. 


When disabled, deformations accumulate after each 
stroke. 


Set Persistent Base 


Resets the base mesh so that you can add another layer 
of deformations. 


Simulation Area 


Selects the part of the mesh that is going to be simulated 
when the stroke is active. This can greatly affect 


performance depending on the complexity of the mesh. 


Local 
Simulates only a specific area around the brush 
limited by a fixed radius. 


Global 
Simulates the entire mesh. 


Dynamic 
The active simulation area moves with the brush while 
still being limited by a fixed radius. 


Simulation Limit 
The Factor added relative to the size of the radius to limit 
the cloth simulation effects. 


Simulation Falloff 
The area to apply deformation falloff to the effects of the 
simulation. This setting is a factor of the Simulation Limit 
and is shown as a dashed line around the cursor. 


Pin Simulation Boundary 
Lock the position of the vertices in the simulation falloff 
area to avoid artifacts and create a softer transition with 
unaffected areas. 


Deformation 
The type of cloth deformation that is used by the brush. 


Drag 
Simulates pulling the cloth to the cursor, similar to 
placing a finger on a table cloth and pulling. 


Push 
Simulates pushing the cloth away from the cursor, 
similar to placing a finger on a table cloth and 


pushing. 


Pinch Point 
Simulates pulling the cloth into a point. 


Pinch Perpendicular 
Simulates pulling the brush into a line. 


Inflate 
Simulates air being blown under the cloth so that the 
cloth lifts up. 


Grab 
Simulates picking up and moving the cloth. 


Expand 
Simulates stretching the cloth out. 


Snake Hook 
Simulates moving the cloth without producing any 
artifacts in the surface and creates more natural 
looking folds than any of the other deformation 
modes. This is accomplished by adjusting the strength 
of the deformation constraints per brush step to avoid 
affecting the results of the simulation as much as 
possible. 


Force Falloff 
Shape used in the brush to apply force to the cloth. 


Radial 
Applies the force as a sphere. 


Plane 
Applies the force as a plane. 


Cloth Mass 


Mass of each simulation particle. 


Cloth Damping 
How much the applied forces are propagated through the 


cloth. 


Soft Body Plasticity 
The amount the cloth preserves its original shape, acting 


as a Soft Body. 


Use Collisions 
Enables the detection of collisions with other objects 


during the simulation. In order for the sculpt object to 
collide with objects, the collision object must have 


Collision Physics activated. 


Simplify 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Simplify 


This brush collapses short edges (as defined by the detail 
size) whether or not the Collapse Short Edges option is 


enabled. This brush has no effect if dynamic topology is not 
enabled. 


Mask 


Reference 

Mode: Sculpt Mode 
Tool: Toolbar » Mask 
Shortcut: M 


The Mask tool lets you paint a selection on parts of the 
mesh to be unaffected by other brushes. The mask values 
are shown as gray-scale. l.e. the darker a masked area is, 


the less effect sculpting on it will have. See also the options 
of the Mask menu. 


Brush Settings 


Mask Tool 
The mask brush has two modes: 


Draw 
Mask drawing. 


Smooth Shift 


Pressing Shift with the mask brush active will toggle 
the mask smoothing mode. 


Draw Face Sets 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Draw Face Sets 


This brush draws a new Face Set with each stroke. Holding 
Ctrt will continue drawing the same face set as the one 
under the cursor. Holding Shift will relax or smooth the 
edges of the face sets by modifying the underlying topology 
so edges flow along the perimeter of the face sets. This will 


remove the jagged lines visible after drawing or creating a 
face set. 


Multires Displacement 
Eraser 


Reference 


Mode: Sculpt Mode 
Tool: Toolbar >» Multires Displacement Erase 


This brush deletes displacement information of the Multires 
Modifier, resetting the mesh to the subdivision limit surface. 


This can be used to delete parts of the sculpt or to fix 
reprojection artifacts after applying a Shrinkwrap Modifier. 


Tip 


This brush works best after using Apply Base. 


Multires Displacement 
Smear 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Multires Displacement Smear 


This tool deforms displacement information of the Multires 
Modifier, moving the displaced vertices without affecting the 
base mesh. 


As the tool only modifies displacement values instead of 
base vertex values, the total displacement of the affected 
area does not change. Which means that this smearing 
effect can be used multiple times over the same area 
without generating any artifacts in the topology. 


Tip 


This brush works best after using Apply Base. 


Brush Settings 


Deformation 
Deformation type that is used by the brush. 


Drag: Pulls the displacement values in the 
direction of the brush. 
Pinch: 


Expand: 


Pulls the displacement values towards 
the center of the brush, creating hard 
surface effects without pinching the 
topology. 

Pushes the displacement values away 
from the brush center, smoothing the 
displacement. 


Paint 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Paint 


Paints on the active color attribute. 


Brush Settings 


Color 
Choose a primary and secondary color for painting. See 
Color Picker. 


Press S on any part of the image to sample that color and 
set it as the brush color. Hold ctri while painting to 
temporally paint with the secondary color. 


Swap Colors (cycle icon) 
Swaps the primary and secondary colors. 


Use Unified Color 
Use the same brush color across all brushes. 


Blend Mode 
Set the way the paint is applied over the underlying 
color. See Color Blend Modes. 


Flow 
Amount of paint that is applied per stroke sample. Used 
to create an accumulation effect. 


Wet Mix 
Amount of paint that is picked from the surface into the 
brush color. 


Wet Persistence 
Amount of wet paint that stays in the brush after 
applying paint to the surface. 


Wet Paint Radius 
Ratio between the brush radius and the radius that is 
going to be used to sample the color to blend in wet 
paint. 


Density 
Amount of random elements that are going to be 
affected by this brush. Use this for a detailed airbrush 
effect. 


Tip Roundness 
Roundness of the brush tip. The lower the value the more 
square the brush tip becomes. A lower roundness also 
affects the hardness of the brush. 


Tip Scale X 
Scale of the brush tip in the X axis. 


Smear 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Smear 


Paints on the active color attribute. It takes the colors under 
the cursor, and blends them in the direction of your stroke. 


Brush Settings 


Deformation 


Drag: Smear colors along the direction of the 
stroke. 

Pinch: Smear colors inwards towards your 
brush center. 

Expand: Smear colors outwards away from your 


brush center. 


Box Mask 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Box Mask 


Creates a new Mask based on a box selection. 


Tool Settings 


Front Faces Only 
Only creates a mask on the faces that face towards the 


view. 


Lasso Mask 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Lasso Mask 


Creates a new Mask based on a lasso selection. 


Tool Settings 


Front Faces Only 
Only creates a mask on the faces that face towards the 


view. 


Line Mask 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Line Mask 


This tool creates a Mask based on plan determined by the 
camera view and a drawn line. The masked region of the 
mesh is visualized by the shaded side of the line. 


Tool Settings 


Front Faces Only 
Only creates a mask on the front side of faces. 


Limit to Segment 


Apply the gesture action only to the area that is 
contained within the segment without extending its 
effect to the entire line. 


Usage 


1. Orient the 3D Viewport to define the local view plane to 
use for the mask. 

2. LMB and hold while moving the cursor to define the line 
to pick a region of the view plane to mask. 

3. Release Ls to confirm. 


Controls 


Flip F 
Changes the side of the line that the tool creates a mask. 


Snap Ctrl 
Constrains the rotation of the line to 15 degree intervals. 


Move Ctrl-Spacebar 
Changes the location of the line. 


Box Face Set 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Box Face Set 


Creates a new Face Set based on a box selection. 


Tool Settings 


Front Faces Only 
Only draw face sets on the front side of faces. 


Lasso Face Set 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Lasso Face Set 


Creates a new Face Set based on a lasso selection. 


Tool Settings 


Front Faces Only 
Only draw face sets on the front side of faces. 


Box Trim 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Box Trim 


Adds or removes geometry using a Boolean operation based 
on a box selection. 


Tool Settings 


Trim Mode 
The operation to perform on the mesh; geometry can be 
either added or removed. When using the Union or Join 
mode the new geometry is assigned to a new Face Set. 
When using Difference mode, interior geometry is also 
added to a new face set. 


Difference 
Removes geometry in the shape of the selection filling 
any holes that are created in existing geometry. 


Union 
Fills the selected outline with a new mesh and joins 
any intersections with existing geometry. 


Join 
Similar to Union but joins the mesh as separate 


geometry, without performing any Boolean operations 
with existing geometry. 


Use Cursor for Depth 


Use cursor location and radius for the dimensions and 
position of the trimming shape. If not set, the tool uses 
the full depth of the object from the camera view. 


Lasso Trim 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Lasso Trim 


Adds or removes geometry using a Boolean operation based 
on a lasso selection. 


Tool Settings 


Trim Mode 
The operation to perform on the mesh; geometry can be 
either added or removed. When using the Union or Join 
mode the new geometry is assigned to a new Face Set. 
When using Difference mode, interior geometry is also 
added to a new face set. 


Difference 
Removes geometry in the shape of the selection filling 
any holes that are created in existing geometry. 


Union 
Fills the selected outline with a new mesh and joins 
any intersections with existing geometry. 


Join 
Similar to Union but joins the mesh as separate 


geometry, without performing any Boolean operations 
with existing geometry. 


Shape Orientation 


The method used to orientate the trimming shape. 


View 
Use the view to orientate the trimming shape. 


Surface 
Use the surface normal to orientate the trimming 
shape. 


Use Cursor for Depth 
Use cursor location and radius for the dimensions and 
position of the trimming shape. If not set, the tool uses 
the full depth of the object from the camera view. 


Line Project 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Line Project 


This tool flattens the geometry along a plane determined by 
the camera view and a drawn line. The region of the mesh 
being flattened is visualized by the side of the line that is 
shaded. 


Tool Settings 


Limit to Segment 
Apply the gesture action only to the area that is 
contained within the segment without extending its 
effect to the entire line. 


Usage 


1. Orient the 3D Viewport to define the local view plane to 
use for the Boolean. 

2. LMB and hold while moving the cursor to define the line 
to pick a region of the view plane to remove. 

3. Release LmB to confirm. 


Controls 


Flip F 


Changes the side of the line that the tool removes 
geometry. 


Snap Ctrl 
Constrains the rotation of the line to 15 degree intervals. 


Move Ctrl-Spacebar 
Changes the location of the line. 


Example 


Before Line Project. After Line Project. 


Mesh Filter 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Mesh Filter 


Applies a deformation to all vertices in the mesh at the 
same time. To use this tool, click and drag away from the 
object to have a positive effect and click and drag towards 
the mesh to have a negative effect. 


Tool Settings 


Filter Type 
Smooth 
Eliminates irregularities of the mesh by making the 
positions of the vertices more uniform. This filter 
works similar to the Smooth Brush. 


Scale 
Increases the size of the mesh. This filter works similar 
to the Scale Transform. 


Inflate 
Displaces vertices uniformly along their normal. This 
filter works similar to the /nflate Brush. 


Sphere 
Morphs the mesh progressively into a sphere. This 
filter works similar to the To Sphere Transform. 


Random 
Randomly moves vertices along the vertex normal. 
This filter works similar to the Randomize Transform. 


Relax 
Tries to create an even distribution of quads without 
deforming the volume of the mesh. This filter works 
the same as the Relax mode of the Slide Relax brush. 


Relax Face Sets 
Smooths the edges of the face sets by modifying the 
underlying topology so edges flow along the perimeter 
of the face sets. This will remove the jagged lines 
visible after drawing or creating a face set. 


Surface Smooth 
Eliminates irregularities of the mesh by making the 
positions of the vertices more uniform while 
preserving the volume of the object. 


Shape Preservation 
How much of the original shape is preserved when 
smoothing. 


Per-Vertex Displacement 
How much the position of each individual vertex 
influences the final result. 


Sharpen 
Sharpens and smooths the mesh based on its 
curvature, resulting in pinching hard edges and 
polishing flat surfaces. It fixes most of the artifacts of 
the voxel remesher and those produced when 
sculpting hard surfaces and stylized models with 
creasing and flattening brushes. 


Smooth Ratio 
How much smoothing is applied to polished 
surfaces. 


Intensify Details 
Increases the high frequency surface details of the 
mesh by intensifying the difference between 
creases and valleys. 


Curvature Smooth Iterations 
The number of times the smoothing operation is 
applied per brush step. Controls how much smooth 
the resulting shape is, ignoring high-frequency 
details. 


Enhance Details 
Increases the high frequency surface details of the 
mesh by intensifying the difference between creases 
and valleys. 


Erase Displacement 
Deletes displacement information of the Multires 
Modifier, resetting the mesh to the subdivision limit 
surface. This can be used to delete parts of the sculpt 
or to fix reprojection artifacts after applying a 
Shrinkwrap Modifier. 


Negative strokes will intensify the displacement 
details, this method works similar to Enhance Details 
and can give better results in some circumstances. 


Strength 
The amount of effect the filter has on the mesh. 


Deformation Axis 
Apply the deformation only on the selected axis. 


Orientation 
Orientation of the axis to limit the filter displacement. 


Local 
Use the local axis to limit the displacement. 


World 
Use the global axis to limit the displacement. 


View 
Use the view axis to limit the displacement. 


Cloth Filter 


Reference 


Mode: Sculpt Mode 
Tool: Toolbar » Cloth Filter 


This tool works similar to the Cloth Brush, however, it 
applies a cloth simulation to all vertices in the mesh at the 
same time. Click and drag away from the object for a 
positive effect and towards for a negative effect. 


Tip 


Vertices can be “pinned” by masking vertices that should 
remain stationary, or by using Face Sets. 


Brush Settings 


Filter Type 
Operation that is going to be applied to the mesh. 


Gravity 
Applies gravity to the simulation. 


Inflate 
Inflates the cloth. 


Expand 
Expands the cloth’s dimensions. 


Pinch 


Pinches the cloth to the point were the cursor was 
when the filter started. 


Scale 
Scales the mesh as a Soft Body using the distance to 
the origin of the object as scale. This creates filter 
produces folds in the surface. The orientation of the 
folds can be controlled using the Force Axis and 
Orientation. 


Strength 
The amount of effect the filter has on the mesh. 


Force Axis 
Apply the force along the selected axis. 


Orientation 
Orientation of the axis to limit the filter force. 


Local 
Use the local axis to limit the force and set the gravity 
direction. 


World 
Use the world axis to limit the force and set the 
gravity direction. 


View 
Use the view axis to limit the force and set the gravity 
direction. 


Cloth Mass 
Mass of each simulation particle. 


Cloth Damping 


How much the applied forces are propagated through the 
cloth. 


Use Face Sets 
Only applies the cloth forces to the vertices assigned to 
the Face Set that are under the mouse. 


Use Collisions 
Enables the detection of collisions with other objects 
during the simulation. In order for the sculpt object to 
collide with object, the collision object must have 


Collision Physics activated. 


Color Filter 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar >» Color Filter 


Changes the color attribute on all vertices in the mesh at 
the same time. To use this tool, click and drag away from 
the object to have a positive effect and click and drag 
towards the mesh to have a negative effect. 


Tool Settings 


Filter Type 
Fill: Fills in a single color. 
Hue: Shifts the Hue of each color. 
Saturation: Increases or decreases the saturation. 
Value: Increases or decreases the values. 
Brightness: Increases or decreases the brightness. 
Contrast: Increases or decreases the contrast. 
Smooth: Blurs or sharpens the colors. 
Red: Increases or decreases the red channel. 
Green: Increases or decreases the green 
channel. 
Blue: Increases or decreases the blue 
channel. 
Fill Color 


Set a color that will be used for the fill filter type. 


Strength 
The amount of effect the filter has on the color attribute. 


Edit Face Set 


Reference 

Mode: Sculpt Mode 

Tool: Toolbar » Edit Face Set 
Operator: Grow/Shrink Face Sets 


Edits the Face Set under the cursor. 


Tool Settings 


Mode 
The operation to apply to the face set. 


Grow Face Set 
Grows the face sets boundary by one face based on 


mesh topology. 


Shrink Face Set 
Shrinks the face sets boundary by one face based on 


mesh topology. 


Delete Geometry 
Deletes the faces that are assigned to the face set. 


Fair Positions 
Creates a smooth as possible geometry patch from 
the face set minimizing changes in vertex positions. 


Fair Tangency 
Creates a smooth as possible geometry patch from 
the face set minimizing changes in vertex tangents. 


Modify Hidden 
Apply the edit operation to hidden face sets. 


Mask by Color 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar » Mask by Color 


Creates a mask from the color attribute. Click on any color 
on the mesh to create a new mask. 


Tool Settings 


Threshold 
How much changes in color affect the mask generation. 


A smaller threshold includes fewer similar colors. A larger 
threshold includes much more similar colors. 


Contiguous 
Mask only contiguous color areas. Colors that don’t touch 


the one that you click on will not be masked. 


Invert 
Invert the generated mask. 


Preserve Previous Mask 
Preserve previous mask and add or subtract the new one 


generated by the colors. 


Transforms 


Move 

Reference 

Mode: Sculpt Mode 
Tool: Toolbar » Move 


Translation tool. 


Rotate 

Reference 

Mode: Sculpt Mode 
Tool: Toolbar » Rotate 


Rotation tool. 


Scale 

Reference 

Mode: Sculpt Mode 
Tool: Toolbar > Scale 


Scale tool. 


Transform 


Reference 
Mode: Sculpt Mode 
Tool: Toolbar > Transform 


Tool to adjust the objects translation, rotations and scale. 


Tool Settings 


Each tool has the following settings to change how the 
unmasked mesh will be transformed. 


Transform Mode 


How the transformation is going to be applied to the 
target. 


All Vertices: Applies the transformation to all 
vertices in the mesh. 
Elastic: Applies the transformation while 


dynamically simulating elasticity. 
Instead of applying this to all vertices, 
it uses the radius of the cursor as the 
area of effect. 


Tool Settings 


Brushes 
Brush Settings 


O° 


o Oo 0 90 


Advanced 


Dyntopo 
Remesh 


O° 


Known Limitations 


Symmetry 
Options 


O° 


Gravity 


Brush Settings 


Radius 


This option controls the radius of the brush, measured in 
pixels. F allows you to change the brush size interactively 
by dragging the mouse and then Lms (the texture of the 
brush should be visible inside the circle). Typing a 


number then enter while using F allows you to enter the 
size numerically. 


Size Pressure 


Brush size can be affected by enabling the pressure 
sensitivity icon, if you are using a Graphics Tablet. 


Use Unified Radius 
Use the same brush Radius across all brushes. 


Radius Unit 
Controls how the brush Radius is measured. 


View 
The Radius is measured based on how the cursor 
appears on the monitor i.e. “screen space”. 


Scene 


The Radius is measured based on real world units. The 


unit type and scaling can be configured in the Scene 
Units. 


Strength 


Controls how much each application of the brush affects 
the model. For example, higher values cause the Draw 
brush to add depth to the model more quickly, and cause 
the Smooth brush to smooth the model more quickly. 


This setting is not available for Grab, Snake Hook, or 
Rotate. 


You can change the brush strength interactively by 
pressing Shift-F in the 3D Viewport and then moving the 
brush and then Léa. You can enter the size numerically 
also while in Shift-F sizing. 


Strength Pressure 
Brush strength can be affected by enabling the 


pressure sensitivity icon, if a supported tablet is being 
used. 


Use Unified Strength 
Use the same brush Strength across all brushes. 


Tip 

If the range of strengths does not seem to fit the model 
(for example, if even the lowest strength setting still 
makes too large of a change on the model) then you 


can scale the model (in Edit Mode, not Object Mode). 


Larger sizes will make the brush’s effect smaller, and 
vice versa. 


Direction Ctrl 


Brush direction toggle, Add raises geometry towards the 
brush, Subtract lowers geometry away from the brush. 
This setting can be toggled with ctrt while sculpting. 


Normal Radius 
The ratio between the brush radius and the radius that is 
going to be used to sample the normal i.e. take the 
average of multiple normals. This influences the brush 
orientation; increasing this value causes the brush to 
follow a smooth version of the mesh, while a small value 


causes the brush to closely follow the contours of the 
mesh. 


Hardness 
How close the brush falloff starts from the edge of the 
brush. 


Autosmooth 
Sets the amount of smoothing to be applied to each 
stroke. 


Topology 
See Dyntopo. 


Normal Weight ctrl 
Constrains brush movement along the surface normal. 
Especially useful with the Grab brush, can be temporarily 
enabled by holding ctrt. E.g. Grab brush can be used to 
push a depression (hole) into the mesh when Normal 
Weight is set. 


Applies to Grab and Snake Hook brushes. 


Plane Offset 
Offset for planar brushes (Clay, Fill, Flatten, Scrape), 
shifts the plane that is found by averaging the faces 
above or below. 


Plane Trim 
Ability to limit the distance that planar brushes act. If 
trim is enabled vertices that are further away from the 
offset plane than the trim distance are ignored during 
sculpting. 


Advanced 


Auto-Masking 


The auto-masking toggles in the brush settings are the 
Same as the sculpt mode auto-masking settings. The 
difference is that these toggles can be customized per 
brush to create specific brush behaviors. 


See also 


Auto-Masking For more information on the Auto-Masking 
toggles, see Auto-Masking. 


Sculpt Plane 


Use this menu to set the plane in which the sculpting 
takes place. In other words, the primary direction that 
the vertices will move. 


Area Plane: 


View Plane: 


X, Y, Z Plane: 


Original 
Normal 


The movement takes place in the 
direction of average normal for all 
active vertices within the brush area. 
Essentially, this means that the 
direction is dependent on the surface 
beneath the brush. 

Sculpting in the plane of the current 3D 
Viewport. 

The movement takes place in the 
positive direction of one of the global 
axes. 


When locked it keeps using the normal of the surface 
where stroke was initiated, instead of the surface 
normal currently under the cursor. 


Plane 


When locked keep using the plane origin of surface 
where stroke was initiated, instead of the surface 
plane currently under the cursor. 


Accumulate 
Causes stroke dabs to accumulate on top of each other. 


Front Faces Only 
When enabled, the brush only affects vertices that are 
facing the viewer. 


Texture 


See the global brush settings for Texture settings. 


Stroke 


See the global brush settings for Stroke settings. 


Falloff 


See the global brush settings for Falloff settings. 


Cursor 


See the global brush settings for Cursor settings. 


Dyntopo 


Reference 

Mode: Sculpt Mode 

Panel: Sidebar > Tool » Dyntopo 
Shortcut: Ctrl-D 


Dynamic topology (aka dyntopo) is a dynamic tessellation 
sculpting method, adds and removes details on-the-fly, 
whereas regular sculpting only affects the shape of a mesh. 
This makes it possible to sculpt complex shapes out of a 
simple mesh, rather than just adding details onto a modeled 
base mesh. 


Dyntopo can be toggled with the checkbox in the header or 
with ctrt-D. With dynamic topology active, most brushes will 
subdivide the mesh during the stroke. 


Detail Size/Percentage, Resolution Shift-D 
Each Detail Type’s detail is set here. Depending on the 
Detail Type being used this property will rather show as a 
pixel count (px), or percentage. 


Sample Detail Size (pipette icon) 
When using Constant Detail, it is possible to sample 
the detail value of a certain mesh area by clicking the 
pipette icon next to the detail setting and then 
clicking on the area. 


Refine Method 
Setting the option will determine which of the methods 
will be used when altering the topology. 


Subdivide Edges 
Just like the Subdivide tool, this method will only 
subdivide topology to match the detail given. 


Collapse Edges 
When topology is too dense, and is smaller than the 
detail given, edges will be collapsed to fit the detail 
size appropriately. 


Subdivide Collapse 
This method combines the two methods, subdividing 
edges smaller than the detail size, and collapsing 
topology. 


Detailing 
Dyntopo uses three different detail methods to create 
dynamic detail to an object. 


Relative Detail 
This method uses a detail size based on the number of 
pixels, and in turn will create topology in that size. 
Zoom out big details, zoom in small fine details. 


Constant Detail 
To keep detail uniform across the entire object, 
Constant Detail can be used. The Detail is based on 
the percentage of a single unit. 


Brush Detail 
Giving more control over the topology, with this 
method you can create topology based on the brush 
size. You can increase and lower topology by resizing 
the brush itself. The detail size is based the size of the 
brush itself, where full detail will create topology the 
size of the brush radius itself. 


Detail Flood Fill 


When using Constant or Manual Detailing, this option is 
made available, allowing you to fill the entire object with 
a uniform detail, based on the detail size. 


Smooth Shading 
Toggles whether mesh faces are smooth or flat-shaded. 
In dynamic-topology mode all faces have the same type 
of shading. 


Topology Rake 


Reference 
Mode: Sculpt Mode 
Panel: Tool Settings >» Brush > Topology Rake 


Topology Rake automatically aligns mesh edges to the brush 
direction to generate cleaner topology and define sharp 
features. Topology Rake can have a severe performance 
impact so it works best on low-poly meshes. 


Toporake 0.0 


Remesh 


Reference 

Mode: All Paint Modes 

Header: Tool Settings » Remesh 

Panel: Sidebar > Tool » Remesh 

Shortcut: Ctrl-R (Voxel), Ctrl-Alt-R (Quadriflow) 


Remeshing is a technique that automatically rebuilds the 
geometry with a more uniform topology. Remeshing can 
either add or remove the amount of topology depending on 
a defined resolution. This technique is especially useful for 
sculpting, to generate better topology after blocking out the 
initial shape. 


The Voxel Remesher uses an OpenVDB to generate a new 
manifold mesh from the current geometry. It produces a 
mesh with perfectly even distributed topology and it does 
not have any performance penalty once the new mesh is 
calculated. This makes the voxel remesher great for 
sculpting has it is possible to sculpt at a much higher level 
of detail than using other features like dyntopo which often 
adds more performance overhead. 


Voxel Size 


The resolution or the amount of detail the remeshed 
mesh will have. The value is used to define the size, in 
object space, of the Voxel. These voxels are assembled 
around the mesh and are used to determine the new 
geometry. For example a value of 0.5m will create 
topological patches that are about 0.5m (assuming 
Preserve Volume is enabled). Lower values preserve finer 


details but will result in a mesh with a much more dense 
topology. 


The voxel size also be adjusted from the 3D Viewport 
using Shift-R. Using this shortcut shows a grid that has 
the real size of the resulting voxel size. Holding Shift 
while adjusting the size allows better pressing while 
holding ctrl adjusts the size using a relative scale. 


Sample Voxel Size 


Used to adjust the Voxel Size by picking an area of the 


mesh to match the denseness of polygons after the 
remesh operation. 


Adaptivity 
Reduces the final face count by simplifying geometry 
where detail is not needed. This introduce triangulation 
to faces that do not need as much detail. Note, an 
Adaptivity value greater than zero disables Fix Poles. 


Fix Poles 


Tries to produce less poles at the cost of some 
performance to produce a better topological flow. 


Preserve 
Volume 
Tells the algorithm to try to preserve the original 
volume of the mesh. Enabling this could make the 
operator slower depending on the complexity of the 
mesh. 


Paint Mask 
Reprojects the paint mask onto the new mesh. 


Face Sets 
Reprojects Face Sets onto the new mesh. 


Color Attributes 
Reprojects the Color Attributes onto the new mesh. 


Voxel Remesh 
Performs the remeshing operation to create a new 
manifold mesh based on the volume of the current mesh. 
Performing this will lose all mesh object data layers 
associated with the original mesh. 


See also 


Remesh modifier 


Known Limitations 


e Remeshing only works on the original mesh data and 
ignores generated geometry from modifiers, shape keys, 
rigging, etc. 

e Remeshing will not work with the Multiresolution 
Modifier. 


Symmetry 


Reference 

Mode: Sculpt Mode 

Tool: Toolbar > Tool » Symmetry 
Mirror 


Mirror the brush strokes across the selected local axes. 
Note that if you want to alter the directions the axes 
point in, you must rotate the model in Edit Mode and not 
in Object Mode. 


Lock 
These three buttons allow you to block any 
modification/deformation of your model along selected 
local axes, while you are sculpting it. 


Tiling 
Using this option allows you to seamlessly tile your 
strokes along the given axes. This allows to create 
repeating patterns. 


Feather 
Reduces the strength of the stroke where it overlaps the 
planes of symmetry. 


Radial X, Y, Z 
These settings allow for radial symmetry in the desired 
axes. The number determines how many times the stroke 
will be repeated within 360 degrees around the central 
axes. 


Tile Offset X, Y, Z 


The offset allows the option to alter the tile size along all 
three axes. The default tile size is set to one unit. 


Direction 
Determines which direction the model will be 
symmetrized. 


Symmetrize 
Uses direction orientation to symmetrize. Since Dyntopo 
adds details dynamically it may happen that the model 
becomes asymmetric, so this a good tool for that. 


Options 


Reference 

Mode: Sculpt Mode 
Tool: Toolbar » Options 
Display 


Fast Navigate 
For multiresolution models, shows low resolution while 
navigating in the viewport. 


Delay Viewport Updated 
Update the geometry when it enters view. This 
provides for faster navigation. 


Use Deform Only 
Limits the activated modifiers on the active object to 
Deform Modifiers, and Multiresolution. Constructive 
modifiers (like Subdivision Surface, Mirror and other) 
get deactivated, because they could give inaccurate 
results. 


See also 
See the Display options. 


Gravity 


Factor 
Setting the factor allows you to add gravity to your brush 
strokes, giving it a draping effect. 


Orientation 
Using another object, the gravity can be oriented to the 
set object’s local Z axis, changing the direction of the 
gravity. 


Controls 


Auto-Masking 


Reference 

Mode: Sculpt Mode 

Tool: Header » Auto-Masking 
Shortcut: Alt-A 


These properties automatically mask geometry based on 
geometric features of the mesh. It’s an quick alternative to 
frequent manual masking. These masks are initialized on 
every new stroke or tool usage. They are also never visible 
as an overlay. 


Note, these properties are applied across all sculpt brushes, 
however, they can also be configured per brush in the 
Advanced Brush Settings. 


These properties can be accessed via a Pie Menus by 
pressing Alt-A. 


All auto-masking modes can be combined, which makes the 
generated auto-mask more specific. For example it’s 
possible to auto-mask a specific face set, while excluding 
disconnected topology and face set boundaries, and only 
affect faces that are oriented towards the view via View 
Normal. 


Topology 
Only vertices that are topologically connected to where 
you started the stroke/tool on are affected. So loose 


geometry islands will be auto-masked. 


Additionally for the Grab and Thumb brushes, anything 
that is not connected within the brush radius will be auto- 
masked. So even if geometry is connected somewhere, it 
is considered separate if the connection is not within the 
radius. 


Face Sets 


Only vertices that are part of the same face set that you 
started the stroke/tool on are affected. 


Tip 


If no topology or face set is visible under the curser at the 
start of the stroke, the previously auto-masked area will be 
targeted. This is especially useful with the “Projected” 
falloff shape in the Falloff Settings. 


Mesh Boundary 


Vertices that are part of open boundary edges are not 
affected. This also includes boundary edges to hidden 
faces. 


Propagation Steps 
Increases the soft gradient towards the auto-masked 
boundary edges. Each step iterates the distance one 
edge further. This setting is used for for both Mesh 
Boundary and Face Sets Boundary. It is also currently 
stored per brush. 


Face Sets Boundary 
Vertices that are part of a boundary between face sets 
are not affected. This also includes boundary edges to 


hidden faces. Propagation Steps are shared with Mesh 
Boundary auto-masking. 


Cavity 
Vertices that are the peaks of the surface curvature are 
not affected. While this auto-mask is primarily meant for 
painting, it can also be used for regular sculpting. 


Factor 
The overall contrast of how strong the cavity is 
applied. The value of 0.5 is the default, but better 
results can also be achieved on 0.2 if a Custom Curve 
is used as well. 


Blur 
The number of times the cavity mask is blurred. A 
value of 0 will give the pure cavity auto-mask. 
Anything higher than 6 will likely have a less visible 
effect and decrease performance. Even though the 
value is capped to 10, it can be increased up to 25 if 
typing in the value. 


Custom Curve 
Use a custom curve to fine tweak the cavity auto- 
mask. This is very useful if only small crevices or flat 
surfaces should be affected. Or for example if the 
contrast should be increased/decreased in a specific 
Way. 


Create Mask 
This will execute the Mask From Cavity operator with 
the current auto-masking settings. This is very useful 
to visualize the current auto-mask, or to edit the mask 
further manually. 


Cavity (Inverted) 


This is the same as “Cavity”, but inverted. This means 
the valleys/crevices of the surface curvature will not be 
affected. It cannot be used at the same time as Cavity 
and shares all of its settings. Enable this to quickly invert 
the cavity auto-mask. 


View Normal 


Only vertices with a Normal that face the viewer are 
affected. This is similar to the “Front Faces Only” toggle 
in the Brush Setting, to only affect visible geometry. The 
advantage of this auto-mask is that it has more options 
and works on sculpt mode as a whole. 


Occlusion 
Change the View Normal behavior to only affect 
vertices that are not occluded by other faces. This 
setting is incompatible with the other Limit and Falloff 
Sliders. It also causes a much slower performance. 


Limit 
Determines the range of angles that will be affected. 
90 degrees encompasses all that is visible. 


Falloff 
Extends the angular range of the Limit slider with a 
soft falloff gradient. This falloff will visually extend the 
limit range further. 


Area Normal 
Very similar to the View Normal, but uses the Normal of 
the surface that you started the stroke/tool on. This way 
any direction can be chosen for what vertices will be 
affected. It has the same Limit and Falloff sliders as the 
View Normal auto-mask. 


Adaptive Sculpting 


In order for sculpting to give accurate and predictable 
results, Blender needs geometry to work with. One way to 
accomplish this is starting off with a highly subdivided 
mesh. The other way involves using either of two adaptive 
sculpting methods to add geometry dynamically. 


Dynamic Topology 


Dynamic topology (aka dyntopo) is a dynamic tessellation 
sculpting method that adds and removes details under the 
brush. This works by first tessellating the mesh then 
applying the sculpting stroke on top of the tessellated mesh. 


This makes it possible to sculpt complex shapes out of a 
simple mesh, rather than just adding details onto a modeled 
base mesh. 


See also 


Dynamic Topology can be enabled in the Dyntopo panel. 


Multiresolution Modifier 


The Multiresolution Modifier can be used to dynamically 
subdivide the mesh. The more subdivision the more 
computing will be needed. With the Blender stack non- 
destructive data, multiresolution sculpting will help when 
you have a clean topology base mesh. 


When sculpting with multiple resolutions you have the 
ability to sculpt in different levels of subdivision, this mean 
you can sculpt some details in subdivision level 1 and add 
more details in subdivision 2 and go back to subdivision 1 
correct some mistakes. While this workflow is often used, 
the Multiresolution Modifier has some limitations. You may 
end up with some mesh distortions. As an advice, add as 
most details as possible before adding more subdivisions. 
Clay brush works better with multiresolution sculpting to 
sculpt secondary forms. 


e Step up one multires level PageUp 
e Step down one multires level PageDown 
e Set multires level ctrt-0 to Ctrl-5 


See also 


Read more about the Multiresolution Modifier. 
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Face Set from Masked 

Face Set from Visible 

Face Set from Edit Mode Selection 
Initialize Face Sets 
Grow/Shrink Face Sets 
Expand Face Set by Topology 
Expand Active Face Set 
Extract Face Set 

Invert Visible Face Sets 
Show All Face Sets 
Randomize Colors 


Sculpt 
Show & Hide 


Reference 
Mode: Sculpt Mode 
Menu: Sculpt 


Portions of the mesh can be hidden in Sculpt Mode to 
improve the viewport performance and to access parts of 
the mesh that would otherwise be difficult to access, 
because they are occluded by other parts. The hidden faces 
cannot be sculpted on. Hiding is shared between Edit Mode 
and Sculpt Mode (i.e. hiding/unhiding in one mode affects 
the other mode too). 


Show All Alt-H 
Reveal all hidden parts. 


Show Bounding Box Shift-H 
To reveal a hidden part of a mesh inside the selection. 


Hide Bounding Box H 
To hide a part of a mesh inside the selection. This works 
similar to the Box Select tool. 


Hide Masked 
Hides all masked vertices. 


Set Pivot 


Reference 


Mode: Sculpt Mode 
Menu: Sculpt > Set Pivot 


Like Object and Edit Mode, Sculpt Mode also has a Pivot 
Point. This is because the basic move, scale, rotate 
transforms are also possible in Sculpt Mode. 


Origin 
Sets the pivot to the origin of the sculpt. 


Unmasked 
Sets the pivot position to the average position of the 
unmasked vertices. 


Mask Border 
Sets the pivot position to the center of the mask’s border. 


Active Vertex 
Sets the pivot position to the active vertex position. 


Surface 
Sets the pivot position to the surface under the cursor. 


See also 


Object and Edit Mode Pivot 


Rebuild BVH 


Reference 


Mode: Sculpt Mode 


Menu: Sculpt » Rebuild BVH 


Recalculates the BVH used by Dyntopo which can improve 
performance which might degrade over time while using 
Dyntopo. 


Transfer Sculpt Mode 


Reference 

Mode: Sculpt Mode 

Menu: Sculpt > Transfer Sculpt Mode 
Shortcut: Alt-Q 


Switches Sculpt Mode from the Active object to the object 
under the mouse. See Switching Objects for more 
information. 


Mask 


Masking to control which areas of the mesh are influenced 
by sculpting. 


Black part is masked. 


Brush 


To edit the mask, select the Mask Brush from the Brush 
panel. 


Editing 
Reference 


Mode: Sculpt Mode 


Menu: Mask 
Shortcut: A 


Masks can be edited across the entire model. Using A opens 
a pie menu to choose different operations. 


Invert Mask 


Reference 

Mode: Sculpt Mode 
Menu: Mask > Invert Mask 
Shortcut: Ctrl-I 


Inverts an existing mask. 


Fill Mask 

Reference 

Mode: Sculpt Mode 
Menu: Mask > Fill Mask 


Fills the whole mask with a value of 1. 


Clear Mask 

Reference 

Mode: Sculpt Mode 
Menu: Mask » Clear Mask 


Shortcut: Alt-M 


Fills the mask with a value of 0. To completely remove the 
mask data, see Clear Sculpt-Mask Data. 


Box Mask 

Reference 

Mode: Sculpt Mode 
Menu: Mask > Box Mask 
Shortcut: B 


Works like the Box Select tool, it creates a rectangular mask 
region. Hold shift to clear the mask of the selected region. 


Lasso Mask 


Reference 

Mode: Sculpt Mode 
Menu: Mask >» Lasso Mask 
Shortcut: Shift-Ctrl-LMB 


Can be used to create a free-form mask, similar to the Lasso 
Select tool. 


Tip 
To clear the mask of areas with the Lasso Mask tool, first 


invert the mask, apply the Lasso Mask, and then invert the 
mask back. 


Mask Filters 


Reference 


Mode: Sculpt Mode 
Menu: Mask >» Mask Filters 


Mask filters are operations that are applied to the whole 
paint mask. 


Type 
Smooth/Sharpen Mask 
Changes the crispness of the mask edge. 


Grow/Shrink Mask 
Changes the size of the mask. 


Increase/Decrease Contrast 
Changes the contrast of the mask. 


Iterations 
The number of times that the filter is going to be applied. 


Auto Iteration Count 
Use an automatic number of iterations based on the 
number of vertices of the sculpt. 


Expand Mask by Topology 


Reference 

Mode: Sculpt Mode 

Menu: Mask » Expand Mask by Topology 
Shortcut: Shift-A 


Creates a mask radiating outwards from the active vertex in 
a uniform manner. 


Note 


This operator is meant to be used interactively through the 
shortcut. 


Hotkeys 


Invert: F Flips between expanding a positive mask 
(value of one) or a negative mask (value 
of zero). In the case of face sets, this 
option flips between including areas inside 
the masked area or areas outside the 
masked area. 

Toggle Preserve State: 

E Accumulates the new mask on top of the 
previous one instead of replacing it. For 
Face Sets, this creates Face Sets 
boundaries instead of replacing the 
existing Face Set. 

Toggle Gradient: 

G Enables linear gradient, creates a linear 
gradient of values from the origin to the 
current active vertex. 

Geodesic Recursive Step: 

R Generate a new Geodesic falloff from the 
boundary of the enabled vertices of the 
current falloff. 

Topology Recursive Step: 

Alt-R Generate a new topology flood fill 
falloff from the boundary of the enabled 
vertices of the current falloff. 

Move Origin: Spacebar Moves the initial vertex used for 
calculating the falloff. 

Geodesic Falloff: 


1 Uses a falloff based on the Geodesic 
distances from the edge boundary to the 
active vertex. 
Topology Falloff: 
2 Uses a falloff based on a flood fill using 
edges. 
Diagonals Falloff: 
3 Uses a falloff based on a flood fill using 
polygon diagonals and edges. 
Spherical Falloff: 
4 Uses a falloff based on the Euclidean 
distances from the edge boundary to the 
active vertex. 
Snap Expanded to Face Sets: 
Ctrl Isolates the expanded region to the 
boundary of the face set under the cursor. 
Loop Count Increase: 
w Increase the number of loops or 
iterations the operator is run; using four 
loops will split the mask into four parts. 
Loop Count Decrease: 
Q Decrease the number of loops or 
iterations the operator is run; using four 
loops will split the mask into four parts. 
Toggle Brush Gradient: 
B Similar to linear gradient but uses the 
current brush Falloff to define the shape of 
the falloff. 
Texture Distortion Increase: 
Y Increases the falloff distance when using 
a texture to distort the mask shape. 
Texture Distortion Decrease: 
T Decreases the falloff distance when 
using a texture to distort the mask shape. 


Usage 


Textures 


Textures can be used to affect the “strength” of the mask. 
This feature can be combined with loops and recursion to 
create really unique looking masks. To enable textures, you 
first need to create/select a texture to use, this is done by in 
the Properties editor’s Texture Properties. Next select the 
texture in the Texture Brush Settings, while there make 
sure to enable 3D Mapping. Now, you can use Y and T to 
increase or decrease the affect the texture has on the edge 
of the mask. 


Expand Mask by Normals 


Reference 

Mode: Sculpt Mode 

Menu: Mask » Expand Mask by Normals 
Shortcut: Shift-Alt-A 


Creates a mask radiating outwards from the active vertex 
while following the curvature of the mesh. This operator 
uses the same internal operator as Expand Mask by 
Topology meaning all the shortcuts and functionality works 
the same as that tool. 


Note 


This operator is meant to be used interactively through the 
shortcut. 


Mask Extract 


Reference 
Mode: Sculpt Mode 
Menu: Mask > Mask Extract 


Creates a duplicate mesh object based on masked 
geometry. 


Threshold 
Minimum mask value to consider the vertex valid to 
extract a face from the original mesh. 


Add Boundary Loop 
Creates and extra boundary loop on the edges of the 
geometry, making it ready for adding a Subdivision 
Surface modifier later. 


Smooth Iterations 
Smooth iterations applied to the extracted mesh. 


Project to Sculpt 
Project the extracted mesh on to the original sculpt 
object. 


Extract as Solid 
Adds a Solidify Modifier to the newly created mesh 
object. 


Mask Slice 


Reference 


Mode: Sculpt Mode 


Menu: Mask > Mask Slice 


Removes the masked vertices from the mesh. 


Threshold 
Minimum mask value to consider the vertex valid to 
extract a face from the original mesh. 


Fill Holes 
Fills concave holes with geometry that might have 
resulted from the Mask Slice operation. 


Slice to New Object 
Create a new object from the masked geometry. 


Mask From Cavity 


Reference 
Mode: Sculpt Mode 
Menu: Mask » Dirty Mask 


Generates a mask based on the cavity of the surface. The 
settings of the operation can be changed in the Adjust Last 
Operation panel. 


Mode 
Choose how the newly created mask is mixed with the 
existing one. By default it will replace the old mask via 
“Mix”. 


Mix Factor 
The factor of the mix effect. Choose how strong the new 
mask is applied on the existing one. 


Automask Settings 


The same settings as the Auto-Masking settings are 
applied. 


Factor 
Same as Auto-Masking. 


Blur 
Same as Auto-Masking. 


Invert 
Same as Auto-Masking. 


Custom Curve 
Same as Auto-Masking. 


Random Mask 


Reference 
Mode: Sculpt Mode 
Menu: Mask » Random Mask 


Generates a mask with random values for the entire object 
based on different mesh data. 


Per Vertex 
Assigns a random mask value for each vertex. 


Per Face Set 
Assigns a random mask value for each Face Set. 


Per Loose Mask 
Assigns a random mask value for each disjoint part of the 
mesh. 


Display Settings 
Reference 


Mode: Sculpt Mode 
Popover: Viewport Overlays - Sculpt » Mask 


The mask display can be toggled as a viewport overlay. In 
the overlay popover, the opacity of the mask overlay can be 
adjusted to make it more or less visible on the mesh. 


Clear Sculpt-Mask Data 


Reference 


Mode: Object/Edit Mode 
Menu: Properties » Object Data » Geometry 
Data > Clear Sculpt-Mask Data 


Completely frees the mask data layer from the mesh. While 


not a huge benefit, this can speed-up sculpting if the mask 
is no longer being used. 


Face Sets 


Face sets are another way to control the visibility state of 
the mesh in Sculpt Mode. They are designed to work in 
modes where brushes are the primary way of interaction 
and they provide much more control when working with 
meshes with complex shapes and overlapping surfaces. 
Geometry can be assigned to a face set and each face set is 
represented as a different color in the 3D Viewport. A pie 
menu to edit face sets can be accessed with w. 


Face Set from Masked 


Reference 
Mode: Sculpt Mode 
Menu: Face Sets » Face Set from Masked 


Creates a new face set from Masked Geometry. 


Face Set from Visible 


Reference 
Mode: Sculpt Mode 
Menu: Face Sets >» Face Set from Visible 


Creates a new face set from all visible geometry. 


Face Set from Edit Mode 
Selection 


Reference 

Mode: Sculpt Mode 

Menu: Face Sets >» Face Set from Edit Mode 
Selection 


Creates a new face set corresponding to the Edit Mode face 
selection. 


Initialize Face Sets 


Reference 


Mode: Sculpt Mode 
Menu: Face Sets > Initialize Face Sets 


Initializes all face sets on the mesh at once based off one of 
several mesh attribute properties. 


Mode 


The mesh data attribute used to define the boundaries 
for the face sets. 
By Loose Parts 
Creates a new face set per discontinuous part of the 
mesh. 
By Face Set Boundary 


Creates a face set for each isolated face set. This 
mode is useful for splitting the patterns created by 


Expand Face Set by Topology into individual Face Sets 
for further editing. 


By Materials 
Creates a face set per Material Slot. 


By Normals 
Creates face sets for Faces that have similar Normals. 


By UV Seams 
Creates face sets using UV Seams as boundaries. 


By Edge Creases 
Creates face sets using Edge Creases as boundaries. 


By Edge Bevel Weight 
Creates face sets using Bevel Weights as boundaries. 


By Sharp Edges 
Creates face sets using Sharp Edges as boundaries. 


By Face Maps 
Creates a face set per Face Map. 


Threshold 
The minimum value to consider a certain attribute a 
boundary when creating the face sets. 


Grow/Shrink Face Sets 


Reference 

Mode: Sculpt Mode 

Menu: Face Sets » Grow/Shrink Face Sets 
Tool: Edit Face Set 


Shortcut: Ctrl-w, Ctrl-Alt-W 


Expands or contracts the face set under the cursor by 
adding or removing surrounding faces. 


Expand Face Set by Topology 


Reference 

Mode: Sculpt Mode 

Menu: Face Sets >» Expand Face Set by Topology 
Shortcut: Shift-W 


Creates a face set radiating outwards from the active vertex 
in a uniform manner. This operator uses the same internal 
operator as Expand Mask by Topology meaning all the 
hotkeys and functionality works the same as that tool. 


Note 


This operator is meant to be used interactively through the 
shortcut. 


Expand Active Face Set 


Reference 

Mode: Sculpt Mode 

Menu: Face Sets >» Expand Face Set by Topology 
Shortcut: Shift-Alt-W 


Expands a face set by radiating outwards from the face set 
in a uniform manner. This operator uses the same internal 


operator as Expand Mask by Topology meaning all the 
hotkeys and functionality works the same as that tool. 


Note 


This operator is meant to be used interactively through the 
shortcut. 


Extract Face Set 


Reference 


Mode: Sculpt Mode 
Menu: Face Sets » Extract Face Set 


Creates a new mesh based on the selected face set. Once 


the operator is initiated, hover over the face set and Ls to 


create the new mesh. After the operator is finished the new 
mesh will be selected in Object Mode. 


Invert Visible Face Sets 


Reference 


Mode: Sculpt Mode 
Menu: Face Sets > Invert Visible Face Sets 


Hides all geometry that is part of a face set and makes all 
hidden geometry that is part of a face set visible. 


Show All Face Sets 


Reference 


Mode: Sculpt Mode 
Menu: Face Sets > Show All Face Sets 
Shortcut: Alt-H 


Shows all hidden geometry that is part of a face set. 


Randomize Colors 


Reference 
Mode: Sculpt Mode 
Menu: Face Sets » Randomize Colors 


Generates a new set of random colors to render the face 
sets in the 3D Viewport. 


Texture Paint 
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Introduction 


A UV texture is a picture (image, sequence or movie) that is 
used to color the surface of a mesh. The UV texture is 
mapped to the mesh through one or more UV maps. There 
are three ways to establish the image used by the UV 
texture: 


1. Paint a flat image in the Image Editor onto the currently 
selected UV texture, using its UV map to transfer the 
colors to the faces of the mesh. 

2. Paint the mesh in the 3D Viewport, and let Blender use 
the currently selected UV map to update the UV texture 
(see Projection Painting). 

3. Use any image editing program to create an image. In 
the Image Editor, select the UV texture and load the 
image. Blender will then use that texture’s UV map to 
transfer the colors to the faces of the mesh. 


Blender features a built-in paint mode called Texture Paint 
which is designed specifically to help you edit your UV 
textures and images quickly and easily in either the Image 
Editor or the 3D Viewport. Since a UV texture is just a 
special-purpose image, you can also use any external paint 
program, like GIMP or Krita. 


Since a mesh can have layers of UV textures, there may be 
many images that color the mesh. However, each UV 
texture only has one image. 


Texture Paint works in both a 3D Viewport and the Image 
Editor. In the 3D Viewport in Texture Paint Mode, you paint 
directly on the mesh by projecting onto the UVs. 


Tip 


Memory 
Optimization 


Texture Paint 
is fast and 
responsive 
when working 
in the 3D 
Viewport and 
when your 
image is sized 
as a square 
where the side 
lengths area 
power of two, e.g. 256x256, 512x512, 1024x1024, etc. 


Texture painting in Blender. 


Getting Started 


The object to be painted on must first be unwrapped. UVs 
can be added traditionally, with standard Unwrapping Tools, 
or by adding Simple UVs in Texture Paint mode. 


Note 


When no UV layers can be detected, Blender will display a 
warning message. 


Once you have unwrapped your model to a UV map, you 
can begin the texturing process. To use texture paint you 
may do any of the following: 


e Activate the Texture Paint workspace. Here the 3D 
Viewport has the Texture Paint Mode enabled and the 
Image Editor is already switched to Paint mode. 

e In the 3D Viewport, select Texture Paint Mode from the 
mode selector in the header, and you can paint directly 
onto the mesh. 

e In the Image Editor, switch the mode to Paint (shown to 
the right). 
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Enabling Paint mode. 


Once you enable Texture Painting, your mouse becomes a 
brush. As soon as you enable Texture Painting or switch to 
Texture Paint Mode, different tools become available in the 
Toolbar. 


In the Image Editor, you paint on a flat canvas that is 
wrapped around the mesh using UV coordinates. Any 
changes made in the Image Editor show up immediately in 
the 3D Viewport, and vice versa. To work with the UV layout 
(for example, to move coordinates) you must go back to 
View mode. 


A full complement of brushes and colors can be selected 
from the Sidebar region in the Image Editor. Brush changes 
made in either panel are immediately reflected in the other 
panel. However, the modified texture will not be saved 


automatically; you must explicitly do so by Image Editor » 
Image > Save. 


Texture Preview 


If your texture is already used to color, bump map, displace, 
alpha-transparent, etc., a surface of a model in your scene 
(in other technical words, is mapped to some aspect of a 
texture via a texture channel using UV as a map input), you 
can see the effects of your painting in the context of your 
scene as you paint. 


To do this, set up side-by-side areas, one Area in 3D 
Viewport set to Texture shading option, and in the second 
Area the Image Editor loaded with your image. Position the 
3D Viewport to show the object that is UV-mapped to the 
loaded image. In the image to the right, the texture being 
painted is mapped to the “Normal” attribute, and is called 
“bump mapping”, where the grayscale image is used to 
make the flat surface appear bumpy. See Texture Mapping 
Output for more information on bump mapping. 


Saving 


If the header menu item Image has an asterisk next to it 
means that the image has been changed, but not saved. 
Use the /mage » Save Image option to save your work with 
a different name or overwrite the original image. 


Note 


UV Textures 


Since images used as UV textures are functionally different 
from other images, you should keep them in a directory 
separate from other images. 


The image format for saving is independent of the format 
for rendering. The format for saving a UV image is selected 
in the header of the File Browser, and defaults to PNG (.png). 


If Packing is enabled in the File Browser’s header, or if you 
manually Image > Pack Image, saving your images to a 
separate file is not necessary. 


Using an External Image Editor 


If you use an external program to edit your UV texture, you 
must: 


. Run that paint program (GIMP, Krita, etc.). 

. Load the image or create a new one. 

. Change the image. 

. And re-save it within that program. 

. Back in Blender, you reload the image in the Image 
Editor. 
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You want to use an external program if you have teams of 
people using different programs that are developing the UV 
textures, or if you want to apply any special effects that 
Texture Paint does not feature, or if you are much more 
familiar with your favorite paint program. 


Known Limitations 


UV Overlap 


In general overlapping UVs are not supported (as with 
texture baking). 


However, this is only a problem when a single brush stroke 
paints onto multiple faces that share a texture. 


Perspective View & Faces Behind the 
View 


When painting onto a face which is partially behind the view 
(in perspective mode), the face cannot be painted on. To 
avoid this, Zoom out or use an orthographic viewport. 


Perspective View & Low Poly 


When painting onto a face in perspective mode onto a low- 
poly object with normals pointing away from the view, 
painting may fail; to workaround disable the Normal option 
in the paint panel. 


Typically this happens when painting onto the side of a cube 
(see Bug report T34665). 


Texture Paint Tools 


Draw 
The normal brush, paints a swath of color. 


Soften 
Uses a “blur effect” to soften or sharpen the image. 


Direction 
Soften 
Is used to paint a blur effect. 


Kernel Radius (2D only) 
Blur radius in pixels. 


Sharpen 
The Sharpen tool enhances the contrast of the 
image as you paint over it. 


Sharp Threshold 
The Threshold will only apply sharpening to only 
those pixels that differ more than the threshold 
value from their surrounding pixels. 


Kernel Radius (2D only) 
The kernel size controls how big an area the tool 
searches over is while calculating that 
difference. 


Blur Mode 
The blur kernel type controls how neighboring pixels 
are weighted when calculating the blur effect. 


Gaussian 


Gaussian will sample the pixels near the center of 
the brush most. 


Box 
Box samples all surrounding pixels equally. 


Smear 


When you click, takes the colors under the cursor, and 
blends them in the direction you move the mouse. 
Similar to the “smudge” tool of Gimp. 


Clone 


Copies the colors from the specified image (or location of 
the same image) to the active image. 


In 3D projective painting the clone cursor can be set with 
Ctri-LMB. In 2D painting the clone can be moved dragging 
it with RMB. 


Clone from Paint Slot (3D projective only) 
Use another image as clone source, instead of using 
the 3D cursor position as the source in the same 
image. 


Source Clone Slot 
This allows you to select an image as a clone 
source. 


Image (2D only) 
Image used as a clone source. 


Alpha (2D only) 
Opacity of the clone image display. 


Fill 


It can be used to fill large areas of the image with the 
brush color. The tool fills adjacent pixels that have a color 
value similar to the pixel you clicked on. 


Fill Threshold (2D only) 
Determines how much the color must be similar to the 
color of pixel you click to be filled. A low Threshold 
only fills very similar in color pixels. A higher 
Threshold fills pixels within a broader range of color. 


The Gradient type of the Color Picker allows the use of a 
gradient to fill the image. 


To apply the gradient with the Fi// brush click LMB and drag 
to define the gradient line, or radius if a radial gradient is 
used (depending on the Gradient Fill Mode). 


Gradient Fill Mode 
Linear, Radial 


Note 
Overrides 


For projective texturing it will bypass some options for 
projective painting to paint the model. This means that 
occluded, backfacing and normal culled faces will 
always get filled, regardless of whether the options are 
activated in the External panel. 


Mask 
The mask feature maps an image to the mesh and uses 
the image intensity to mask out certain parts of the mesh 
out during painting. The mask options can be found in 
the Mask panel. It’s only available for 3D projective 
painting. 


Mask Value 


Mask weight, a value of zero means not masked, while 
one is completely masked. 


Tip 


Use the face selection mask to isolate faces. See Face 
Selection Masking for details. 


Tool Settings 


Texture Slots 
Brushes 

Brush Settings 
Color Picker 
o Color Palette 
o Advanced 

o Jexture 

o Jexture Mask 
o) 

) 
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Stroke 
Falloff 
o Cursor 
e Mask 
o Stencil Mask 
o Cavity Mask 
symmetry 
Options 
o External 
Tiling 


Texture Slots 


The combination of images 
associated with UV maps is 
called “slots”. 


Selecting a Paint Slots or 
Canvas Image will also display 
the corresponding image in the 
Image Editor. 


Mode 


The slot system includes two 
painting modes: 


Material 


e. 


Oo. xX Y Z_ Texture Slots v 


Single Image 
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UVMap 


Linear 


( Save All Images 


Texture Slots settings. 


This mode tries to detect the slots from the materials 


of the mesh. 


For the Cycles renderer, all textures (Image Texture 
node) in the material’s node tree are added in the 


slots tab. 


Active Paint Texture Index 


A List view of slots. Activate a certain slot to use it 
for painting by LMB click on it. 


Single Image 


You can just select an existing image and painting will 
use the active UV layer for painting. 


Image 


Allows you to select the image used as a canvas. 


New 
Create a new image. 


UV Map 
Allows you to select the UV layer for painting. 
(Same as the currently active UV map in the 
mesh’s UV Maps panel.) 


Texture Filter Type 


Set the interpolation mode of the texture. This can 
be Linear or Closest. 


Save All Images 
Repack (or save if external file) all edited images. Same 
as in the Image Editor. 


Add Simple UVs 
The Add Simple UVs does a simple cube unwrap followed 
by a pack operation. It’s still recommended to make a 
custom unwrap. 


Brush Settings 


Blend 
Set the way the paint is 
applied over the 


underlying color. See 3 L 
Color Blend Modes. | 

e Add Alpha: makes 
the image more 
Opaque where Radius 
pa nted ' Strength 
Erase Alpha: makes Blend Mix 
the image y ioaes pee 
transparent where 
painted, allowing 
background colors = 


and lower-level 
textures to show 


Y Brush 
a] 


through. As you _ 
“paint”, the false » Color Palette 
checkerboard > & Gradient 


background will be riers 
revealed. Using a 
table pen’s eraser . 
end will toggle on Brush settings. 
this mode. 


Tip 

In order to see the effects of the Erase and Add Alpha 
mix modes in the Image Editor, you must enable the 
alpha channel display by clicking the Display Alpha or 


the Alpha-Only button. Transparent (no alpha) areas will 
then show a checkered background. 


Radius 


This option controls the radius of the brush, measured in 
pixels. F allows you to change the brush size interactively 
by dragging the mouse and then Lms (the texture of the 
brush should be visible inside the circle). Typing a 
number then enter while using F allows you to enter the 
size numerically. 


Size Pressure 
Brush size can be affected by enabling the pressure 
sensitivity icon, if you are using a Graphics Tablet. 


Use Unified Radius 
Use the same brush Radius across all brushes. 


Strength 
How powerful the brush is when applied. 


Size Pressure 
Brush Strength can be affected by enabling the 
pressure sensitivity icon, if you are using a Graphics 
Tablet. 

Use Unified Radius 
Use the same brush Strength across all brushes. 


Color Picker 


Color 


The color of the brush. See Color Picker. 


Press S on any part of the image to sample that color and 
set it as the brush color. Hold ctri while painting to 
temporally paint with the secondary color. 


Swap Colors (cycle icon) x 
Swaps the primary and secondary colors. 


Use Unified Color 
Use the same brush color across all brushes. 


Gradient 


A gradient can be used as a color source. 


Gradient Colors 
The Color Ramp Widget to define the gradient colors. 


Mode 
Pressure 
Will choose a color from the color ramp according to 
the stylus pressure. 


Clamp 
Will alter the color along the stroke and as specified 
by Gradient Spacing option. With Clamp it uses the 
last color of the color ramp after the specified 
gradient. 


Repeat 
Similar to Clamp. After the last color it resets the color 
to the first color in the color ramp and repeats the 
pattern. 


Color Palette 


Color Palettes are a way of storing a brush’s color so that it 
can be used at a later time. This is useful when working with 
several colors at once. 


Palette 
A Data-Block Menu to select a palette. 


New + 
Adds the current brush’s primary Color to the palette. 


Delete - 
Removes the currently selected color from the palette. 


Move (up/down arrow icon) 
Moves the selected color up/down one position. 


Sort 
Sort Colors by Hue, Saturation, Value, Luminance. 


Color List 
Each color that belongs to the palette is presented ina 
list. Clicking on a color will change the brush’s primary 
Color to that color. 


Advanced 


Accumulate 
This will allow a stroke to accumulate on itself, just like 
an airbrush would do. 


Affect Alpha 
When this is disabled, it locks (prevents changes to) the 
alpha channel while painting (3D only). 


Anti-Aliasing 2D Painting Only 


Toggles Anti-Aliasing around the brush, this is useful if 
you are working with pixel art or low resolution textures. 


Texture 


See the global brush settings for Texture settings. 


Texture Mask 


See the global brush settings for Texture Mask settings. 


Stroke 


See the global brush settings for Stroke settings. 


Falloff 


See the global brush settings for Falloff settings. 


Cursor 


See the global brush settings for Cursor settings. 


Mask 


exture Slots » §&#% Mask ¥ Texture Mask » 


UVMap 
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Mask settings. 


Stencil Mask 


The mask can be deactivated by the checkbox in the 
header. 


Stencil Image 
Image used as a mask. See Data-Block Menu. 


UV Layer 
Allows you to select the UV layer for the mask image. 


Display Color 
Mask color in the viewport. See Color Picker. 


Invert Stencil (black/white icon) 
Inverts the mask. 


Cavity Mask 


Cavity masking means that the brush will be masked if there 
is a cavity or a hill on the mesh surface depending on the 
mesh options. The cavity algorithm is vertex-based. 


Symmetry 


Reference 

Mode: Texture Paint Mode 

Tool: Toolbar > Tool » Symmetry 
Mirror 


Mirror the brush strokes across the selected local axes. 
Note that if you want to alter the directions the axes 
point in, you must rotate the model in Edit Mode and not 
in Object Mode. 


Options 


Bleed 
Seam Bleed extends the paint beyond UV island bounds 
to avoid visual artifacts (like bleed for baking). 


Dither 
Amount of dithering when painting on 8-bit images. 


Occlude 
With Geometry occlusion active only exposed (not hidden 
by other mesh parts) pixels are affected. This also allows 
for 3D stencils to be used to mask out areas of the 
surface too. 


Backface Culling 
With backface culling enabled you can only paint on the 
front side of faces. 


See also 


See the Brush Display options. 


External 


Screen Grab Size 
Size of the captured image for reprojecting. 


Quick Edit 
Edit a snapshot of the viewport in an external image 
editor. 


Apply 
Project edited image back onto the object. 


Apply Camera Image 
Project an edited render from the active camera back 
onto the object. 


Tiling 


Reference 

Editor: Image Editor 

Mode: Paint Mode 

Menu: Sidebar >» Tools » Tiling 


Wraps the stroke to the other side of the image as your 
brush moves off the opposite side of the canvas. Very handy 
for making seamless textures. 


X 
left/right 


Y 
top/bottom 


Vertex Paint 
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Introduction 


Vertex Painting is a simple way of painting color onto an 
object, by directly manipulating the color of vertices, rather 
than textures, and is fairly straightforward. Vertex Painting 
stores the color information as a Color Attribute which can 
be used by different render engines. 


%) File Edit Render Window 
+%~ (ME ObjectMode y View 
@ Object Mode 
F% Edit Mode 
@ Sculpt Mode 


a] Vertex Paint 


iz Weight Paint 


#* Texture Paint 


Vertex Painting Mode. 


When a vertex is painted, the color of the vertex is modified 
according to the settings of the brush. The color of all visible 
planes and edges attached to the vertex are then modified 
with a gradient to the color of the other connected vertices. 
Note that the color of occluded faces is not modified. 


See also 


Dynamic Paint can create Color Attribute information while 
using physics or animation. 


Viewing Color Attributes 


Color Attributes can be used in a material node tree using 
the Color Attribute Node. 


Color Attributes can be viewed in the 3D viewport using the 
Workbench render engine. To use such feature, set the 3D 
Viewport to Solid Shading and select the Attribute Color 
option. 


Vertex Paint Tools 


Draw 
Paints a specified color over the object. 


Blur 


Smooths out the colors of adjacent vertices. In this mode 
the Color Value is ignored. The strength defines how 
much the colors are blurred. 


Average 


Smooths color by painting the average resulting color 
from all colors under the brush. 


Smear 


Smudges colors by grabbing the colors under the brush 
and “dragging” them. This can be imagined as a finger 
painting tool. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Tool Settings 


e Brushes 
e Brush Settings 
o Color Picker 
Advanced 
Texture 
Stroke 
Falloff 
Cursor 


e Symmetry 


o Oo 0 0 O90 


Brush Settings 


Radius 
This option controls the 
radius of the brush, 
measured in pixels. F allows 
you to change the brush size 
interactively by dragging the 
mouse and then Lms (the 
texture of the brush should 
be visible inside the circle). 
Typing a number then enter 
while using F allows you to 


enter the size numerically. Radius 
Strength 
Size Pressure Blend Mix 
Brush size can be affected * Color Picker 


by enabling the pressure 
sensitivity icon, if you are 
using a Graphics Tablet. 


Use Unified Radius 


Use the same brush es 
Radius across all brushes. > Color Palette 
Strength 
How powerful the brush is 
when applied. Vertex Painting options. 


Size Pressure 
Brush Strength can be 
affected by enabling the pressure sensitivity icon, if 
you are using a Graphics Tablet. 


Use Unified Radius 
Use the same brush Strength across all brushes. 


Color Picker 


The color of the brush. See Color Picker. 


Press S on any part of the image to sample that color and 
set it as the brush color. Hold ctri while painting to 
temporally paint with the secondary color. 


Flip (cycle icon) x 
Swaps the primary and secondary colors. 


Note 


Note that Vertex Paint works in SRGB space, and the RGB 
representation of the same colors will be different between 
the paint tools and the materials that are in linear space. 


Advanced 


Affect Alpha 
When this is disabled, it locks (prevents changes) the 
alpha channel while painting. 


Accumulate 
This will allow a stroke to accumulate on itself, just like 
an airbrush would do. 


Front Faces Only 
Only paint on the front side of faces. 


Texture 


See the global brush settings for Texture settings. 


Stroke 


See the global brush settings for Stroke settings. 


Falloff 


See the global brush settings for Falloff settings. 


Cursor 


See the global brush settings for Cursor settings. 


Symmetry 


Reference 

Mode: Vertex Paint Mode 

Tool: Toolbar > Tool » Symmetry 
Mirror 


Mirror the brush strokes across the selected local axes. 
Note that if you want to alter the directions the axes 
point in, you must rotate the model in Edit Mode and not 
in Object Mode. 


Editing 


Reference 
Mode: Vertex Paint Mode 
Menu: Paint 


Set Vertex Colors Shift-kK 
Fill the active Color Attribute with the current paint color. 


Smooth Vertex Colors 
Smooth colors across vertices. 


Dirty Vertex Colors 


Blur Strength 
Blur strength per iteration. 


Blur Iterations 
Number of times to blur the colors (higher blurs 
more). 
Highlight Angle 
Clamps the angle for convex areas of the mesh. Lower 
values increase the contrast but can result in 
clamping. 90 means flat, 180 means infinitely pointed. 
Dirt Angle 


Clamps the angle for concave areas of the mesh. 
Higher values increase the contrast but can result in 
clamping. 90 means flat, 0 means infinitely deep. 


Dirt Only 


When active it won’t calculate cleans for convex 
areas. 


Normalize 
Choose optimal contrast by effectively lowering 
Highlight Angle and increasing Dirt Angle 
automatically. Disabling Normalize allows getting 
consistent results across multiple objects. 


Vertex Color from Weight 
Converts the active weight into grayscale colors. 


Invert 
Invert RGB values. 


Levels 
Adjust the levels oof the selected vertices. 


Hue Saturation Value 
Adjust the HSV values of the selected vertices. 


Bright/Contrast 
Adjust the brightness/contrast of the selected vertices. 


Weight Paint 
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Introduction 


Vertex Groups can potentially have a very large number of 
associated vertices and thus a large number of weights (one 
weight per assigned vertex). Weight Painting is a method to 
maintain large amounts of weight information in a very 
intuitive way. 


It is primarily used for rigging meshes, where the vertex 
groups are used to define the relative bone influences on 
the mesh. But we use it also for controlling particle 
emission, hair density, many modifiers, shape keys, etc. 


Vertex group in Weight Paint Mode. 


You can enter Weight Paint Mode from the Mode selector 
Ctrl-Tab. The selected mesh object is displayed slightly 
Shaded with a rainbow color spectrum. The color visualizes 
the weights associated to each vertex in the active vertex 
group. By default blue means unweighted and red means 
fully weighted. 


You can assign weights to the vertices of the object by 
painting on it with weight brushes. Starting to paint ona 
mesh automatically adds weights to the active vertex group 
(a new vertex group is created if needed). 


The Weighting Color Code 


Weights are visualized by a gradient using a cold/hot color 
system, such that areas of low value (with weights close to 
0.0) are displayed as blue (cold) and areas of high value 
(with weights close to 1.0) are displayed as red (hot). And all 
in-between values are displayed as rainbow colors (blue, 
green, yellow, orange, red). 


The color spectrum and their respective weights. 


In addition to the above described color code, Blender has a 
special visual notation (as an option) for unreferenced 
vertices: They are displayed as black. Thus you can see the 
referenced areas (displayed as cold/hot colors) and the 
unreferenced areas (in black) at the same time. This is most 
practicable when you look for weighting errors. See Options. 


Unreferenced vertices example. 


Note 


You can customize the colors in the weight gradient by 
enabling Custom Weight Paint Range in the System tab of 
the Preferences. 


Normalized Weight Workflow 


In order to be used for things like deformation, weights 
usually have to be normalized, so that all deforming weights 
assigned to a single vertex add up to 1. The Armature 
modifier in Blender does this automatically, so it is 
technically not necessary to ensure that weights are 
normalized at the painting stage. 


However, while more complicated, working with normalized 
weights has certain advantages, because it allows use of 
certain tools designed for them, and because when weights 
are normalized, understanding the final influence of the 
Current group does not require knowing weights in other 
groups on the same vertex. 


These tools are provided to aid working with normalized 
weights: 


Normalize All 
In order to start working with normalized weights it is 
first necessary to normalize the existing weights. The 
Normalize All tool can be used for that. Make sure to 
select the right mode and disable Lock Active. 


Auto Normalize 
Once the weights are initially normalized, the Auto 
Normalize option can be enabled to automatically 


maintain normalization as you paint. This also tells 
certain tools that the weights are supposed to be already 
normalized. 


Vertex group locking 
Any vertex group can be locked to prevent changes to it. 
This can be done via the lock icon in the vertex group 
list, or using bone selection and the locks pie menu. 


This setting prevents accidental edits to groups. 
However, since it is also respected by Auto Normalize, in 
the normalized weight workflow it has a more significant 
meaning of locking the current influence of chosen 
bones, so that when you paint other bones, the weight is 
redistributed only between the unlocked groups. 


In locations affected by more than two bones this allows 
more precise tweaking and re-balancing of weights by 
temporarily focusing on a subset of bones. This can also 
be aided by the Lock Relative option, which displays 
weights as if re-normalized with the locked groups 
deleted, thus making it appear as if the locked groups did 
not even exist. 


Multi-Paint 
Finally, the Multi-Paint option allows treating multiple 
selected bones as if they were one bone, so that the 
painting operations change the combined weight, 
preserving the ratio within the group. Combined with 
locking, this allows balancing between one set of bones 
versus the rest, excluding a third set that has its 
influence not affected in any way due to locks. 


Technically, this option does not require the normalized 
workflow, but since non-normalized weights can add to 


more than 1, the weight display behaves best with Auto 
Normalize enabled. 


Tip 


For example, when dealing with a bone loop, e.g. mouth or 
an eye, selecting the loop with Multi-Paint exposes the 
falloff between the loop as a whole and surrounding bones, 
while locking the surrounding bones and using Lock 
Relative displays the falloff between bones within the loop. 
Thus the complex two-dimensional falloff of each bone can 
be viewed and edited as two independent one-dimensional 
gradients. 


Weight Paint Tools 


Draw 
Paints a specified weight over the object. 


Blend 


The brush Blend Modes defines in which way the 
weight value is applied to the vertex group while 
painting. 


Mix 
In this Blending mode the Weight value defines the 
target weight that will eventually be reached when 
you paint long enough on the same location of the 
mesh. And the strength determines how many 
strokes you need to place at the target weight. 
Note that for strength = 1.0 the target weight is 
painted immediately and for Weight = 0.0 the 
brush just does nothing. 


Add 
In this Blending mode the specified weight value is 
added to the vertex weights. The strength 
determines which fraction of the weight gets added 
per stroke. However, the brush will not paint weight 
values above 1.0. 


Subtract 
In this Blending mode the specified weight value is 
subtracted from the vertex weights. The strength 
determines which fraction of the weight gets 
removed per stroke. However, the brush will not 
paint weight values below 0.0. 


Lighten 
In this Blending mode the specified weight value is 
interpreted as the target weight. Very similar to the 
Mix Blending mode, but only weights below the 
target weight are affected. Weights above the 
target weight remain unchanged. 


Darken 
This Blending mode is very similar to the Lighten 
Blending mode. But only weights above the target 
weight are affected. Weights below the target 
weight remain unchanged. 


Multiply 
Multiplies the vertex weights with the specified 
weight value. This is somewhat like subtract, but 
the amount of removed weight is now dependent 
on the Weight value itself. 


Blur 
Smooths out the weighting of adjacent vertices. In 
this mode the Weight Value is ignored. The 
strength defines how much the smoothing is 
applied. 


Blur 
Smooths out the weighting of adjacent vertices. In this 
mode the Weight Value is ignored. The strength defines 
how much the smoothing is applied. 


Average 
Smooths weights by painting the average resulting 
weight from all weights under the brush. 


Smear 


Smudges weights by grabbing the weights under the 
brush and “dragging” them. This can be imagined as a 
finger painting tool. 


Gradient 
Applies a linear/radial weight gradient; this is useful at 
times when painting gradual changes in weight becomes 
difficult. Blends the weights of selected vertices with 
unselected vertices. 


Example of the Gradient tool being used with 
selected vertices. 


Weight 
The gradient starts at the current selected weight 
value, blending out to nothing. 


Strength 
Lower values can be used so the gradient mixes in 
with the existing weights (just like with the brush). 


Type 
The shape of the gradient. 
Linear: Create gradient that forms a straight 
line. Alt-LMB and drag. 
Radial: Create gradient that forms a circle. 


Ctrl-Alt-LMB and drag. 


Sample 


Weights 
Sets the brush Wejght as the weight selected under 
the cursor. The sampled weight is displayed in the tool 
settings. 


Vertex Group 
Displays a list of possible vertex groups to select that 
are under the cursor. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Tool Settings 


e Brushes 

e Brush Settings 
o Advanced 
o Stroke 
o Falloff 
o Cursor 

e Symmetry 

e Options 


Brush Settings 


Painting needs paint brushes and 
Blender provides a Brush Panel within 
the Toolbar when it operates in 
Weight Paint Mode. 


Weight w 
The weight (color) to be used by 
the brush. However, the weight 
value is applied to the vertex 
group in different ways depending 
on the selected Brush Blending 
mode (see below). 


Use Ctri-LMB to sample the weight 
value of clicked vertex. Shift-LMB 
lets you select the group from Brush panel. 
which to sample from. 


Radius 
This option controls the radius of the brush, measured in 
pixels. F allows you to change the brush size interactively 
by dragging the mouse and then Lms (the texture of the 
brush should be visible inside the circle). Typing a 
number then enter while using F allows you to enter the 
size numerically. 


Size Pressure 
Brush size can be affected by enabling the pressure 
sensitivity icon, if you are using a Graphics Tablet. 


Use Unified Radius 
Use the same brush Radius across all brushes. 


Strength 
How powerful the brush is when applied. 


Size Pressure 
Brush Strength can be affected by enabling the 
pressure sensitivity icon, if you are using a Graphics 
Tablet. 

Use Unified Radius 
Use the same brush Strength across all brushes. 


Advanced 


Accumulate 
This will allow a stroke to accumulate on itself, just like 
an airbrush would do. 


Front Faces Only 
Only paint on the front side of faces. 


Stroke 


See the global brush settings for Stroke settings. 


Falloff 


See the global brush settings for Falloff settings. 


Cursor 


See the global brush settings for Cursor settings. 


Symmetry 


Reference 

Mode: Vertex Paint Mode 

Tool: Toolbar > Tool » Symmetry 
Mirror 


Mirror the brush strokes across the selected local axes. 
Note that if you want to alter the directions the axes 
point in, you must rotate the model in Edit Mode and not 
in Object Mode. 


Radial X, Y, Z 
These settings allow for radial symmetry in the desired 
axes. The number determines how many times the stroke 
will be repeated within 360 degrees around the central 
axes. 


Vertex Group X 
Use the X Mirror option for mirrored painting on groups 
that have symmetrical names, like with extension “.R”/ 
“Lor “_R” /“_L’. lf a group has no mirrored counterpart, 
it will paint symmetrically on the active group itself. You 
can read more about the naming convention in Editing 
Armatures: Naming conventions. The convention for 
armatures/bones apply here as well. 


Topology Mirror 
Use topology-based mirroring, for when both sides of a 
mesh have matching mirrored topology. See here for 
more information. 


Options 


The weight paint options ” Options 
change the overall brush 
behavior. 


Restrict 


X Mirror 


Auto Normalize 
Ensures that all deforming 
vertex groups add up to Size @ Strength Weight # 
one while painting. When 
this option is turned off, 
then all weights of a vertex Paint options. 
can have any value 
between 0 and 1. However, 
when vertex groups are used as deform groups for 
character animation then Blender always interprets the 
weight values relative to each other. That is, Blender 
always does a normalization over all deform bones. 
Hence in practice it is not necessary to maintain a strict 
normalization and further normalizing weights should not 
affect animation at all. 


¥ Unified Brush 


This option works most intuitively when used to maintain 
normalization while painting on top of weights that are 
already normalized with another tool. 


Lock-Relative 
Displays bone-deforming groups as if all locked deform 
groups were deleted, and the remaining ones were re- 
normalized. This is intended for use when balancing 
weights within a group of bones while all other bones are 
locked. With this option you can also temporarily view 
non-normalized weights as if they were normalized, 
without actually changing the values. 


Multi-Paint 
Paint on all selected vertex groups simultaneously, in a 
way that preserves their relative influence. This can be 
useful when tweaking weights in an area that is affected 
by more than three bones at once, e.g. certain areas ona 
character's face. 


This option is only useful in the Armature tab, where you 
can select multiple vertex groups by selecting multiple 
pose bones. Once at least two vertex groups are 
selected, viewport colors and paint logic switch to Multi- 
Paint mode, using the sum of the selected groups’ 
weights if Auto Normalize is enabled, and the average 
otherwise. Any paint operations aimed at this collective 
weight are applied to individual vertex group weights in 
such way that their ratio stays the same. 


Since the ratio is undefined if all weights are zero, Multi- 
Paint cannot operate on vertices that do not have any 
weight assigned to the relevant vertex groups. For this 
reason it also does not allow reducing the weight all the 
way to zero. When used with X Mirror, it only guarantees 
completely a symmetrical result if weights are initially 
symmetrical. 


Tip 

While Multi-Paint cannot directly paint on zero-weight 
vertices, it is possible to use the Smooth Weight tool to 
copy a reasonable nonzero weight distribution from 
adjacent vertices without leaving Multi-Paint mode or 
changing bone selection. 


To do that, enable vertex selection, select target 
vertices, and apply one iteration of the tool using vertex 
groups from Selected Pose Bones with low Factor. After 


that simply paint on top to set the desired collective 
weight. 


Restrict 
This option limits the influence of painting to vertices 
(even with weight 0) belonging to the selected vertex 


group. 
See also 


See the Brush Display options. 


Using Vertex Groups 


Vertex Groups for Bones 


This is one of the main uses of weight painting. When a 
bone moves, vertices around the joint should move as well, 
but just a little, to mimic the stretching of the skin around 
the joint. Use a “light” weight (10 - 40%) paint on the 
vertices around the joint so that they move a little when the 
bone rotates. While there are ways to automatically assign 
weights to an armature (see the skinning section), you can 
do this manually. To do this from scratch, refer to the 
process below. To modify automatically assigned weights, 
jump into the middle of the process where noted: 


1. Create an armature. 

2. Create a mesh that will be deformed when the 
armature’s bone(s) move. 

3. With the mesh selected, create an Armature modifier for 
your mesh (located in the Properties, Modifiers tab). 
Enter the name of the armature. 


Pick up here for modifying automatically assigned weights. 


1. Select the armature in 3D Viewport, and bring the 
armature to Pose Mode with Ctrit-Tab, or the 3D Viewport 
header mode selector. 

2. Select a desired bone in the armature. 

3. Select your mesh with LMB and change immediately to 
Weight Paint Mode. The mesh will be colored according 
to the weight (degree) that the selected bone 
movement affects the mesh. Initially, it will be all blue 
(no effect). 


4. Weight paint to your heart’s content. The mesh around 
the bone itself should be red (generally) and fade out 
through the rainbow to blue for vertices farther away 
from the bone. 


To select a different bone of the armature use Ctr1-LMB, this 
action will activate the corresponding vertex group and 
display related weights. 


Note 


You can only select one bone at a time in this mode (so 
Shift-LMB clicking does not work). 


Tip 


If the mesh skins the bones, you will not be able to see the 
bones because the mesh is painted. If so, enable |n Front. 


If you paint on the mesh, a vertex group is created for the 
bone. If you paint on vertices outside the group, the painted 
vertices are automatically added to the vertex group. 


If you have a symmetrical mesh and a symmetrical 
armature you can use Vertex Group X. Then the mirrored 
groups with the mirrored weights are automatically created. 


Tip 
Selecting Deform Groups 


When you are doing weight painting for deform bones 
(with an armature), you can select a deform group by 
selecting the corresponding bone. However, this vertex 


group selection mode is disabled when Selection Masking 
is active! 


Vertex Groups for Particles 


Mt, 


“ly 
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Weight painted particle emission. 


In example faces or vertices with zero weight generate no 
particles. A weight of 0.1 will result in 10% of the amounts 
of particles. This option “conserves” the total indicated 
number of particles, adjusting the distributions so that the 
proper weights are achieved while using the actual number 
of particles called for. Use this to make portions of your 
mesh hairier than others by weight painting a vertex group, 
and then calling out the name of the vertex group in the 
Vertex Groups panel Properties > Particles tab. 


Editing 


Reference 
Mode: Edit Mode and Weight Paint Mode 
Menu: Weights 


Blender provides a set of 
helper tools for Weight 
Painting. 


The Subset Option 


Some of the tools also provide 
a Subset filter to restrict their 
functionality to only specific 
vertex groups (in the Adjust 
Last Operation panel, displayed 
after the tool is called) with 
following options: 


e Active Group 

e Selected Pose Bones 
e Deform Pose Bones 
e All Groups 


All tools also work with Vertex 


ew | Weights Brush 


Normalize All 


Normalize 


Mirror 
Invert 


Clean 


Quantize 

Levels 

Smooth 

Transfer Weights 
Limit Total 


Fix Deforms 


Weight Paint Tools. 


Selection Masking and Face Selection Masking. In these 
modes the tools operate only on selected vertices or faces. 


Assign from Bone Envelopes 


Apply the envelope weight of the selected bone(s) to the 
selected vertex group. 


Assign Automatic from Bone 


Apply from the selected bone(s) to the vertex group the 
same “auto-weighting” methods as available in the Parent 
armature menu. 


Normalize All 


For each vertex, this tool makes sure that the sum of the 
weights across all vertex groups is equal to 1. This tool 
normalizes all of the vertex groups, except for locked 
groups, which keep their weight values untouched. 


Lock Active 
Keep the values of the active group while normalizing all 
the others. 


Normalize 


This tool only works on the active vertex group. All vertices 
keep their relative weights, but the entire set of weights is 
scaled up such that the highest weight value is 1.0. 


Normalize example. 


Mirror 


The Mirror Vertex Group tool mirrors the weights from one 
side of a perfectly symmetrical mesh to the opposite side. 
Only mirroring along local X axis is supported. Those 
vertices that have no corresponding vertex on the other side 
will not be affected. But note, the weights are not 
transferred to the corresponding opposite bone weight 


group. 


Mirror example. 


Mirror Weights 
With this option checked, every selected vertex receives 
the weight information of its symmetrical counterpart. If 
both vertices are selected, it will be a weight information 
exchange; if only one is selected, information from the 
unselected will overwrite the selected one. Information 
on weight is passed for the active group only, unless Al/ 
Groups is checked, in which case it is passed for all 
groups. 


Flip Group Names 
Works with selected vertices that belong to vertex groups 
with “symmetrical names” (with components like “L’, “R”, 
“right”, “left”). All selected vertices that belong to the 
active group, or to the symmetrical of the active group, 
will have their assignation to that group replaced by an 
assignation to the symmetrical one; however, its weight 
will be preserved. If A// Groups is checked, all 
assignations to these kind of groups will be replaced by 
the symmetrical counterpart, also keeping the old 
weights. 


All Groups 
Operate on all vertex groups, instead of the active one. 


Topology Mirror 
Mirror for meshes which are not fully symmetric 
(approximate mirror). See here for more information. 


Tip 


Mirror to Opposite Bone 


If you want to create a mirrored weight group for the 
opposite bone (of a symmetric character), then you can do 
this: 


1. Delete the target vertex group (where the mirrored 
weights will be placed). 

2. Create a copy of the source bone vertex group (the 
group containing the weights which you want to copy). 

3. Rename the new vertex group to the name of the 
target vertex group (the group you deleted above). 

4. Select the target vertex group and call the Mirror tool 
(use only the Mirror weights option and optionally 
Topology Mirror if your mesh is not symmetric). 


Invert 


Replaces each Weight of the selected weight group by x 
-1.0 weight. 


Examples: 


e Original 1.0 converts to 0.0 
e Original 0.5 remains 0.5 
e Original 0.0 converts to 1.0 


Invert. 


Subset 
Restrict the tool to a subset. See above The Subset 
Option about how subsets are defined. 


Add Weights 
Add vertices that have no weight before inverting (these 
weights will all be set to 1.0). 


Remove Weights 


Remove vertices from the vertex group if they are 0.0 
after inverting. 


Note 


Locked vertex groups are not affected. 


Clean 


Clean Vertex Group Weights unassigns vertices from Vertex 
Groups whose weights are below the Limit. Removes 


weights below a given threshold. This tool is useful for 
clearing your weight groups of very low (or zero) weights. 


In the example shown, a cutoff value of 0.2 is used (See 
operator options below) so all blue parts are cleaned out. 


Note, the images use the Show Zero weights Active option 
so that unreferenced Weights are shown in Black. 


Clean example. 


Subset 
Restrict the tool to a subset. See above The Subset 
Option for how subsets are defined. 


Limit 
This is the minimum weight value that will be kept in the 
group. Weights below this value will be removed from the 
group. 


Keep Single 
Ensure that the Clean tool will not create completely 
unreferenced vertices (vertices which are not assigned to 
any vertex group), so each vertex will keep at least one 
weight, even if it is below the limit value! 


Quantize 


This operator uses a process known as Quantization which 
takes the input weights and clamps each weight to a 
number of steps between (0 - 1), so there is no longer a 
smooth gradient between values. 


Quantize example (Steps = 2). 


Steps 
The number of steps between 0 and 1 to quantize the 
weights into. For example 5 would allow the following 
weights [0.0, 0.2, 0.4, 0.6, 0.8, 1.0]. 


Levels 


Adds an offset and a scale to all weights of the selected 
weight groups. with this tool you can raise or lower the 
overall “heat” of the weight group. 


Note 


No weight will ever be set to values above 1.0 or below 0.0 
regardless of the settings. 


Levels example. 


Subset 
Restrict the tool to a subset. See above The Subset 
Option for how subsets are defined. 


Offset 
A value from the range (-1.0 - 1.0) to be added to all 
weights in the vertex group. 


Gain 
All weights in the Subset are multiplied with the gain. 


Note 


Whichever Gain and Offset you choose, in all cases the 
final value of each weight will be clamped to the range 
(0.0 - 1.0). So you will never get negative weights or 
overheated areas (weight > 1.0) with this tool. 


Smooth 
Tip 


The Smooth tool only works when “Vertex selection 


masking for painting” is enabled. Otherwise the tool button 
is grayed out. 


Blends the weights of selected vertices with adjacent 


unselected vertices. This tool only works in vertex select 
mode. 


To understand what the tool really does, let us take a look at 
a simple example. The selected vertex is connected to four 
adjacent vertices (marked with a gray circle in the image). 
All adjacent vertices are unselected. Now the tool calculates 
the average weight of all connected and unselected 
vertices. In the example this is: 


\((1 +0 +0+ 0)/4 =0.25\) 


This value is multiplied by the factor given in the Operator 
options (see below). 


e If the factor is 0.0 then actually nothing happens at all 
and the vertex just keeps its value. 

e If the factor is 1.0 then the calculated average weight is 
taken (0.25 here). 

e Dragging the factor from O to 1 gradually changes from 
the old value to the calculated average. 


Now let us see what happens when we select all but one of 
the neighbors of the selected vertex as well. Again all 
connected and unselected vertices are marked with a gray 
circle. When we call the Smooth tool now and set the Factor 
to 1.0, then we see different results for each of the selected 
vertices: 


e The top-most and bottom-most selected vertices: 


are surrounded by three unselected vertices, with an 
average weight of \((1 + 0 + 0) / 3 = 0.333\) So their 
color has changed to light green. 


e The middle vertex: 


is connected to one unselected vertex with weight = 1. 
So the average weight is 1.0 in this case, thus the 
selected vertex has changed to red. 


e The right vertex: 


is Surrounded by three unselected vertices with average 
weight = \((0 + 0 + 0) / 3 = 0.0\) So the average weight 
is O, thus the selected vertex has not changed at all (it 
was already blue before Smooth was applied). 


Finally let us look at a practical example. The middle edge 
loop has been selected and it will be used for blending the 
left side to the right side of the area. 


e All selected vertices have two unselected adjacent 
vertices. 

e The average weight of the unselected vertices is \((1 + 
0) /2 =0.5\) 

e Thus when the Factor is set to 1.0 then the edge loop 
turns to green and finally does blend the cold side 
(right) to the hot side (left). 


Factor 


The effective amount of blending. When Factor is set to 
0.0 then the Smooth tool does not do anything. For 
Factor > 0 the weights of the affected vertices gradually 
shift from their original value towards the average weight 
of all connected and unselected vertices (see examples 
above). 


Iterations 
Number of times to repeat the smoothing operation. 


Expand/Contract 
Positive values expand the selection to neighboring 
vertices while contract limits to the selection. 


Source 
The vertices to mix with. 


All 
Smoothing will smooth both selected and deselected 
vertices. 


Only Selected 
Smoothing will only smooth with selected vertices. 


Only Deselected 
Smoothing will only smooth with deselected vertices. 


Transfer Weights 


Copy weights from other objects to the vertex groups of the 
active object. 


By default this tool copies only the active (selected) vertex 
group of the source object to the active vertex group of 
target object or creates a new one if the group does not 
exist. However, you can change the tool’s behavior in the 
Adjust Last Operation panel. 


For example, to transfer all existing vertex groups from the 
source objects to the target, change the Source Layers 
Selection option to By Name. 


Note 


This tool uses the generic “data transfer”, but transfers 
from all selected objects to active one. Please refer to the 
Data Transfer docs for options details and explanations. 


Prepare the Copy 


You first select all source objects, and finally the target 
object (the target object must be the active object). 


It is important that the source objects and the target object 
are at the same location. If they are placed side-by-side, 
then the weight transfer will not work. (See the Vertex 
Mapping option.) You can place the objects on different 
layers, but you have to ensure that all objects are visible 
when you call the tool. 


Now ensure that the target object is in Weight Paint Mode. 
Open the Toolbar and call the Transfer Weights tool in the 
Weight Tools panel. 


Adjust Last Operation Panel Confusion 


You may notice that the Adjust Last Operation panel stays 
available after the weight transfer is done. The panel only 
disappears when you call another Operator that has its own 
Adjust Last Operation panel. This can lead to confusion 
when you use Transfer weights repeatedly after you 
changed your vertex groups. If you then use the still-visible 
Adjust Last Operation panel, then Blender will reset your 
work to its state right before you initially called the Transfer 
Weights tool. 


So when you want to call the Transfer Weights tool again 
after you made some changes to your vertex groups, then 
always use the Transfer Weights button, even if the Adjust 
Last Operation panel is still available. Unless you really want 
to reset your changes to the initial call of the tool. 


Limit Total 


Reduce the number of weight groups per vertex to the 
specified Limit. The tool removes lowest weights first until 
the limit is reached. 


Hint 


The tool can only work reasonably when more than one 
weight group is selected. 


Subset 
Restrict the tool to a subset. See above The Subset 
Option for how subsets are defined. 


Limit 
Maximum number of weights allowed on each vertex. 


Fix Deforms 


The Fix deforms tool is used to modify an object’s nonzero 
weights so its deformed vertices are at a new defined 
distance. This is helpful to fix deformations because when 
complex models are deformed to their extreme poses, they 
are often visibly bumpy, jagged, or otherwise incorrectly 
deformed. Using this tool, you can smooth over the 
deformation. 


To use the tool, select the vertices that you would like to 
move, either in Edit Mode or by using the vertex 


selection/mask. The operator can now be used and altered 
with these options: 


Distance 
The distance to move to. 


Strength 
The distance moved can be changed by this factor. 


Accuracy 


Changes the amount weights are altered with each 
iteration: lower values are slower. 


Note 
Note that if it does not change, then there are no nonzero 


bone weights that are changed to make it closer to the 
intended distance. 


Locks 

Reference 

Mode: Edit Mode and Weight Paint Mode 
Menu: Weights >» Locks 

Shortcut: K 


Vertex groups can be locked to prevent undesired edits to a 
particular vertex group. 


Tip 


Bones that belong to a locked vertex group are displayed 
in red the 3D Viewport. 


Lock All 
Locks all vertex groups. 


Unlock All 
Unlocks all vertex groups. 


Lock Selected 
Locks selected vertex groups. 


Unlock Selected 
Unlocks selected vertex groups. 


Lock Unselected 
Locks unselected vertex groups. 


Unlock Unselected 
Unlocks Unselected vertex groups. 


Lock Only Selected 
Lock selected and unlock selected vertex groups. 


Lock Only Unselected 
Unlock selected and lock unselected vertex groups. 


Invert Locks 
Inverts the locks on all vertex groups. 
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Introduction 


Curves Sculpt Mode allows working with curves using 
various brushes. It is commonly used for hair grooming, but 
can be used with all kinds of curves. 


The curves’ surface object plays an important role in many 
curves sculpting brushes. Most brushes such as Add Curves 
require the surface to be set already. 


Note 


Curves Sculpt tools only use the original mesh of the 
Surface object and don’t take its modifiers into account. 


Curves Menu 


Snap to Deformed Surface 
Re-attach curves to a deformed surface using the 
existing attachment information. This only works when 
the topology of the surface mesh has not changed. 


Snap to Nearest Surface 
Find the closest point on the surface for the root point of 
every curve and move the root there. This needs to be 
run after the surface mesh topology changed 


Convert to Particle System 
Add a new hair particle system, or update an system on 
the surface object. The operator is used for backwards 
compatibility with the old hair type particle system. 


Select Menu 


All 
Select all control points or curves. 
None 
Deselect all control points or curves. 
Invert 
Invert the selection. 
Random 
Randomizes inside the existing selection or create new 
random selection if nothing is selected already. 
Endpoints 
Select endpoints of curves. Only supported in the Control 
Point selection mode. 
Grow 


Select points or curves which are close to already 
selected elements. 


Tools 


Selection Paint 
Add Curves 

Delete Curves 
Density Brush 
Comb Curves 
Snake Hook Curves 
Grow / Shrink Curves 
Pinch Curves 

Puff Curves 
Smooth Curves 
Slide Curves 


Selection Paint 


Paint curves or control paints to use as masks for the other 
tools. The selection visibility can be controlled by the 
Selection Opacity option in the Viewport Overlays. 


By default the selection sets a new selection. The selection 
paint can be extended by holding Shift and it can be 
subtracted by holding ctri while painting. 


Brush Settings 


Direction 
Determines whether to set a new selection or remove 
from it. It can be toggled holding ctrit while painting. 


Add Curves 


Used to distribute new curves on the surface mesh. This tool 
requires the curve to have a Surface object set. 


The curves follow the surface normals. Using the 
interpolation options allows the brush to take the 
characteristics of existing curves. 


Brush Settings 


Count 
Number of curves added. 


Note 


Interpolation allows to add hair which are already combed. 
The new curves are created following the previously 
created curves which are in the vicinity. 


Interpolate Length 
Use the average length of the curves in close proximity. 


Interpolate Shape 
Use the average shape of the curves in close proximity. 


Interpolate Point Count 
Use the average amount of control points of the curves in 
close proximity. 


Curve Length 
Length of newly added curves when not interpolated. 


Points per Curve 
Number of Control Points for the new created curves 
when the point count is not interpolated. 


Delete Curves 


Remove existing curves. The tool deletes the entire curves, 
if any of its segments fall under the brush falloff radius. 


Density Brush 


Create (or remove) curves based on a target distance. It 
generates a high number of points and then rejects the ones 
that are too close to existing points. 


Brush Settings 


Density Mode 
Determines whether the brush adds or removes curves. 


Auto: Either add or remove curves depending 
on the distance between existing curve 
roots under the cursor. 

Add: Add new curves between existing 
curves, taking the minimum distance 
into account. 

Remove: Remove curves whose root points are 
too close. 


Distance Min 
Goal distance between the curve roots. 


Edit Minimum Distance Shift-R 
Interactively sets the Distance Min value by displaying 
a graphic inside the brush cursor, giving a 
representation of the density. 


The density can be adjusted by moving the mouse 
cursor closer or farther from the paint cursor. The 

Distance Min will be changed once the operator is 
confirmed. 


Count Max 
The maximum amount of points that the brush tries to 
sample in the surface. 


Comb Curves 


Shape the curves by moving their control points while 
preserving the initial length of every curve segment. 


Snake Hook Curves 


Extend existing curves in a specific direction of the brush 
strokes. A curve can only be extended by its tips (the control 
point opposite to the root). 


Note 


No new control points are created for the curves. Instead, 
existing points are sampled along the new curve shape. 


Grow / Shrink Curves 


Change the length of existing curves preserving the amount 
of control points and resampling the curve to preserve the 
Original shape. 


Brush Settings 


Direction 
Determines whether to grow or shrink the curves. It can 
be toggled holding ctri while sculpting. 


Scale Uniform 
Grow or shrink curves by changing their size uniformly 
instead of using trimming or extrapolation. 


Minimum Length 
Avoid shrinking curves shorter than this length. 


Pinch Curves 


Converges adjacent curves to the location at the center of 
the cursor. 


The pinch brush can be inverted by holding ctrl. 


Puff Curves 


Makes the curves stand up. The brush aligns the curve with 
the surface normal and makes sure that points don’t move 
closer to the root point. 


Smooth Curves 


This brush makes curve segments close to one another 
more parallel. 


Slide Curves 


Slides the curves along the surface mesh. This tool requires 
the curve to have a Surface. Each curve is also rotated by 
the change in the surface normal. 


Common Settings 
Stroke 


See the global brush settings for Stroke settings. 


Falloff 


See the global brush settings for Falloff settings. 


Cursor 


See the global brush settings for Cursor settings. 
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Introduction 


Grease Pencil is a Blender object. It accepts the drawing 
information from a mouse or pressure-sensitive stylus and 
places it in 3D space as a collection of points, which are 
defined as a stroke. 


The Grease Pencil object can be used to make traditional 2D 
animation, cut-out animation, motion graphics or used it as 
storyboard tool among other things. 


An illustration in 3D space using the Grease Pencil 
object. 


Strokes are created in Draw Mode, which requires a new 
keyframe in the animation timeline for the Grease Pencil 
object. Existing strokes can then be adjusted in Edit Mode 


and Sculpt Mode. Finally, artists can apply materials, 
modifiers, lighting, and visual effects to strokes. 


Quick Start 


Artists can add Grease Pencil to any existing Blender scene, 
or start with a 2D Animation template. The template offers 
some pre-configured options that are helpful for animation 
and storyboarding. 


Create and Use Grease Pencil 


1. From Object Mode, Add » Grease Pencil > Blank. 

2. Create a new keyframe or turn on Auto Key. (See 
Keyframe Editing) 

3. Switch to Draw Mode. 

4. Click and drag across the viewport to add strokes to the 
Grease Pencil object. 


2D Animation Template 


To create a new Blender file using the “2D Animation” 
project template use: File » New > 2D Animation. 


Note the following pre-configured setup for the 2D 
Animation template: 


e 2D Animation is the default active workspace. 

e World Properties » Surface (Background) » Color is set 
to white. 

e Render Properties » Color Management is set to 
Standard. 

e The drawing_plane is set to Front (X-Z). 


e Line and Fill layers, along with some stroke materials, 


are configured for Grease Pencil. 
e The animation timeline will automatically create a new 


keyframe when Grease Pencil is used on empty frames. 


Tip 
Grease Pencil can read pressure-sensitivity information 
from a Graphics Tablet or stylus. 


Object 

Visibility 

Reference 

Panel: Object Properties » Visibility 


See also 


There are several other general visibility properties. 


Use Light 
Enables the Grease Pencil object to be affected by lights. 


This property affect the whole object, for more control with 
lights you can enable or disable the use of lights by layers. 
See Layers for more information. 


Lights disabled (left) and enabled (right). 


Structure 


Grease Pencil object has three main basic components: 
points, edit lines and strokes. 


Edit Line 


Stroke 


Example of Grease Pencil structure. 


Points 


The main element used in editing Grease Pencil objects are 
points. Points represent a single point in 3D space. 


Each point stores all the properties that define the final 
appearance of the strokes as its location, thickness, alpha, 
weight and UV rotation for textures. 


Note 


Point (Grease Pencil) and Vertex (meshes) are equivalent 
names. 


Edit Lines 


Points are always connected by a straight line, which you 
see when you are editing in Edit Mode or when you look at a 
stroke in wireframe view. They are invisible on the rendered 
image and are used to construct the final stroke. 


Strokes 


The stroke is the rendered image of the points and edit 
lines, using a particular Grease Pencil material. (Grease 
Pencil materials are linked at stroke level.) 


Primitives 


Reference 

Mode: Object Mode and Edit Mode 
Menu: Add > Grease Pencil 
Shortcut: Shift-A 


In Object Mode, the Add menu provides three different 


Grease Pencil primitives with preset materials and 2D 
layers: 


Grease Pencil primitives. 


Blank 


Adds a Grease Pencil object without any stroke. 


Stroke 


Adds a Grease Pencil object with a simple stroke as a 
reference. 


Monkey 


It creates a 2D monkey head. The Monkey’s name is 
“Suzanne” and is Blender’s mascot. 2D Suzanne is very 
useful as a standard test. 


Scene Line Art 


Sets up a Line Art Modifier for the active scene by creating 
an “empty” Grease Pencil object with a Line Art modifier 
referencing each object in the scene. 


Collection Line Art 


Sets up a Line Art Modifier for the active collection by 
creating an “empty” Grease Pencil object with a Line Art 
modifier referencing each object in the collection. 


Object Line Art 


Sets up a Line Art Modifier for the active object by creating 
an “empty” Grease Pencil object with a Line Art modifier 
referencing the active object. 


Selecting 


Reference 

Mode: Edit Mode 

Menu: 3D Viewport Header >» Select Mode 
Shortcut: 1, 2,3 


In Edit Mode there are three 
different selection modes. 
You can enter the different 
modes by selecting one of Edit Mode selection buttons. 
the three buttons in the 

header. 


Points 
To select individual points. 


Strokes 
To select an entire stroke. 


Points in Between 
To select all points that are between other strokes. 


Points, stroke and in between stroke selection 
sample. 


Select Menu 


Box/Circle/All/None/Invert Select 
All these options have the same meaning and behavior 
as in Object Mode. 


Select Linked 


Reference 

Mode: Edit Mode 
Menu: Select > Linked 
Shortcut: L, Ctrl-L 


L (or ctri-L for all) will add to the selection the cursor’s 
nearest control point, and all the linked ones, i.e. all points 
belonging to the same stroke. 


Select Alternated 


Reference 

Mode: Edit Mode 

Menu: Select > Alternated 
Shortcut: Shift-L 


Selects alternate points in the selected strokes. 


Select Random 


Reference 
Mode: Edit Mode 
Menu: Select >» Random 


Randomly selects unselected points or strokes. 


Ratio 
The likelihood of an unselected elements being selected. 
Note that, this is not the percentage amount of elements 
that will be selected. 


Random Seed 
Seed used by the pseudo-random number generator. 


Action 
Selection or deselection of elements. 


Unselect Ends 
Excludes the selection of stroke end points. 


Select Grouped 


Reference 

Mode: Edit Mode 
Menu: Select >» Grouped 
Shortcut: Shift-G 

Layer 


Selects all the points/strokes on the same layer. 


Material 
Selects all the points/strokes that share the same 
material. 


Select Color Attribute 


Reference 
Mode: Vertex Paint Mode 
Menu: Select >» Color Attribute 


Selects all points with a similar Color Attribute as the current 
selection. 


Tolerance 
How similar colors are allowed to be; higher values select 
a wider range of colors. 


Select First/Last 


Reference 
Mode: Edit Mode 
Menu: Select > First/Last 


These operators will toggle the selection of the first or last 
point(s) of the stroke(s) in the object. This is useful to 
quickly find the start of a stroke. 


Select More/Less 


Reference 


Mode: Edit Mode 
Menu: Select >» More/Less 
Shortcut: Ctrl-NumpadPlus, Ctrl-NumpadMinus 


The purpose of these tools is to reduce or enlarge the 
current selection within a stroke (i.e. they will never “go 


outside” of a stroke or “jump” to another stroke in the same 
object). 


More 


For each selected point, select al/ its linked points (i.e. 
one or two...). 


Less 


For each selected point, if a// points linked to this point 


are selected, keep this one selected. Otherwise, deselect 
it. 


Hint 
When all points of a stroke are selected, nothing will 
happen (as for Less, all linked points are always selected, 


and of course, More cannot add any). Conversely, the 
same goes when no points are selected. 


Multiframe 


Multiframe allows you to draw, edit, sculpt, or weight 
painting on several frames at the same time. Extremely 
useful to avoid repeating a task one frame at a time when 
animating. 


« Multiframe » View Selec 


¥ Use Falloff 


Multiframe panel. 


Usage 


1. Select the desired keyframes to draw, edit or sculpt at 
the same time. 
2. Activate the Multiframe tool in the 3D Viewport’s header 
with the toggle button (faded lines icon). 
3. Once activated you can: 
o Select the points in all the selected keyframes and 
make your editions. 
o Start sculpting. The sculpt brushes will affects all 
the strokes in the selected keyframes. 


o Start weight painting. The weight paint brush will 
affect all the strokes in the selected keyframes. 

o Start Drawing. The new strokes will be added in all 
the selected keyframes. If you are using the Fill tool 
then it will be applied in all the selected keyframes. 

o When interpolating you can select the stroke from 
the different frames in the right order. Interpolate 
tool will use the selection order to calculate the 
correct stroke pairs. 


Use Falloff 
When enabled, the effects on the strokes start to falloff 
from the current frame as defined by a curve widget. 


Note 


Not all operators support Multiframe mode. 
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Object Data 


Grease Pencil ‘@, Suzanne § Suzanne 
The Grease Pencil 

can 

be used to link the si ie 

data between Lines 

objects. Fills 


-O a 
sO ¥ Suzanne 


Blend Regular 


Opacity 


Masks 
Adjustments 
Relations 
Display 


Onion Skinning 


Keyframes Before 


Keyframes After 


>» ® Custom Colors 


io 
>» Viewport Display 


» Custom Properties 


Grease Pencil Object Data. 


2D Layers 


Strokes can be grouped in 2D layers, a special Grease Pencil 
layers that help to organize the drawing order and visibility 
of the strokes. 


See 2D Layers for more information. 


Onion Skinning 


Onion skinning is used in animation to see several frames at 
once and make decisions or edits based on how the 
previous/next frames are drawn. 


See Onion Skinning for more information. 


Vertex Groups 


Vertex groups can be used to assign a group or weighted 
group to some operator. An object can have several weight 
groups and can be assigned in Weight Paint Mode. 


See Vertex Groups for more information. 


Strokes 


General settings for Grease Pencil strokes. 


See Strokes for more information. 


Layers 


Reference 

Mode: All Modes 
Panel: 

Shortcut: Y 


Layers List 


Grease Pencil objects each 
have a list of 2D layers for 
grouping and arranging 
strokes in a List view. Any 
stroke can only belong toa 
single 2D layer. There is 
always only one active 
layer in the list (the 
selected one). When you 
draw, the new strokes are 
added to the active layer. 
By default the view order of 
the layers in the viewport is 
top to bottom. 


Every layer correspond to a 
channel in the Dope Sheet 
editor (in Grease Pencil 
mode). See Dope Sheet for 
more information. 


Object Data tab >» Layers 


Blend Regular 


Opacity 1.000 


¥ Use Lights 


Masks 


» Transform 
» Adjustments 
» Relations 


> Display 


Grease Pencil Layers panel. 


Layers can also be used together with Modifiers to only 


affects part of your drawing. See Modifiers for more 
information. 


Tip 


Sometimes the layers you are not working on can be a 
distraction. Activate Fade Inactive Layers in overlays to 


control the opacity of the non-active layers. See Overlays 
for more information. 


Next to the layer name there are four icons buttons that 
control common properties of the layer: 


Use Mask (mask icon) 
Toggle the affect of Masks on the layer. 


Onion Skinning (onion skin icon) 
Toggle using the layer for Onion Skinning. 


Hide (eye icon) 
Toggle layer visibility in the viewport and in render. 


Lock (padlock icon) 
Toggle layer from being editable. 


Layer Specials 
Operators for working with layers. 


Duplicate Layer 


Makes an exact copy of the selected layer appending 
a number to differentiate its name. 


Duplicate Empty Keyframes 


Makes a copy of the selected layer but with empty 
keyframes. Useful to easily have empty keyframes 
preset to work on the cleanup or filling process. 


Show All 
Turns on the visibility of every layer in the list. 


Hide Others 
Turns off the visibility of every layer in the list except 
the active one. 


Lock All 
Locks edition of all the layers in the list. 


Unlock All 
Unlocks edition of all the layers in the list. 


Autolock Inactive Layer 
Locks automatically the edition of every layer in the 
list except the active one. This way you avoid to make 
unwanted changes in other layers without the need to 
lock them every time. 


Disallow Locked Materials Editing 
Avoids editing locked materials in the layer. When 
disabled, any material can be edited even if they are 
locked in the material list. 


Merge Down Shift-Ctrl-M 
Combine the selected layer with the layer below, the 
new layer keeps the name of the lower layer. 


Merge All 
Combine all layers into the active layer. 


Copy Layer to Selected 


Copy the active layer to the selected Grease Pencil 
object. 


Copy All Layers to Selected 
Copy all layers to the selected Grease Pencil object. 


Visibility (screen icon) 
Toggle whether the active layer is the only one that can 
be edited and is visible. 


Isolate Lock (padlock icon) 
Toggle whether the active layer is the only one that can 
be edited. 


Below the layers list there are additional common settings: 


Blend 
The layer blending operation to perform. See Color Blend 
Modes. 


Opacity 
Used to set the opacity of the layer. 


Use Lights 
When enabled, the layer is affected by lights. 


Masks 


In a List view of layers affected by a layer mask. See Masks 
for more information. 


Transform 


Allows per-layer location, rotation and scale transformations. 


Adjustments 


Tint Color 
Color that tint any 
material colors used in 
the layer. 


Factor 
Controls the amount of 
tint color to apply. 


Stroke Thickness 
Thickness value that 
override the strokes 
thickness in the layer. 


Relations 


Parent/Type 


¥ Adjustments 


Tint Color 


Factor 


Stroke Thickness 


Pass Index 


View Layer ila] 


Disallow Locked Materials Editing 4 


Layers adjustment panel. 


Select a Parent object and Type to manipulate the layer. 
The layer will inherit the transformations of the parent, 
this is especially useful when rigging for cut-out 


animation. 


Pass Index 


The layer index number can be used with some modifiers 
to restrict changes to only certain areas. 


See Modifiers for more information. 


View Layer 


Defines the View Layer to use for the Grease Pencil layer. 
If empty, the layer will be included in all View Layers. 
This is useful to separate drawings parts for compositing. 


Disable Masks in Render 
If enabled no masks on the layer are included in the view 


layer render. 


Display 


Custom Channel Color 
Sets the color to use in the channel region of the Dope 


sect. 


Show Only On Keyframed 
Makes the layer visible in the viewport only if ithas a 
keyframe in the actual frame. This helps for example 
when you are in the inking process using the Fil// tool and 
want to only see the strokes that are in the actual frame 
to avoid fill in unwanted regions. 


Masks 


Layers List 


In Grease Pencil there are 
no special mask layers, any 
layer can act as a mask for 
other layers. The mask 
system is flexible enough to 
allow top-bottom and 
bottom-top masking. 


Layers used as mask can 
use all the blend modes and 
different opacity values like 
any other layer. 


Note 


¥ Layers 
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Layer list with masked layers. 


If you want to make a full transparent masking you will 
have to set the mask layer(s) opacity to O. 


By activating the mask toggle (mask icon) next to the layer 
name or using the checkbox on the masks panel header the 
layer becomes prepared to be masked by other layer(s). 


Masks list view. 


Masks List 


The layer/s that will act as mask of the current layer could 
be added to the Mask list view. 


In the Masks list next to the layers name there are two icons 
buttons that control common properties of the layer mask: 


Invert (mask icon) 
Inverts the mask. 


Viewport/Render Visibility (eye icon) 
Toggle layer visibility in the viewport and in render. 


Example 


Mask (green circle) samples. 


Original 

image Blend: 

(Blend: Hard elle, 
Regular, 

Regular, Light, Boscia 

Opacity: Opacity: 1. iii i 
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Onion Skinning 


Onion Skinning show ghosts of the keyframes before and 
after the current frame allowing animators to make 
decisions in the animation sequence. 


The main switch to show/hide Onion Skinning is in the 
Viewport Overlays, but Grease Pencil Onion Skinning is per- 
layer and the visibility can be toggle in the layer list. See 2D 
Layers for more information. 


¥ Onion Skinning 
Mode Keyframes 
Opacity 0.500 
Filter By Type Keyframe 


Keyframes Before 1 


Keyframes After 1 


¥ ™ Custom Colors 


Before 


After 


Onion Skinning panel. 


Options 


Mode 


Keyframes: Shows Keyframes in the range 
determined by the Before/After 


settings. 

Frames: Shows Frames in the range determined 
by the Before/After settings. 

Selected: Shows only on the manually selected 


keyframes in the Dope Sheet. 


Opacity 
Control the opacity of the ghost frames. 


Filter by Type 
Filters what type of frames to show in the Onion Skinning 
range. 


Keyframes Before/After 
Sets how many frames or keyframes, depending on the 
Mode, to show before and after the current frame. 


Custom Colors 


Before/After 
Color to use before and after the current frame on ghost 
frames. 


Display 


View in Render 
Show the onion skinning in final render image e.g. fora 
motion blur effect. 


Fade 
Opacity of the ghosts frames decrease the further away 
from the current frame. 


Show Start Frame 
Help working on loop animations showing the first 
keyframe/frame as ghost when you are on the last frame 
of your animation. 


An example of Onion Skinning activated. 


Strokes 


General settings for Grease Pencil strokes. 


¥ Strokes 


Stroke Depth Order 2D Layers 


Stroke Thickness World Space 


Thickness Scale 1.00 


Strokes panel. 


Stroke Depth Order 


Defines how the strokes are ordered in 3D space (for 
objects not displayed /n Front). 


2D Layers: The Strokes drawing order respect the 
order of the 2D layers list (top to 
bottom) and ignores the real position of 
the strokes in 3D space. See 2D Layers 
for more information. 

3D Location: The strokes drawing order is based on 
the stroke location in 3D space. 


Blue, Green and Blue, Green and 
Red strokes in Red strokes in 
three different three different 


layers using 2D layers using 3D 
Layers depth order. Location depth 
order. 


Stroke Thickness 
The basis for how the stroke thickness is calculated. 


World Space: _— The thickness is relative to world 
Space. Stroke thickness change with 
the screen zoom factor. 

Screen Space: The thickness is relative to screen 
space. Stroke thickness remains the 
Same regardless of the screen zoom 
factor. 


Thickness Scale 
Sets a thickness scale factor for all strokes. 


Curve Resolution 
See Curve Editing for more information. 


Viewport Display 


Display settings for Edit Y Viewport Display 
Lines in Edit Mode and Edit Line Color aaa. 
Sculpt Mode. oe 
Edit Line Color Color 
Sets the color of the Edit Snes 
Lines. , 
Offset X 
Y 
Subdivisions 
Viewport Display panel. 
Canvas 


In 3D space sometimes is difficult to assess on which plane 
are you drawing. The Canvas is a display overlay helper that 
shows a grid at the current Drawing Plane. You can enable 
the Canvas visualization in the Viewport Overlays. 


See Drawing Plane for more information. 


Color 
Color of the Canvas grid lines. 


Scale X/Y 
Defines the X and Y scale of the Canvas. 


Offset X/Y 
Sets the Canvas position offset from the object’s origin. 


Subdivisions 
Specifies the number of subdivisions to use for the grid. 


Canvas example on the XZ drawing plane using a green 
color grid. 


Modifiers 


e Introduction 
o Interface 
e Generate 
o Array Modifier 
Build Modifier 
Dot Dash Modifier 
Envelope Modifier 
Length Modifier 
Line Art Modifier 
Mirror Modifier 
Multiple Strokes 
Outline Modifier 
Simplify Modifier 
Subdivide Modifier 
e Deform 
o Armature Modifier 
o Hook Modifier 
o Lattice Modifier 
o Noise Modifier 
o Offset Modifier 


oO 0 0 0 0 0 OO O 


ie) 


Shrinkwrap Modifier 
Smooth Modifier 
Thickness Modifier 
e Color 
o Hue/Saturation Modifier 
o Opacity Modifier 
o Tint Modifier 
e Modify 
o Texture Mapping Modifier 
o Time Offset Modifier 
o Vertex Weight Angle Modifier 


o Vertex Weight Proximity Modifier 


Introduction 


Reference 


Panel: Properties >» Modifiers 


Grease Pencil has their own set of modifiers. Modifiers are 
automatic operations that affect an object in a non- 
destructive way. With modifiers, you can perform many 
effects automatically that would otherwise be too tedious to 
do manually and without affecting the base geometry of 
your object. 


They work by changing how an object is displayed and 
rendered, but not the geometry which you can edit directly. 
You can add several modifiers to a single object forming the 
modifier stack and Apply a modifier if you wish to make its 
changes permanent. 


Ci Add Modifier 


38 Texture Mapping Array 7 Armature <e- Hue/Saturation 


“\) Time Offset Build ©) Hook GB) Opacity 
is} Ver Weight Angle > Dot Dash Hy Lattice () Tint 
1S) Vertex Weight Proximity J Envelope s~ Noise 

Length (© Offset 

ff Line Art (| Shrinkwrap 

3 Mirror f Smooth 

Multiple Strokes f Thickness 
(P Outline 
/ Simplify 


©} Subdivide 


Grease Pencil Modifiers menu. 


There are three types of modifiers for Grease Pencil: 


Modify 
These are tools similar to the Deform ones (see below), 
however, they usually do not directly affect the geometry 
of the object, but some other data, such as vertex 
groups. 


Generate 
The Generate group of modifiers includes constructive 
tools that either change the general appearance of or 
automatically add new geometry to an object. 


Deform 
The Deform group of modifiers only changes the shape of 
an object without adding new geometry, 


Color 
The Color group of modifiers change the object color 
output. 


Interface 


> BR Tint i*7mOr~ x 
¥ @ ~ Thickness re = omy x 
Uniform Thickness 
Thickness Factor 1.000 
¥ Influence 


Layer s 
Pass 


Material 
Pass 


Vertex Group is 


Custom Curve 


Panel layout (Thickness modifier as an example). 


Each modifier’s interface shares the same basic 
components like modifiers for meshes. 


See Modifiers Interface for more information. 


Note 


Grease Pencil strokes, unlike meshes, still can not be 
edited directly in the place. 


Influence Filters 


Most of the modifiers share some special properties that 
restrict the effect only to certain items. 


Layer 
Restricts the effect only to one layer or to any layers that 
share the same material Pass Index. 


Material 
Restricts the effect only to material that share the same 
material or material Pass Index. 


Vertex Group 
Restricts the effect only to a vertex group. 


Custom Curve 
When enabled, use a custom curve to shape the effect 
along the strokes from start to end points. 


The Invert toggle <-> allows you to reverse the filters 
behavior. 


Generate 


Array Modifier 
Build Modifier 
Dot Dash Modifier 
Envelope Modifier 
Length Modifier 
Line Art Modifier 
Mirror Modifier 
Multiple Strokes 
Outline Modifier 
Simplify Modifier 
Subdivide Modifier 


Array Modifier 


The Array modifier creates an array of copies of the base 
object, with each copy being offset from the previous one in 
any of a number of possible ways. 


Useful for creating complex repetitive drawings. 


Multiple Array modifiers may be active for an object at the 
same time (e.g. to create complex three-dimensional 
constructs). 


See also 


This documentation refers to the Array Modifier specific to 
the Grease Pencil object. For uses with other object types 
refer to the general Array Modifier. 


Options 


Count 
Total number of copies. 


Material Override 
Index of the material to use on duplicated strokes (0 use 
strokes original materials). 


00 Array 


Count 
Material Override 
v¥ Relative Offset 
Factor X 1.00000 


Y 0.00000 
Z 0.00000 


Constant Offset 


Object Offset 


¥ Randomize 


Offset X 0.00000 
0.00000 
0.00000 


Rotation X O° 
0° 
0° 

0.00000 

0.00000 

0.00000 


1 


r Influence 


The Array modifier. 


Relative Offset 


Factor X, Y, Z 
Adds a translation equal to the object’s bounding box 
size along each axis, multiplied by a scaling factor, to the 


offset. X, Y and Z scaling factors can be specified. 


Constant Offset 


Factor X, Y, Z 
Adds a constant translation component to the duplicate 
object’s offset. X, Y and Z constant components can be 
specified. 


Object Offset 


Distance X, Y, Z 
Adds a transformation taken from an object (relative to 
the current object) to the offset. It is good practice to use 
an empty object centered or near to the initial object. 


Randomize 


Offset X, Y, Z 
Add random offset values to the copies. 


Rotation X, Y, Z 
Add random rotation values to the copies. 


Scale X, Y, Z 
Add random scale values to the copies. 


Uniform Scale 
Use the same random Seed for each scale axis in the 
copies for a uniform scale. 


Seed 
Seed used by the pseudo-random number generator. 


Note 


The Depth Order used in the Grease Pencil object has an 
influence on the visualization of the strokes when using the 
Array modifier. See Depth Order for more information. 


Influence 


See Influence Filters. 


Build Modifier 


The Build modifier make strokes appear or disappear in a 
frame range to create the effect of animating lines being 


drawn or erased. 


See also 


This documentation refers to the Build Modifier specific to 
the Grease Pencil object. For uses with other object types 


refer to the general Build Modifier. 


Options 


Mode 
Determines how many 
strokes are being 
animated at a time. 


Sequential 
Strokes 
appear/disappear one 
after the other, but 
only a single one 
changes at a time. 


Concurrent 
Multiple stroke 
appear/disappear ata 
time. 


Build 


Mode Sequential 


Transition Grow 
Start Delay 


Frames 
Factor 
Object 
Custom Range 


Fade 


Influence 


The Build modifier. 


If enabled you can set the Time Alignment. 


Time Alignment 
Align Start 
All stroke start at the same time (i.e. shorter 
strokes finish earlier). 


Align End 
All stroke end at the same time (i.e. shorter 
strokes start later). 


Transition 
Determines the animation type to build the strokes. 


Grow 
Shows points in the order they occur in each stroke, 
from first to last stroke. (Simulating lines being 
drawn.) 


Shrink 
Hide points from the end of each stroke to the start, 
from last to first stroke. (Simulating lines being 
erased.) 


Fade 
Hide points in the order they occur in each stroke, 
from first to last stroke. (Simulating ink fading or 
vanishing after getting drawn.) 


Start Delay 
Number of frames after each Grease Pencil keyframe 
before the modifier has any effects. 


Frames 
Maximum number of frames that the build effect can run 
for. (Unless another Grease Pencil keyframe occurs 


before this time has elapsed.) 


Factor 


Use a defined percentage factor to control the amount of 
the stroke that is visible. 


Object 


Object to use as the start position of the build transition. 


Custom Range 


If enabled, only modify strokes during the specified frame 
range. 


Start, End 
Determines the start and end frame for the build effect. 


Fade 


Factor 
Defines home much the stroke is fading in/out. 


Thickness 
How much strength fading is applied to the stroke’s 
thickness. 


Opacity 
How much strength fading applies to the stroke’s opacity. 


Weight Output 
Assign a weight value to points that have started/finished 
the fade. 


Influence Filters 


See Influence Filters. 


Dot Dash Modifier 


The Dot Dash modifier generates dot dash segments from 
the original stroke. 


Options 


Offset 
Determines the starting 
offset of the pattern. 


Segment 


Segment 

Makes up individual 
stroke of a dot dash 
pattern. 

Use the plus/minus ar 
button on the side of the Material Index 
list to add/remove 
segments. 


Influence 


Dash 
The number of 
consecutive points from 
the original stroke to 
include in this segment. 


The Dot Dash modifier. 


Gap 
The number of points skipped after the segment ends. 


Radius 
The factor to apply to the original point’s radius for the 
new points. 


Opacity 
The factor to apply to the original point’s opacity for the 
new points. 


Material Index 


Use this index on generated segment, use -1 for existing 
material. 


Use Cyclic 
Close the segment. 


Influence Filters 


See Influence Filters. 


Envelope Modifier 


The Envelope modifier creates a shape known as envelope 
over the existing strokes connecting all the points that have 
n points between them. 


Options 
M od e Jf Envelope 
Deform: a 
Spread Length 
Thickness 
Strength 
Material Index 
Skip Segments 
Influence 
The Envelope modifier. 
Replaces the original stroke with the 
envelope shape. 
Segments: Add segments to create the envelope 
shape keeping the original stroke. 
Fill: Add segments to create the envelope 


without the original stroke. 


Spread Length 
The number of points to skip when creating the straight 
segments that define the envelope. 


Thickness 


The thickness of the generated stroke segments. 


Strength 
The Opacity of the generated stroke segments. 


Material Index 
Defines the material to use on the generated stroke 
segments. 


Skip Segments 
The Number of generated stroke segments to skip to 
reduce complexity. 


Influence Filters 


See Influence Filters. 


Length Modifier 


The Length modifier can shrink or extend strokes. 
Options 


; ris Lenath 
Mode 


Start 0.44 


End 0.44 


Used Length 0.010 


¥ Curvature 


Point Density 


Segment Influ... 
Filter Angle 


Invert 


Influence 


The Length modifier. 


Mode 
Absolute: Length is in geometry space. 
Relative: Length is in ratio to the stroke’s length. 
Start 


Added length to the start of the stroke. Negative value 
will shrink the stroke. 


End 
Added length to the end of the stroke. Negative value will 
Shrink the stroke. 


Used Length 
Define what portion of the stroke is used to calculate the 
direction of the extension. 


Curvature 


When enabled, the extension will follow the curvature of the 
stroke. 


Point Density 
Multiplied by Start/End for the total point count. 


Segment Influence 
Factor to determine how much the length of the 
individual segments should influence the final computed 
curvature. Higher factors makes small segments 
influence the overall curvature less. 


Filter Angle 
Ignore points on the stroke that deviate from their 
neighbors by more than this angle when determining the 
extrapolation shape. 


Invert 
Invert the curvature of the stroke’s extension. 


Random Offsets 


Random Offset Start/End 
Size of random length added to the start/end of each 
stroke. 


Random Noise Offset 
Smoothly offset each stroke’s random value. 


Seed 
Number used to generate different noise patterns. 


Randomize 


Re-randomizes values over time. 


Step 
Number of frames before recalculate random values 
again. 


Influence Filters 


See Influence Filters. 


Line Art Modifier 


The Line Art modifier generates stylized line art from the 
scene or selected source collection or objects. 


Note 


Due to lack of global cache at the moment, each Line Art 
modifier will run the entire occlusion calculation for itself. 
So if you have multiple line art modifiers to select different 
parts of the scene (to apply different styles, etc.), the 
evaluation will take much longer. There are plans to 
remedy this in the future, but this is a known limitation for 
now. 


Options 


Use Cache 
Optimize rendering by using cached scene data from the 
first line art modifier in the stack. This option has the 
disadvantage of certain settings becoming unavailable. 


This option only available when you have more than one 
Line Art modifier is the same modifier stack and the 
modifier is not the first Line Art modifier in the stack. 


Source Type 


What type of geometry source should line art be 
generated from. 


Scene, Collection, Object 


Object/Coll 


. Line Art 
ection 
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Note 


Line Art will still load and calculate the entire visible scene 
to produce correct occlusion result, unless specified to do 
otherwise in object or collection Line Art Usage property. 


Layer 
The Grease Pencil Layers to put the result in. 


Material 
The Grease Pencil Materials to generate strokes with. 


Line Thickness 
The strokes generated by line art are given this 
thickness. 


Opacity 
The strokes generated by line art are given this Opacity. 


Edge Types 


Line Art can identify different edge types. Selected edge 
types will be included in the result. 


Illumination Filtering 
Select feature lines that comes from lit or shaded 
regions. Will not affect cast shadow and light contour 
since they are at the border. 


None: Not filtering any lines based on 
illumination region. 

Illuminated: Only selecting lines from illuminated 
regions. 

Shaded: Only selecting lines from shaded 
regions. 


IIluminated (Enclosed Shapes): 


Selecting lines from lit regions, and 
make the combination of contour, light 
contour and shadow lines into enclosed 
shapes. 


Create 


Contour 
Generate strokes from contour lines. Where the edge 
becomes the separation line of front/backfacing faces. 
The silhouette can also be inverted by clicking the invert 
button. 


None: Not filtering any lines based on 
illumination region. 

Illuminated: Only selecting lines from 
illuminated regions. 

Shaded: Only selecting lines from shaded 
regions. 


Illuminated (Enclosed Shapes): 
Selecting lines from lit regions, and 
make the combination of contour, 
light contour and shadow lines into 
enclosed shapes. 


Crease 
Generate strokes where the edge angle is small enough. 


Crease Threshold 
Angles smaller than this will be treated as creases. 
Crease angle priority: object line art crease override > 
mesh auto smooth angle > line art default crease. 


Intersections 
Generate stokes where lines intersect between faces. 


Material Borders 
Generate strokes where the edge separates faces with 
different materials. 


Edge Marks 
Generate strokes from freestyle edge marks. 


Loose 
Generate strokes for edges that do not form a Face. 


Light Contour 
Generate light/shadow separation lines from a reference 
Light Object. 


Cast Shadow 
Project contour lines using a light source object. 


Options 


Allow Overlap 
Allow an edge to have multiple overlapping types. This 
will create a separate stroke for each overlapping type. 


Light Reference 


Light Object 
Use this light object to generate Light Contour. 


Shadow Camera Size 
This value represent the “Orthographic Scale” of an ortho 
camera. If the camera is put at the lamps position with 
this scale, it will represent the coverage of the shadow 
“camera”. 


Near 
Near clipping distance of shadow camera. 


Far 
Far clipping distance of shadow camera 


Geometry Processing 


Custom Camera 
Use custom camera instead of the active camera for 
calculating strokes. Useful when baking multiple shots in 
different angle as well as for motion graphics effects. 


Overlapping Edges as Contour 
This option allows overlapping edges (e.g. from an Edge 
Split modifier or imported geometry where two edges 
occupy the exact same space) to be drawn as contour. 
Enabling this option will slow down the calculation 
Slightly but it will handle edge overlapping cases without 
erroneous occlusion results. 


Instanced Objects 
This option enables particles and other instanced objects 
to be loaded for line art calculation. There will be 
performance impact when there are a large amount of 
instanced objects in the scene. 


Clipping Boundaries 
When enabled, line art will generate clipping lines as 
contour type at the place where near or far clipping 
planes cut the model. Otherwise there will be no lines. 


Crease on Smooth 
Allow crease edges to show inside smooth surfaces. 


Crease on Sharp 
Allow creases to show on sharp edges. 


Force Backface Culling 


Remove all back faces to speed up calculation. Note, 
removing back faces will create edges in different 
occlusion levels than when disabled. 


Occlusion 


Range 
If enabled, the modifier 
will select lines that have 
an occlusion level between Level 
start and end values. 


v Transparency 


Level 
. Oy) avy fae) Gs) os 
Desired occlusion level to 
be selected as line art Match All Masks = 
result. A value of 0 means 
visible lines (no occlusion). Occlusion subpanel. 


A value of 1 means 
selecting lines that have 
been occluded by exactly 
one layer of faces. 


Material Mask 


If enabled, Line Art will only select lines that are occluded by 
certain faces whose material have specific occlusion masks 
set. 


Masks 
To select edges that have been occluded by the selected 
Material Mask. 


Exact Match 
If enabled, only lines that are occluded with the exact 
mask bit combination will be selected. Otherwise, lines 


that have been occluded by any one of specified material 
masks will be selected. 


This region has mask bit 1&2 H 
as transparency 


with 2 levels of occlusion _— ec nrd 


vs 


Has transparency 
mask bit 2 


Demonstration of the usage of material masks. 


Intersection 


Allows you to select edges that intersect between two 
collections. 


Collection Mask 
Mask bits to match from properties. 


Exact Match 


Require matching all intersection masks instead of just 
one. 


Demonstration of the usage of collection masks. 


Face Mark Filtering 


Y Face Mark Filtering 


Invert 


Boundaries 


Face Mark Filtering subpanel. 
Face Mark Filtering can be used to have manual control over 
which feature edges produce strokes by using Freestyle face 
marks. 


Invert 


Invert face mark filtering. 


Boundaries 
Filter feature lines based on face mark boundaries. 


Keep Contour 
Preserve contour lines while filtering. 


wo * 


Chaining 


Chain ¥ Chaining 
Intersection 
with Contour 

Allows 
intersection Image Threshold 0.001 m 
lines to be 
chained 
together 
with contour Chaining subpanel. 
lines. 


Chain Intersection With Contour 


All Lines 


Angle Splitting 60° 


Note 


Enabling this option will lead to ambiguity in 
intersection edge types. Intersection lines that have 


not been able to chain with any nearby contour lines 
will remain as intersection lines. 


All Lines 


Enabling this option will cause all lines to have the 
type of contour and to be chained together. 


Loose Edges 


Allow floating Edges that do not form a face to be 
chained together. 


Loose Edges as Contour 


Edges that do not form a face will be classified as 
contour lines. 


Preserve Details 
Instead of splitting at each occlusion change, keep 
small details from the initial chain. When details are 
not kept, will create a much smoother result. 


Geometry Space 


Use geometry distance for chaining instead of image 
Space. 


Image Threshold 
Allow the end point of short segments to be chained 


together if the 2D image space distance between them 
are within the specified threshold. 


Smooth Tolerance 
The strength of smoothing applied on jagged chains. 


Angle Splitting 
Split a chain at sharp “turning” points specified by this 
angle. 


Vertex Weight Transfer 


Filter Source Y Vertex Weight Transfer 
If source mesh 
has vertex 
groups whose ¥ Match Output 
name starts 
with this text, Vertex Weight Transfer subpanel. 
then the 
vertex weight 
info will be 
transferred into weight groups in Grease Pencil strokes. 


Filter Source §s§ Group 


Match Output 
Transfer the filtered object vertex weights into Grease 
Pencil weight groups with the same names as the filtered 
ones. 


Target 
If Match Output is off, then a target vertex group has to 
be specified. If there are multiple weight groups copied 
into target, then the highest weight value is copied into 
it. 


Composition 


“ Composition 


Overscan 0.000 


Image Boundary Trimming 


Depth Offset 0.05 m 


Towards Custom Camera 


Composition subpanel. 


Overscan 
To optimize rendering, Blender only renders the strokes 
for edges of the object that are in the camera’s view. This 
optimization however, can result in strokes ending 
abruptly at the edge of the image. 


This value prevents this error by adding a margin outside 
the camera’s view to continue computing strokes. 


Image Boundary Trimming 
Trim all stroke right at the boundary of image (including 
overscan region). 


Depth Offset 
Move strokes slightly towards the camera to avoid 
clipping while preserve depth for the viewport. This 
option is unavailable unless Show in Front is disabled. 


Towards Custom Camera 
Offset strokes towards selected camera (See Custom 
Camera above) instead of the active camera. 


Bake 


Bake Line Art 
Bakes Line Art 
strokes for 
active Grease Bake Line Art (All) 
Pencil object Clear Baked Line Art 
within the 
start, end 
frame range in 
scene. Bake Bake options. 
Line Art (All) 
bakes all 
Grease Pencil objects that contains at least one Line Art 


Bake Line Art 


Clear Baked Line Art (All) 


modifier. After baking, baked Line Art modifiers will be 
deactivated automatically. 


Clear Baked Line Art 
Clears baked line art frames within the scene frame 
range for active Grease Pencil object. Clear Baked Line 
Art (All) applies the same operation for all Grease Pencil 
objects that contains at least one Line Art modifier. 


Warning 
If you have drawn anything manually in the frame 


range of where line art runs, this operation will also 
clear those strokes! 


Continue without Clearing 
Re-activate a specific Line Art modifier without clearing 
baked strokes. This is useful for working on multiple 
portions of frames separately. 


Mirror Modifier 


The Mirror modifier mirrors the strokes along its local X, Y 
and/or Z axes, across the Object Origin. It can also use 
another object as the mirror center, then use that object’s 
local axes instead of its own. 


See also 


This documentation refers to the Mirror Modifier specific to 
the Grease Pencil object. For uses with other object types 
refer to the general Mirror Modifier. 


Options 
Axis r 3 
The X, Y, Z axis along 
which to mirror, i.e. the Object ‘= 


axis perpendicular to the 
mirror plane of 
symmetry. 


» Influence 


The Mirror modifier. 


To understand how the 

axis applies to the mirror 

direction, if you were to mirror on the X axis, the positive 
X values of the original stroke would become the 
negative X values on the mirrored side. 


You can select more than one of these axes. And will then 
get more mirrored copies. With one axis you get a single 


mirror, with two axes four mirrors, and with all three axes 
eight mirrors. 


Object 
A Data ID to select an object (usually an empty), which 
position and rotation will be used to define mirror planes 
(instead of using the ones from the modified object). 


Influence 


See Influence Filters. 


Multiple Strokes 


The Multiple Strokes modifier generate multiple parallel 
strokes around the original ones. 


Options 


Duplicates v (C MultipleStrokes 
The number of additional 
strokes. 


Duplicates 


Distance 


Distance 
Distance between the 
original and the duplicate 
strokes. 


Offset ® Influence 
Control the offset 


position (inner or outer) The Multiple Strokes modifier. 
for duplicate strokes. 


Fade 


When activated, the duplicate strokes fades out using their 
Opacity or thickness. 


Center 
Control the initial position for the fading. 


Thickness 
Fade influence on strokes thickness. 


Opacity 


Fade influence on strokes opacity. 


Influence 


See Influence Filters. 


Outline Modifier 


The Outline modifier convert strokes to outline tracing all 
strokes perimeter with new strokes. 


Options 


Thickness @ Outline MEG. x 
The thickness of the 
generated strokes 
outline. 


Thickness 1 
¥ Keep Shape 
Subdivisions 


Sample Length 


Keep shape 
The perimeter strokes 
are maintaining inside 
the original stroke Influence 
perimeter trying to 


keep the original The Outline modifier. 
shape. 


Outline Material 


Target Object 


Subdivisions 


controls the number of subdivision of the generated 
strokes outline. 


Sample Length 
Controls the accuracy of the perimeter conversion. 


Outline Material 


Defines the material to use on the generated strokes 
outline. 


Target Object 
Controls the origin of the cyclic strokes generated. 


Influence Filters 


See Influence Filters. 


Simplify Modifier 


The Simplify modifier allows you to reduce the amount of points in the 
strokes. The goal of this modifier is reduce points while maintaining the 
lines shape. 


Apply the modifier can help to obtain a better performance (more FPS) 
while animating. 


Options 


Mode v —P Simplify 
Determines how to reduce points in 2 ii 
the strokes. 


Iterations 


Fixed > Influence 
Deletes alternated points in the 2 
strokes, except the start and end The Simplify modifier. 
points. 


Iterations 
Number of times to repeat the procedure. 


Adaptive 
Uses the RDP algorithm (Ramer-Douglas-Peucker algorithm) for 
points deletion. The algorithm try to obtain a similar line shape 
with fewer points. 


Factor 
Controls the amount of recursively simplifications applied by 
the algorithm. 


Sample 


Recreates the stroke geometry with a predefined length between 
points. 


Length 
The distance between points on the recreated stroke. Smaller 
values will require more points to recreate the stroke, while 


larger values will result in fewer points needed to recreate the 


curve. 


Sharp Threshold 


Preserve corners that have sharper angle than this threshold. 


Merge 


Simplifies the strokes by merging points that are closer than a 


specified distance to each other. 


Distance 


Sets the distance threshold for merging points. 


Influence 


See Influence Filters. 


Example 
Fixed Mode sample. 
~~» ~—— Ex 
aed2 Re REQ 
—) &) 1S) 
Original Iteration: Iteration: 
Model. 1. 2. 
Adaptive Mode sample. 
(ZS FX Px 
RED ROO? COO? 
) ) is) 
Original Factor: Factor: 


Model. 0.1. 0.5. 


EX 
QE_W 
) 


Iteration: 
3. 


x 
SOY 
(J 


Factor: 
1. 


Subdivide Modifier 


The Subdivide modifier subdivide the strokes by inserting 
points between other points to the lines. 


Options 


Subdivision Type 
Catmull-Clark 
The default option, 
subdivides and 


smooths the surfaces. 


Simple 
Only subdivides the 
surfaces, without any 
smoothing. 


Subdivisions 


Recursively adds more points. 


Influence 


See Influence Filters. 


¥ (O}  Subdivide 


Subdivision Type Catmull-Clark ve 


Subdivisions 1 


> Influence 


The Subdivide modifier. 


Deform 


Armature Modifier 
Hook Modifier 
Lattice Modifier 
Noise Modifier 
Offset Modifier 
Shrinkwrap Modifier 
Smooth Modifier 
Thickness Modifier 


Armature Modifier 


The Armature Modifier is used for building skeletal systems 
for animating the poses of characters and anything else 
which needs to be posed. 


By adding an armature to an object, this object can be 
deformed accurately so that geometry does not have to be 
animated by hand. 


See also 


For more details on armatures usage, see the armature 
section. 


See also 


This documentation refers to the Armature Modifier 
specific to the Grease Pencil object. For uses with other 
object types refer to the general Armature Modifier. 


Options 

Object y 7 Armature P’mOoO.~ x 
The name of the Object |, Armature 
armature object used by Vertex Grou | 2 
this modifier. Bindto Vertex Groups 


Bone Envelopes 


Vertex Group 
The name of a vertex 


group of the object, the The Armature modifier. 


weights of which will be 

used to determine the 

influence of this Armature Modifier’s result when mixing 
it with the results from other Armature ones. 


Only meaningful when having at least two of these 
modifiers on the same object, with Multi Modifier 
activated. 


Invert <-> 
Inverts the influence set by the vertex group defined 
in previous setting (i.e. reverses the weight values of 
this group). 


Bind to 
Vertex Groups 
When enabled, bones of a given name will deform 
points which belong to vertex groups of the same 
name. E.g. a bone named “forearm”, will only affect 
the points in the “forearm” vertex group. 


The influence of one bone on a given point is 
controlled by the weight of this point in the relevant 
group. A much more precise method than Bone 
Envelopes, but also generally longer to set up. 


Bone Envelopes 
When enabled, bones will deform points or control 
points near them, defined by each bone’s envelope 
radius and distance. Enable/Disable bone envelopes 
defining the deformation (i.e. bones deform points in 
their neighborhood). 


Hook Modifier 


The Hook Modifier is used to deform stroke points using 
another object (usually an empty or a bone but it can be 
any object). 


As the hook moves, it pulls points from the strokes with it. 
You can think of it as animated Proportional Editing. 


See also 


This documentation refers to the Hook Modifier specific to 
the Grease Pencil object. For uses with other object types 
refer to the general Hook Modifier. 


Options 


Object 
The name of the object 
to hook points to. 


Object 


Vertex Group &s 


Strength 


Vertex Group 
Restricts the effect only Y Falloff 
to a vertex group. TRE I Srccth 
Radius Om 
Strength 
Adjust this hooks 
influence on the stroke > Influence 
points, were (0.0 to 1.0) 2 
(no change to fully follow The Hook modifier. 
the hook). 


Uniform Falloff 


Falloff 


Type 
This can be used to adjust the type of curve for the 
Strength attenuation. You can also define a custom curve 
to get a much higher level of control. 


Radius 
The size of the hooks influence. 


Uniform Falloff 
This setting is useful when using hooks on scaled objects, 
especially in cases where non-uniform scale would 
stretch the result of the hook. 


Influence 
See Influence Filters. 


Note 


The Hook Modifier stores points indices from the original 
strokes to determine what to affect; this means that 
modifiers that generate geometry, like a Subdivision 
Surface Modifier, should always be applied after the Hook 
Modifier; otherwise the generated geometry will be left out 
of the hook’s influence. 


Example 


Empty used as a hook to manipulate a vertex group 
(right eye of the monkey). 


Lattice Modifier 


The Lattice modifier deforms the base object according to 
the shape of a Lattice object. 


Tip 


A Lattice Modifier can quickly be added to selected objects 
by selecting them all, then selecting the lattice object last 
and pressing Ctri-P and choosing Lattice Deform. This will 
both add Lattice Modifiers to the selected objects and 
parent them to the lattice. 


See also 


This documentation refers to the Lattice Modifier specific 
to the Grease Pencil object. For uses with other object 
types refer to the general Lattice Modifier. 


Options 


Object + A tattice mG. x 
The Lattice object with 
which to deform the base 
object. 


Object @ Lattice 


Vertex Group && 


Strength 


Ve rtex Group > Influence 
Restricts the effect only 
to a vertex group. Lattice Modifier. 


Strength 


A factor to control blending between original and 
deformed points positions. 


Influence 


See Influence Filters. 


Example 


Lattice modifier example. 


Original model. After lattice edition. 


Noise Modifier 


The Noise Modifier changes the value of one or more 
stroke/points properties like: location, strength, thickness or 
UV texture position by adding varied values that make the 
line unstable and noisy. 


Random values can be used for the noise factor for more 
vivid effects. 


Options 
Position ¢ Noise 
Strength of the noise oe 
effect over the point sen 
location. Thickness 
UV 
Strength Noise Scale 
Strength of the noise Noise Offset 
effect over the point Noise Seed 


strength (opacity). 


¥ Randomize 


Thickness cd 
Strength of the noise Sie 
effect over the point Influence 
thickness. 


UV Noise Modifier. 


Strength of the noise 
effect over the point UV 
rotation. 


Noise Scale 


Control the noise frequency scale. 


Noise Offset 
Moves the noise along the strokes. 


Seed 
Seed used by the pseudo-random number generator. 


Randomize 


When enabled, the noise uses a random value over time. 


Mode 
Steps 
New random value at defined steps. 


Step 
Number of frames before using a new random 
value. 


keyframes 
New random value only on keyframes. 


Influence 


See Influence Filters. 


Offset Modifier 


The Offset Modifier changes the strokes location, rotation or 
scale starting from the object origin. 


Options 


Location X, Y, Z 
Sets strokes location 
offset from its object 
origin. 
Rotation X 
Rotation X, Y, Z 
Sets strokes rotation. 


cale X 0.00000 
Scale X, Y, Z Y 0.00000 
Sets strokes scale. 0.00000 


» Influence 


Offset Modifier. 


Randomize 


Offset X, Y, Z 
Add random offset values to the strokes. 


Rotation X, Y, Z 
Add random rotation values to the strokes. 


Scale X, Y, Z 
Add random scale values to the strokes. 


Uniform Scale 
Use the same random Seed for each scale axis in the 
strokes for a uniform scale. 


Seed 
Seed used by the pseudo-random number generator. 


Influence 


See Influence Filters. 


Shrinkwrap Modifier 


The Shrinkwrap modifier allows a Grease Pencil object to 
“shrink” to the surface of another object. It moves each 
point of the object being modified to the closest position on 
the surface of the given mesh. 


See also 


Shrinkwrap Constraint. 


See also 


This documentation refers to the Shrinkwrap Modifier 
specific to the Grease Pencil object. For uses with other 
object types refer to the general Shrinkwrap Modifier. 


Options 

W Shrinkwrap [Ea iy x 
be Wrap Method Nearest Surface Poin v 
p 

M Snap Mode On Surface v 
et Target @ 

h Offset 0.05 m 

"i Smooth Factor 0.050 


Repeat 1 


> Influence 


The Shrinkwrap modifier in Nearest Surface Point mode. 


This selector specifies the method to be used to 
determine the nearest point on the target’s surface for 
each point of the modified object. Some options will add 
some extra, specific controls to the panel. See Wrap 
Methods for an explanation of each method. 


Snap Mode 
Most modes support an additional setting to control how 
the point is moved to the target point selected by the 
methods described above. Some of the choices only 
differ if Offset is not zero. 


On Surface: The point is always moved. The offset 
is applied along the projection line 
connecting the original point and 
selected target point towards the 
Original position. 

Inside: The point is not moved if it is already 
inside the target. Offset shrinks the 
allowed volume towards the inside 
along the projection line. 

Outside: The point is not moved if it is already 
outside the target. Offset expands the 
exclusion volume towards the outside 
along the projection line. 

Outside Surface: 

Like On Surface, but the offset is 
always applied towards the outside of 
the target. 

Above Surface: 

Like On Surface, but the offset is 
applied along the smooth normal of the 
target. 


Note 


The Inside and Outside options can be used for very 
crude collision detection. The inside vs outside 
determination is done based on the target normal and 
is not always stable near 90 degree and sharper angles 
in the target mesh. 


Target 
Shrink target, the mesh to shrink to/wrap around. 


Offset 


The distance that must be kept from the calculated 
target position. 


Smooth Factor 
Amount of smoothing to apply. 


Repeat 
The number of time to apply smoothing. 


Influence 


See Influence Filters. 


Wrap Methods 


Nearest Surface Point 


This will select the nearest point over the surface of the 
Shrunk target. 


Project 


This will project vertices , Shrinkwap [eSimi. x 
along a chosen axis until 
they touch the shrink 


Wrap Method Project 


target. Vertices that never a OC SuTace 
touch the shrink target are Limit Om 
left in their original position. Subdivision Le... 0 
Limit Axis X Y 
This is a distance limit becca 
between original point ae teats 
and surface. If the Face Cull Off Front 
distance is larger than 
this limit point would not Target 
be projected onto the Beery ee 
surface. 
Offset 0.05 m 
Subdivision Levels Smooth Factor 0.050 
This applies a Repeat 1 
(temporary) Catmull- 
Clark subdivision to the bella 
modified object’s 
geometry, before Project mode. 


computing the wrap. 


Axis 
Along which local axis of the modified object the 
projection is done. These options can be combined with 
each other, yielding a “median axis” of projection. If none 
are selected, the normal direction is used. 


Negative/Positive 
This allows you to select the allowed direction(s) of the 
shrink along the selected axis. If both options are 
enabled, both ways are evaluated and the closest hit is 
selected. 


Face Cull 
Allows you to prevent any projection over the “front side” 
(respectively the “back side”) of the target’s faces. The 
“side” of a face is determined by its normal (front being 
the side “from where” the normal “originates”). 


Invert Cull 
If Cull Faces is enabled, and Negative direction along axis 
is allowed, this option can be used to invert the Front or 
Back cull choice for the Negative direction. This is useful 
when projecting in both directions. 


Auxiliary Target 
An additional object to project over. 


Nearest Vertex 


This will snap vertices to the nearest vertex of the shrunk 
target. It adds no extra options. 


This method doesn’t support the Snap Mode setting. 
Target Normal Project 


This mode is similar to Nearest Surface Point, but produces 
a much smoother projection in return for being significantly 
slower. 


Instead of finding the closest point, it searches for the 
nearest point that has its interpolated smooth normal 
pointing towards or away from the original point position. 
Non-manifold boundary edges are specially handled as 
infinitely thin cylinders that emit normals in all 
perpendicular directions. Ignores flat shading and auto 
smooth settings. 


Smooth Modifier 


The Smooth Modifier changes the value of one or more 
stroke/points properties like: location, strength, thickness or 
UV texture position trying to maintain similar values that 
make the line fluid and smoother. 


Options 
Affect {Smooth i i v 
Combination of Position Strength Thickness UV 
stroke/points properties eet ie 
that will be affected by ae ; 
the smooth factor. antes 
Position Influence 
Smooth affect the 
point location. Smooth Modifier. 
Strength 


Smooth affect the 
point strength (opacity). 


Thickness 
Smooth affect the point thickness. 


UV 
Smooth affect the point UV rotation. 


Factor 
Strength of the smooth effect. 


Repeat 


The number of smoothing iterations, equivalent to 
executing the Smooth tool multiple times. High values 
can reduce the animation performance (FPS). 


Keep Shape 
When enabled, the smoothing algorithm will try to 
maintain as close as possible the overall shape of the 
Original stroke. 


Influence 


See Influence Filters. 


Thickness Modifier 


The Thickness Modifier change the stroke points thickness. 
Options 


Uniform Thickness ¥ @ Thickness SmeG@. x 
When enabled, makes 
the thickness equal for 
the entire strokes. 


Uniform Thickness 


Thickness Factor 1.000 


® Influence 


Thickness 
Absolute Thickness Thickness Modifier. 
for the stroke points. 


Thickness Factor 
Value to add or subtract to the actual points thickness. 


Influence 


See Influence Filters. 


Color 


e Hue/Saturation Modifier 
e Opacity Modifier 
e Tint Modifier 


Hue/Saturation Modifier 


The Hue/Saturation Modifier applies a color transformation 
to the object output color. 


Options 

Mode y (J%  Hue/Saturation ii@o.~ x 
The color transformation eT Soke and Fill = 
will be applied on the 8500 
stroke and/or the fill een Boo 
color. Value 1.000 
Stroke & Fill, Stroke, Fill ~ be 

Hue Hue/Saturation Modifier. 


Specifies the hue 

rotation of the image. 

360° are mapped to (0 to 1). The hue shifts of 0 (-180°) 
and 1 (+180°) have the same result. 


Saturation 


A saturation of 0 removes hues from the image, resulting 
in a grayscale image. A shift greater than 1.0 increases 
saturation. 


Value 


Value is the overall brightness of the image. 
De/Increasing values shift an image darker/lighter. 


Influence 


See Influence Filters. 


Opacity Modifier 


The Opacity Modifier change the opacity (alpha) value of the 
stroke points. 


The alpha value in Grease Pencil is stored per-point. The 
modifier can alter these values to go from totally 
transparent points to totally opaque points. 


Options 

Mode v Opacity i?mOoOr~ x 
The color transformation Mode Stroke and Fill 
will be applied to the Uniform Opacity 
stroke/fill color or stroke Opaciey Factor oT 


Hardness. When 
Hardness is selected the 
opacity affects the a 
stroke’s transparency Opacity Modifier. 
(aloha) from the center to 

the border. 


® Influence 


Stroke & Fill, Stroke, Fill, or Hardness 


Uniform Opacity 


When enabled, makes the opacity equal for the entire 
strokes. 


Strength 
Absolute opacity for the stroke points. 


Opacity Factor 


Controls the opacity value of the stroke points. A value of 
1.0 respect the original alpha value of the points, a shift 
less than 1.0 make the points more transparent than 
originally, and a shift greater than 1.0 make the points 
more opaque than originally. 


Sets value to 2.0 makes the points alpha fully opaque. 
Influence 


See Influence Filters. 


Example 
Opacity Factor samples. 
Opacity Opacity 
te Factor: 1.0 Factor: 2.0 
actor: . 
0.3. (original (fully 


alpha). Opaque). 


Tint Modifier 


The Tint Modifier colorize the original stroke or fill with a 
selected color. 


Options 

Mode * Tint mo. x 
The color transformation Mode Stroke and Fill 
will be applied on the Strength BEG 
stroke and/or the fill — 
poh a, TS - 


Stroke & Fill, Stroke, Fill > Influence 


Strength Tint Modifier. 
Controls the amount for 
the color mixing. 


A value of 0 respect the original stroke’s color, a value of 
1.0 totally replace the original color with the tint color. 


A shift greater than 1.0 will make the points alpha less 
transparent than originally (2.0 is fully opaque). 


Tint Type 
Uniform 
Color 
Defines the tint color for mixing with the original 
color. 


Gradient 
Color Ramp 


Defines the tint gradient color for mixing with the 
Original color. For controls see Color Ramp Widget. 


Object 
A Data ID to select an object (usually an empty), 
which position and rotation will be used to define 
the center of the effect. 


Radius 
Defines the maximum distance of the effect. 


Influence 


See Influence Filters. 


Example 


Tint uniform color sample. 


Strength: Strength: 
0 (original oe 1.0 (fully 
color). ~ tinted). 


Tint gradient color sample. 


Radius: 1, 
Strength: 
1. 


C92 
\) 


Radius: 5, 
Strength: 
1. 


Radius: 
10, 
Strength: 
ie 


Modify 


e Texture Mapping Modifier 

e« Time Offset Modifier 

e Vertex Weight Angle Modifier 

e Vertex Weight Proximity Modifier 


Texture Mapping Modifier 


The Texture Mapping Modifier change the strokes texture UV 
position. 


Options 
M od e . TextureMapping ig mor x 
Th e textu re Mode Stroke 
tra nsfo rmation wi I] be Stroke Fit Method Constant Length 
applied to the stroke/fill UV Offset 0.000 
or stroke UVs. Rotation 0° 
Scale 
Stroke 


» Influence 


Stroke Fit Method 


Selects the texture 


Texture Mapping. 
fitting method. ee 


Constant Length 


The texture keep a consistent length along the 
strokes. 


Stroke Length 
The texture is normalized to fit the stroke 
length. 


UV Offset 
Moves the texture along the strokes. 


Rotation 
Rotates the points of the strokes. 


Note 
The Rotation option is limited to a range of -90 to 90 
degrees. 


Scale 
Factor for the texture scale. 


Fill 
Fill Rotation 
Sets the texture angle. 


Offset 
Moves the texture origin. 


X, Y 


Scale 
Factor for the texture scale. 


Influence 


See Influence Filters. 
Example 


Opacity Factor samples. 


—s YS | il \ 1 


\\ 


cui} 


Rotation: Rotation: Rotation: 
0°. AD. 90°. 


Time Offset Modifier 


The Time Offset Modifier applies a temporal offset to Grease 
Pencil keyframes on your timeline. If you have duplicated a 
Grease Pencil object you can use the Time Offset Modifier on 
the copies to desynchronize their animation. This can give 
more natural looking results. 


Using the Time Offset Modifier it’s possible to have Grease 
Pencil frame ranges play back as repeating loops. 
Traditionally, 2D animation that uses looped drawings 
includes characters walking, rising smoke, and falling rain. 
In Fixed Frame mode the Time Offset Modifier can display 
drawings on your timeline entirely independently of the 
playhead position. 


Using the Time Offset Modifier it’s possible to have Grease 
Pencil frame ranges play back as repeating loops. 
Traditionally, 2D animation that uses looped drawings 
includes characters walking, rising smoke, and falling rain. 
In Fixed Frame mode the Time Offset Modifier can display 
drawings on your timeline entirely independently of the 
playhead position. 


This can be handy for displaying drawings that will appear 


often in your animation. Think of switching between 
predefined mouth shapes for instance. 


Options 


Mode 
Regular 


Offsets keyframes in + @  Timeoftset mim. x 


the default animation P= 
playback direction Petes Gree: 7 
(playhead moving Scale 1.000 


from left to right). i Keen 1000 


Custom Range 


Reverse 
Offsets keyframes in 
reversed animation 
playback direction > Influence 
(playhead moving 
from right to left). Time Offset Modifier. 


Fixed Frame 


The Frame parameter 

determines which frame is displayed. This value needs 
to be animated in order to have the displayed frame 
change during playback. 


Frame 
The number of the frame to display. 


Ping Pong 
Loop back and forth animation. 


Chain 
It allows to combine the different Modes consecutively. 


Repeat 
Number of cycle repeats 


Frame Offset 
The number of frames to offset the original keyframes by. 


Scale 


Controls the speed of the frames playback. 1 is equal to 
the actual frame rate, could be positive (faster) or 
negative (slower). 


Keep Loop 
Moves end frame to the animation start to keep 
animation in a loop. 


Custom Range 


When enabled, the animation playback is restricted only to 
a frame range. 


Frame Start/End 
Sets the range start and end frames. 


Influence 


See Influence Filters. 


Vertex Weight Angle 
Modifier 


This modifier sets the weights of the given vertex group, 
based on a predetermined angle. 


Warning 
This modifier does implicit clamping of weight values in 


the standard (0.0 to 1.0) range. All values below 0.0 will be 
set to 0.0, and all values above 1.0 will be set to 1.0. 


Options 


Vertex Weight Angle 


Vertex Group is 


Angle 


Space 
Minimum 0.000 
Multiply Weights 


> Influence 


The Vertex Weight Proximity modifier panel. 


Vertex Group 
The vertex group to affect. 


Invert <--> 


Inverts the influence of the selected vertex group. The 
setting reverses the weight values of the group. 


Angle 
Sets the angle for the maximum weights value. 


Axis 
The axis along which the angle affects the weights. 


) as Ga 


Space 
Coordinate space to be used. 


Minimum 
Minimum value for vertex weight. 


Multiply Weights 


Multiply the calculated weights with the existing values in 
the vertex group. 


Influence 


See Influence Filters. 


Vertex Weight Proximity 
Modifier 


This modifier sets the weights of the given vertex group, 
based on the distance between the object (or its vertices), 
and another target object (or its geometry). 


Warning 


This modifier does implicit clamping of weight values in 
the standard (0.0 to 1.0) range. All values below 0.0 will be 
set to 0.0, and all values above 1.0 will be set to 1.0. 


See also 


This documentation refers to the Vertex Weight Proximity 
Modifier specific to the Grease Pencil object. For uses with 
other object types refer to the general Vertex Weight 
Proximity Modifier. 


Options 
Vertex Group 
The vertex group to affect. 


Invert <--> 
Inverts the influence of the selected vertex group. The 
setting reverses the weight values of the group. 


Target Object 


The object v Vertex Weight Proximity Tl v x 
from which 


Vertex Group & 
to compute Target Object 
distances. Lowest 0.00 
Highest 20.00 
Lowest ie 
. Minimum 0.000 
Distance re 
. Multiply Weights 
mapping to 
0.0 weight. > Influence 
Highest The Vertex Weight Proximity modifier panel. 
Distance 


mapping to 
1.0 weight. 


Minimum 
Minimum value for vertex weight. 


Multiply Weights 
Multiply the calculated weights with the existing values in 
the vertex group. 

Influence 


See Influence Filters. 


Visual Effects 


e Introduction 
o Interface 


Types 


Blur Visual Effect 

Colorize Visual Effect 

Flip Visual Effect 

Glow Visual Effect 

Pixelate Visual Effect 

Rim Visual Effect 

Shadow Visual Effect 

Swirl Visual Effect 

Wave Distortion Visual Effect 


Introduction 


Reference 


Panel: Properties > Visual Effects 


Grease Pencil has a special set of viewport real-time visual 
effects that can be apply to the object. 


These effects treat the object as if it was just an image, for 
that reason they have effect on the whole object and cannot 
limit their influence on certain parts like layers, materials or 
vertex group as with modifiers. Also unlike modifiers, they 
can not be applied to the object. 


Their main purpose is to have a quick way to apply visual 
effects on your drawings like blurring, pixelation, wave 
distortion, among others. 


Note 


Visual Effects best fit for quick viewport visualization. You 
can use it for final renders but if you want more precision 
with effects it is still recommended to use the Compositor. 


Interface 


Pixelate =| x 
Blur ic x 


Samples 8 
Use Depth of Field 


50.000 
50.000 


Rotation 0° 


Panel layout (Blur effect as an example). 


The visual effects panels and interface are similar to 
modifiers. Each effect shares the same basic interface 
components similar to modifiers for meshes. 


See Modifiers Interface for more information. 


Blur Visual Effect 


The Blur Visual Effect applies a Gaussian blur to the object. 
Options 
Samples + $t Blur =o x 


Number of blur samples (0 
disabled the blur effect). 


Samples 8 


Use Depth of Field 


50.000 


Use Depth of Field : exGG6 
When enabled, the blur Rotation 0° 
effect uses the focal plane 
distance of the actual 
camera to calculate the 
object blur. Only available in 
camera view. 


Blur Visual Effect. 


Size 
Control the blur scale in pixels on the X and Y axis. 


X, Y 


Rotation 
Control the Rotation of the blur. 


Example 


Blur Effect samples (Samples: 8). 


? 2 ¢ 


Original 
Model. 


Colorize Visual Effect 


The Colorize Visual Effect applies different preset colorizing effects to the 
object. 


Options 
M od e ¥ 7; © Colorize 
Grayscale Mode Gray Scale 
Converts to a grayscale image. Factor 
Sepia 


Blur Visual Effect. 


Converts to a sepia tone image. 


Duotone 
Converts to a posterize image with high contrast and brightness. 


Low Color 
Primary color. 


High Color 
Secondary color. 


Transparent 
Add color transparency. 


Custom 
Allows to define a tint custom color. 


Color 
Sets the tint color. 


Factor 
Control the mix value. 


Example 


Colorize Effect samples. 


Mode: Duotone. Mode: 


Grayscale. 
Transparent. 


Flip Visual Effect 


The Flip Visual Effect shows the object flipped horizontally 
and/or vertically. 


Options 
Axis vo =O x 
Which axis or axes to flip axis (QBSRSERENIN |” Vertical 


the object about. 


Flip Visual Effect. 


Horizontal 
When enabled, shows 
the object flipped 
horizontally. 


Vertical 
When enabled, shows the object flipped vertically. 


Glow Visual Effect 


The Glow Visual Effect add a glowing rim around the object. 


Options 
Mode Luminance 
Threshold 0.100 . 
Blend Mode Regular 
Glow Under 
Glow Visual Effect. 
Mode 
Determines the mode for the glow effect. 
Luminance: The glow light illuminates the entire object. 
Color: The glow light only affect a single color. 


Select Color 
Allows to select a single color to apply the glow 
light. 


Threshold 


Limits the colors affected by the glow light. (A value of 1 means no 
colors affected.) 


Glow Color 
Defines the glow color. 


Blend Mode 
The mask blending operation to perform. See Color Blend Modes. 


Opacity 
Control the Opacity of the glow over the object. 


Size X, Y 
Control the glow scale in pixels on the X and Y axis. 


Rotation 
Control the Rotation of the glow. 


Samples 
Number of Blur samples (0 disabled the blur effect). 


Glow Under 
When enabled, glow only affects alpha areas. 


Example 


Glow Effect samples. 


~~ C A 5 
? 

Mode: 

Original Mode: Color 

image. Mode: Luminance (Black 

Luminance. (Glow lines). 


Under). 


Pixelate Visual Effect 


The Pixelate Visual Effect shows the object as a pixelated 
image. 


Options 

Size X, Y vit mim x 
Horizontal and vertical ae 
size of the final pixels to 5 px 
a pply. ¥ Antialiasing 


Anti-aliasing . 
Applies an anti-aliasing Pixelate Visual Effect. 


effect to the resulting 
pixels. 


Example 


Pixelate Effect samples. 


Size: Size: Size: 
Original 20 100 200 
image. DX. DX. DX. 


Rim Visual Effect 


The Rim Visual Effect shows a simulated rim light on the 
object contour. 


For simulating the rim light, a masked color silhouette of the 
object is displaced in horizontal and/or vertical direction. 


Many blending modes can be applied to the resulting mask. 


Options 
Rim Color Fe Rim me x 
Defines the rim light | 
color. 
Mask Color . 
Mask Color Blend Mode Overlay 


Defines a color to keep 
unaltered. 


Blend Mode 
The mask blending 
operation to perform. 
See Color Blend Modes. 


Offset X, Y Rim Visual Effect. 


Control the color mask 
displacement in pixels 
on the X and Y axis. 


Blur 


Blur X, Y 


Control the blur scale in pixels on the X and Y axis. 


Samples 
Number of blur samples (0 disabled the blur effect). 


Example 


Rim Effect samples (Mode: Add). 


- ft «+ 


Original tui Blur. color: 
image. Black. 


Shadow Visual Effect 


The Shadow Visual Effect shows a simulated shadow casting 
by the object. 


For simulating the shadow a color silhouette of the object is 
displaced in horizontal and/or vertical direction on the back 
of the object. 


Options 


Shadow Color v yo Shadow 
Defines the shadow 
color. 


Shadow Color 


Offset X 


Offset X, Y 
Control the shadow 
displacement in pixels Sele 
on the X and Y axis. er ee 

Scale X, Y ¥ Blur 
Control the size of the 
shadow on the X and Y 
axis. 


Rotation 
Sets the shadow rotation 
around the Grease Pencil 
object center or another 
object when Use Object 
As Pivot is enabled. 


Shadow Visual Effect. 
Object Pivot 


When enabled, an Object 
is used by the shadow as the center of rotation. 


Blur 


Blur X, Z 
Control the blur scale in pixels on the X and Z axis. 


Samples 
Number of blur samples (0 disabled the blur effect). 


Wave Effect 


When enabled, apply a wave distortion to the shadow. 


Orientation 
Sets horizontal or vertical direction for the waves. 


Amplitude 
Controls the strength and the depth of the wave. 


Period 
Controls the wave period. The time it takes to complete 
one cycle. 


Phase 
Shifts the wave pattern over the shadow. 


Example 


Shadow Effect samples. 


Simple 


Shadow. 


Blurred 
Shadow. 


Stretched 
shadow 
with an 
empty as 
center of 
rotation. 


Swirl Visual Effect 


The Swirl Visual Effect applies a swirling pattern to the 
object. The effect use an object as the center of the swirl. 


Options 


Object yo Swirl =o x 
Sets the object to use as SE wr Emety 
the center of the swirl. Pais TOUR 


Angle 90° 


Radius 


External radius size of the 
swirl. Swirl Visual Effect. 


Angle 
Rotation angle of the swirl. A value of 0 shows no swirl. 


Example 


Swirl Effect samples (with a Radius of 100 px). 


2 2 


Wave Distortion Visual Effect 


The Wave Distortion Visual applies a wavy effects to the object. 
Options 


Orientation 


Sets horizontal or vertical direction for the 
waves. 


Vertical 


Amplitude 
Controls the strength and the depth of the 
wave. 


. Wave Distortion Effect. 
Period 


Controls the wave period. The time it takes to 
complete one cycle. 


Phase 
Shifts the wave pattern over the Object. 


Example 


Wave Distortion Effect samples. 


10 30 10 30 
(horizontal). (horizontal). (vertical). (vertical). 


Materials 


e Introduction 
o Grease Pencil Shader 
o Setting Up Materials 
o Grease Pencil Shader 
e Properties 
o Surface 
o Settings 


Introduction 


Materials control the appearance of the Grease Pencil 
object. They define the base color and texture of the strokes 
and filled areas. 


There is always only one active material in the list (the 
selected one). When you draw, the new strokes use the 
active material. 


You can override the base material color using the tools in 
Vertex Mode or the Draw and Tint tool in Draw Mode. 


The material always remains linked to the strokes, this 
means that any change in a material will change the look of 
already drawn strokes. 


Same stroke linked to different materials. 


Grease Pencil Shader 


The Grease Pencil shader creates a material that can work 
with strokes and/or filled areas of a Grease Pencil object. 


Stroke and fill components has it own section panel and 
they can be enabled with a checkbox on the panel header. 


Stroke only has effect on the lines and Fill only on the areas 
determined by closed lines (by connecting the lines start 
and end points). 


Note 


The shader is not yet a BSDF capable shader and can only 
be setting up on the Material Properties panel (it is nota 
shader node). 


Setting Up Materials 


Reference 

Mode: Drawing Mode 

Panel: Material >» Material Slots 
Shortcut: U 


Grease Pencil materials can be created in the Material 
properties as any other materials in Blender. See Material 
assignment for more information. 


The 3D Viewport can be set to Material Preview or Rendered 
shading, to interactively preview how the material looks in 
the scene. 


Grease Pencil materials are data-blocks that can be 
assigned to one or more objects, and different materials can 


be assigned to different strokes. 


In Grease Pencil the brush settings together with the 
material used will define the look and feel of the final 
strokes. 


Materials slots in the List view also have some extra controls 
that help to work with materials while drawing or editing 
lines. 


Common Settings 


Next to the material 


Solid Stroke 


name there are three Squares Stroke 
icons buttons that Solid Fil 
control common Dots Stroke 
properties of the 

material: 

Lock (padlock icon) Solid Stroke 


Toggle material from 


being editable. Grease Pencil material slots panel. 


Viewport/Render 
Visibility (eye icon) 
Toggle material visibility in the viewport and in render. 


Onion Skinning (onion skin icon) 
Toggle the use of the material for Onion Skinning. 


Specials 


Show All 
Turns on the visibility of every material in the list. 


Hide Others 


Turns off the visibility of every material in the list except 
the active one. 


Lock All 
Locks edition of all the materials in the list. 


Unlock All 
Unlocks edition of all the materials in the list. 


Lock Unselected 
Locks all materials not used in the selected strokes. 


Lock Unused 
Locks and hides all unused materials. 


Convert Materials to Vertex Color 
Only keeps necessary materials and convert all materials 
base color to a Color Attribute. 


Extract Palette from Vertex Color 
Add all used Color Attributes to a new Color Palette. See 
Color Palette. 


Copy Material to Selected 
Copy the active material to the selected Grease Pencil 
object. 


Copy All Materials to Selected 
Copy all materials to the selected Grease Pencil object. 


Merge Similar 
Combines similar materials in the list and replace the 
strokes that use the one of the merged materials with the 
new one. 


Remove Unused Slots 
Remove all unused materials. 


Lock & Visibility General Controls 


Lock (padlock icon) 
Toggle whether the active material is the only one that 
can be edited. 


Visibility (screen icon) 


Toggle whether the active material is the only one that 
can be edited and is visible. 


Grease Pencil Shader 


Grease Pencil materials use a special shader that define the 
appearance of the surface of the stroke and fill. 


Properties 


Surface 


Y Surface 
Y ™ Stroke 
Mode Type Line 
Style Solid 
Color 


Self Overlap 


Style Solid 


Color 


Shader panel with only Stroke component activated. 


Stroke 


When enabled, the shader use the stroke component. The Stroke 
component controls how to render the edit lines. 


Line Type 
Defines how to display or distribute the output material over the 
stroke. 


Line 
Connects every points in the strokes showing a continuous 
line. 


Dots 
Use a disk shape at each point in the stroke. The dots are not 


connected. 


Squares 


Use a square shape at each point in the stroke. The squares 
are not connected. 


Style 
The type of the material. 


Solid 
Use a solid color. 


Base Color 
The base color of the stroke. 


Texture 
Use an image texture. 


Base Color 
The base color of the stroke. 


Image 
The image data-block used as an image source. 


Blend 
Texture and Base Color mixing amount. 


UV Factor 
The image size along the stroke. 


Holdout 
Removes the color from strokes underneath the current by 
using it aS a mask. 


Alignment 


Defines how to align the Dots and Squares along the drawing 
path and with the object’s rotation. 


Path 
Aligns to the drawing path and the object’s rotation. 


Object 
Aligns to the object’s rotation; ignoring the drawing path. 


Fixed 
Aligns to the screen space; ignoring the drawing path and 


the object’s rotation. 


Rotation 
Rotates the points of Dot and Square strokes. 


Note 
The Rotation option is limited to a range of -90 to 90 degrees. 


Self Overlap 
Disables stencil and overlap self-intersections with alpha 


materials. 
Samples of different material strokes mode types and styles. 


ae REDD Rey RY 
\) (o) i) ) 
Mode Mode Mode Mode 
Type: Type Type Type: 
Line, Line, Dot, Dot, 
Style: Style: Style: Style: 
Solid. Texture. Solid. Texture. 


Fill 


When enabled, the shader use the fill component. The Fill 
component control how to render the filled areas determined by 


closed edit lines. 


Style 
The type of material. 


Solid 
Use solid color. 


Base Color 
The base color of the fill. 


Gradient 
Use a color gradient. 


Gradient Type 
Linear 
Mix the colors along a single axis. 


Radial 
Mix the colors radiating from a center point. 


Base Color 
The primary color. 


Secondary Color 
The secondary color. 


Blend 
Base Color and Secondary Color mixing amount. 


Flip Colors 
Flips the gradient, inverting the Base Color and Secondary 
Color. 


Location 
Shifts the gradient position. 


X, Y 


Rotation 
Rotates the gradient. 


Scale 
Scales the gradient. 


X, Y 


Texture 


Use an image texture. 


Base Color 
The base color of the fill. 


Image 
The image data-block used as an image source. 


Blend 
Texture and Base Color mixing amount. 


Location 
Shifts the image position. 


x Y 


Rotation 
Rotates the image. 


Scale 
Scales the image. 


KY. 


Clip Image 
When enabled, show one image instance only (do not 
repeat). 


Holdout 
Removes the color from strokes underneath the current by 
using it aS a mask. 


Samples of different material fill styles. 


= 


Style: 


Solid. Style: Style: Style: 
Gradient Gradient Texture. 


Os 


x 


(Linear). (Radial). 


Settings 


Pass Index 
This index can be used with some modifiers to restrict changes 
to only a certain material. See Modifiers for more information. 


Animation 


e Introduction 

o Animating with Grease Pencil 

o 2D Traditional Animation 

o Animation Options 

o Examples 
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o Interpolate 

o Interpolate Sequence 
e Animation Tools 

o Insert Blank Keyframe 
Duplicate Active Keyframe 
Delete Active Keyframe 
Interpolate Sequence 
Bake Mesh to Grease Pencil 
Bake Object Transform to Grease Pencil 
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Introduction 


Animating with Grease Pencil 


The main goal of Grease Pencil is to offer a 2D animation 
tool full immersed in a 3D environment. 


» &\y) Gia Ha v-& 
12 


Sr A 2 A A 2 
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Sample animation showing Grease Pencil object 
keyframes in the Dope Sheet with onion skinning 
enabled. 


In Blender, Grease Pencil objects can be animated in many 
ways: 


Moving as a whole object 
Changing their position, orientation or size in time; 


Drawing frame by frame 
Drawing one frame at a time (traditional animation). 


Deforming them 
Animating their points; 


Inherited animation 
Causing the object to move based on the movement of 
another object (e.g. its parent, hook, armature, etc.). 
Useful for cut-out animation for example. 


For a complete overview of animation in Blender please 
refer to the Animation & Rigging chapter. 


2D Traditional Animation 


Keyframes 


Traditional animation in Grease Pencil is achieved with the 
use of keyframes that hold the strokes information at a 
particular frame or frame range. 


With Auto keyframe activated, every time you create a 
stroke in Grease Pencil object Draw Mode a new keyframe is 
added at the current frame on the active channel. With Auto 
keyframe deactivated, you will have to add manually a new 
keyframe or your new strokes will be added on the active 
keyframe. 


See Keyframe Editing for more information. 


Note 


The channels in the Dope Sheet correspond to the active 
2D layer of the Grease Pencil object. 


Grease Pencil has its own mode in the Dope Sheet to work 
with keyframes. See Grease Pencil mode in the Dope Sheet 
section for more information. There are also several tools on 
the Stroke menu to work with keyframes and strokes. See 
Animation tools for more information. 


Onion Skinning 


One key element in traditional animation is the use of onion 
Skinning. Grease Pencil offer a lot of flexibility and options 
for this tool. See Onion Skinning for more information. 


Animation Options 


Draw Mode 


In Draw Mode there are three options related to the 
animation workflow that you can use. 


# Oraw v @ oh & AC V 


General drawing/animation options. 


Add Weight Data 
When enabled, new strokes weight data is added 
according to the current vertex group and weights. If 
there is no vertex group selected, no weight data is 
added. 


This is useful for example in cut-out animation for adding 
new drawing on the same vertex group without the need 
to creating it afterwards. 


See Weight Paint Mode for more information. 


Additive Drawing 


When creating new frames, the strokes from the 
previous/active frame are include as a basis for the new 
one. 


Multiframe 


If you need to add new strokes to your animation on 
several frames you can use multiframe drawing. 


You can activate multiframe drawing with the Multiframe 
button next to the modes selector (faded lines icon). See 
Multiframe for more information. 


Edit Mode 


In Edit Mode there is an option related to the animation 
workflow that you can use. 


* Edit Mode 


Multiframe edition. 


Multiframe 
Sometimes you may need to modify several frames at 
the same time with edit tools, for example to 
repositioning drawings in an animation. 


You can activate multiframe edition with the Multiframe 
button next to the modes selector (faded lines icon). See 
Multiframe for more information. 


Examples 


Traditional Animation 


This example shows you how to animate a bouncing ball 
with a traditional 2D animation technique and Grease Pencil. 


First, go to menu File » New > 2D Animation to start with a 
new 2D animation template. The template is ready to quick 
start your animation with a Grease Pencil object already 
created, Onion Skinning activated, Auto Keyframe enabled 
and in camera view. 


1. Set the range of the animation in the Timeline from 1 to 
24. 

2. In the 3D Viewport draw a ball on the upper left corner 
with the Draw Tool (extreme). 

3. Move to frame 12 and draw a squashed ball in the 
bottom center (breakdown). 

4. Move to frame 24 and draw a ball in the top right corner 
of the 3D Viewport (extreme). 

5. Keep drawing all the inbetween frames you want using 
the onion skinning ghost as a reference. 


To test the animation, press Spacebar to play. 


Interpolation 


Interpolate 

Reference 

Mode: Draw and Edit Modes 
Tool: Toolbar > Interpolate 
Shortcut: Ctrl-E 


When you are animating simple shapes you can use the 
interpolate tool to automatically add new breakdown 
keyframes. 


See Interpolate tool for more details. 


Interpolate Sequence 


Reference 

Mode: Draw and Edit Modes 
Menu: Header > Interpolate 
Shortcut: Shift-Ctrl-E 


Interpolate strokes between the previous and next keyframe 
by adding multiple keyframes. When you are on a frame 
between two keyframes and click the sequence button a 
breakdown keyframe will be added on every frame between 
the previous and next keyframe. 


Step 


The number of frames between generated interpolated 
frames. 


Layer 
Restrict the interpolation to Active or All layers. 


Only Selected Edit Mode 
When enabled, only selected strokes will be interpolated. 


Flip Mode 
Invert strokes start and end. Automatic will try to found 
the right mode for every stroke. 


Smooth 
Amount of smoothing to apply to interpolated strokes for 
reducing jitter/noise. 


Iterations 
Number of time to smooth newly created strokes. 


Type 
Interpolation method to use for the sequence. 


Anitmation Tools 


Insert Blank Keyframe 


Reference 

Mode: Draw Mode, Edit Mode, Sculpt Mode 

Menu: Stroke >» Animation > Insert Blank 
Keyframe (Active Layer) Stroke > 
Animation » Insert Blank Keyframe (All 
Layers) 

Shortcut: Shift-I 


Active Layer 


Add a new blank keyframe to the active layer at the 
current frame. If there is already a keyframe at the 


current frame, a new blank keyframe will be added on 
the next frame. 


All Layers 


When enabled, Blank keyframe will be created on all 
layers, not only the active one. 


Duplicate Active Keyframe 


Reference 


Mode: Draw Mode, Edit Mode, Sculpt Mode 
Menu: 


Stroke » Animation » Duplicate Active 
Keyframe (Active Layer) Stroke > 
Animation » Duplicate Active Keyframe 
(All Layers) 


Duplicates the strokes on the last keyframe by copying 
them to the current frame. 


Mode 
Active 
Duplicate only the active layer. 


All 
Duplicate all the layers. 


Delete Active Keyframe 


Reference 

Mode: Draw Mode, Edit Mode, Sculpt Mode 

Menu: Stroke >» Animation » Delete Active 
Keyframe (Active Layer) Stroke > 
Animation » Delete Active Keyframes (All 
Layers) 

Shortcut: Shift-X 


Deletes the last keyframe in the Dope Sheet or the current 
keyframe if you are on one. 


Interpolate Sequence 


Reference 


Mode: Draw Mode, Edit Mode 
Menu: Grease Pencil > Interpolate Sequence 
Shortcut: Shift-Ctrl-E 


Interpolate strokes between the previous and next keyframe 
by adding multiple keyframes. A breakdown keyframe will 
be added on every frame between the previous and next 
keyframe. 


Bake Mesh to Grease Pencil 


Reference 

Editor: 3D Viewport 

Mode: Object and Pose Modes 

Menu: Object >» Animation » Bake Mesh to 


Grease Pencil... 


Converts each frame of a mesh animation within a selected 
frame range to a Grease Pencil object keyframed strokes. 
The Bake Action operator computes the final animation of 
the selected objects with all those modifiers, drivers, and 
constraints applied, and keyframes the result. 


Target Object 
Select the target Grease Pencil object for the baked 
animation or a new one if there is nothing yet. 


Start Frame, End Frame 
Start/End frame for the baking process. 


Step 
Frame steps for the baking process 


Thickness 


Strokes thickness. 


Threshold Angle 
Threshold value that determine the strokes end. 


Stroke Offset 
Sets offset to separate strokes from filled strokes. 


Only Seam Edges 
Convert only edges marked as seam. 


Export Faces 
Convert faces as filled strokes. 


Only Selected Keyframes 
Convert only the selected keyframes. 


Target Frame 
Target destination frame for the baked animation. 


Projection Type 
Sets the projection type to use for the converted strokes. 


Bake Object Transform to 
Grease Pencil 


Reference 

Editor: 3D Viewport 

Mode: Object and Pose Modes 

Menu: Object » Animation » Bake Object 


Transform to Grease Pencil 


Applies all transform animation at Object level within a 
selected frame range to Grease Pencil object keyframes. 


Start Frame, End Frame 
Start/End frame for the baking process. 


Step 
Frame steps for the baking process. 


Only Selected Keyframes 
Convert only the selected keyframes. 


Target Frame 
Target destination frame for the baked animation. 


Projection Type 
Sets the projection type to use for the converted strokes. 


Draw Mode 
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Introduction 


Draw Mode is the mode in Grease Pencil that allows you to 
draw in the 3D Viewport. This mode is actually the only one 
in which new strokes can be created. 


Already made strokes can not be selected in Draw Mode, for 
editing strokes you must use the Edit Mode or Sculpt Mode. 


Draw Mode 


EBs Pencil 
# Oraw ,oe® 
B® Object Mode 


* Edit Mode 


active 


ay Sculpt Mode 


# Draw 
a Vertex Paint 


i= Weight Paint 


=: 


3D Viewport Mode selector: Draw Mode. 


Draw Mode is selected with the Mode menu in the 3D 
Viewport header. Once Draw Mode is activated, the Toolbar 
of the 3D Viewport will change to Draw Mode specific 
panels. Also a circle with the same color as the active 
material will appear and follow the location of the cursor in 
the 3D Viewport. 


To create new strokes you have to select one of the drawing 
tools in the Toolbar. The most common one is the Draw tool 
for free-hand drawings but there are many other tools for 


drawing, filling areas and erasing strokes. There are also 
some tools to create primitives shapes like lines, arcs, 
curves, boxes and circles. 


See Toolbar for more details. 


Strokes Location and 
Orientation Controls 


Drawing in a 3D space is not the same as drawing on a flat 
canvas. When drawing with Grease Pencil you have to 
define the location and orientation of the new strokes in the 
3D space. 


es Origin v OL Front(xXzZ)v & 


3D Viewport header Controls for strokes. 


Stroke Placement 


The Stroke Placement selector defines the new strokes 
location in 3D space. 


See Stroke Placement for more information. 
Drawing Planes 


The Drawing Planes selector defines the plane (orientation) 
to which the new strokes will be restricted. 


See Drawing Planes for more information. 


Guides 


Different Guides types can be activated to assist you when 
drawing new strokes. 


See Guides for more information. 


Drawing Options 


View Draw 


General drawing options. 


Draw on Back 
When enabled, new strokes are drawn below of all 
strokes in the layer. For example when you want to paint 
with a fill material below line strokes on a character and 
they are on the same layer. 


Add Weight Data 
When enabled, weight data is added to new strokes 
according to the current vertex group and weight. If there 
is no vertex group selected, no weight data is added. 


Useful for example in cut-out animation for adding new 
drawing on the same vertex group without the need to 
creating it afterwards. 


See Weight Paint Mode for more information. 


Additive Drawing 
When creating new frames adding strokes with drawing 
tools, the strokes from the previous/active frame are 
include as a basis for the new one. When erasing existing 
strokes using Additive Drawing a new keyframe will be 
added. 


AutoMerge 
Joins new strokes with the beginning or end of previously 
drawn strokes in the active layer. 


Multiframe 
Allows to draw on several frames at the same time. 


See Multiframe for more information. 


Drawing Tools 


Cursor 
Change the location of the 3D Cursor. 


Draw 
Draw free-hand strokes. 


Fill 
Automatic fill closed strokes areas. 


Erase 
Erase strokes. 


— 


int 


Colorize stroke points. 


Cutter 
Cut strokes in between others. 


Eyedropper 
Eyedropper to create new materials or 
palette color based on sampled colors in 
the 3D Viewport. 


Draw Straight lines. 


Polyline 
Draw straight multiple lines. 


Arc 
Draw simple arcs. 


— tint 


Cutter 


Eyedropper 


Line 


Polyline 


) Circle 


*. ” Interpolate 


Annotate 


Curve 
Draw complex Bézier style curves. 


Ox 
Draw rectangular shapes. 


Circle 
Draw oval shapes. 


nterpolate Ctrl-E 
Automatically create a breakdown keyframe between two 
normal keyframes. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Tools 
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Draw Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar >» Draw 


The Draw tool allows you to draw free-hand strokes. 


Brush Settings 


Material 
Data-block selector for the material. 


Radius 
The radius of the brush in pixels. 


F allows you to change the brush size interactively by 
dragging the pointer or by typing a number then confirm. 


Use Pressure (pressure sensitivity icon) 
Uses stylus pressure to control how strong the effect 
is. The gradient of the pressure can be customized 
using the curve widget. 


Strength 


Control the stroke transparency (alpha). From fully 
transparent (0.0) to fully opaque (1.0). 


You can change the brush strength interactively by 
pressing Shift-F in the 3D Viewport and then moving the 
pointer and then Ls. You can also enter the size 
numerically. 


Use Pressure (pressure 

sensitivity icon) 
Uses stylus pressure to 
control how strong the 
effect is. The gradient of 
the pressure can be 
customized using the 
curve widget. 


Caps Type 
The shape of the start and 
end of the stroke. 


Round: 
Strokes start and stop with a curved 
shape. 
Flat: Strokes start and stop with a straight 
cutoff. 
Advanced 


Input Samples 


Controls how often the input device is read to generate 
points on the stroke. Higher values give a higher 
precision (more points) but produce an irregular stroke, 
while lower values give a lower precision (fewer points) 
but produce a soften stroke. (0 disabled extra input 
device samples.) 


You have to set up this value according to your input 
device to obtain the right balance between accuracy and 
softness for your strokes. See Input Device for more 
information. 


Active Smooth 
The number of smoothing iterations to apply to the 
stroke while drawing. 


Angle 
Direction of the input device that gives the maximum 
thickness to the stroke (0° for horizontal). 


Factor 
Amount of thickness reduction when the stroke is 
perpendicular to the Angle value. 


Hardness 
Amount of transparency (alpha) to apply from the border 
of the point to the center. Works only when the brush is 
using stroke materials of Dot or Box style. 


Aspect X, Y 
Controls the width and height of the alpha gradient. 


Stroke 


Post-Processing 


Post-processing methods that are executed on the strokes 
when you finished drawing, right after releasing the Ls or 
Pen tip. You can toggle the use of post-processing using the 
checkbox in the section panel header. 


Smooth 
Strength of smoothing process on the points location 
along the stroke. 


Iterations 
The number of smoothing iterations to apply to the 
stroke. 


Subdivision Steps 
Number of subdivisions to apply to newly created 
strokes. 


Simplify 
Reduces final points numbers in the stroke with an 
adaptive algorithm. 


Trim Strokes End 
Automatically trim intersection strokes ends. 


Outline 
Activate the conversion of the newly created stroke to its 
outline. 


Material 
Material used for outline stroke. 


Thickness 
Thickness used for outline stroke. 


Randomize 


Adds randomness to the position of the points along the 
stroke. You can toggle the use of Randomize using the 
checkbox in the section panel header. 


Radius 
The amount of randomness to apply using the pressure 
of the input device. 


Strength 
The amount of randomness to apply to the stroke 
strength value (alpha). 


UV 
The amount of randomness to apply to the UV rotation. 


Hue, Saturation, Value 
Randomizes the hue, saturation, and value of the stroke’s 
Color. 


Jitter 
The amount of jittering to add to the stroke. 


Common Options 


Stroke Random (stroke icon) 
Use randomness only at stroke level. 


Use Pressure (pressure sensitivity icon) 
Uses the stylus pressure to control how strong the effect 
is. The gradient of the pressure can be customized using 
the curve widget. 


Stabilize Stroke 


Stabilize Stroke helps to reduce jitter of the strokes while 
drawing by delaying and correcting the location of points. 


You can toggle the use of Stabilize Stroke using the 
checkbox in the section panel header. 


Radius 
Minimum distance from the last point before the stroke 
continues. 


Factor 
A smooth factor, where higher values result in smoother 
strokes but the drawing sensation feels like as if you 
were pulling the stroke. 


Cursor 


The cursor can be disabled by toggling the checkbox in the 
Cursor header. 


Show Fill Color while Drawing 
Shows the brush linked material color in the viewport. 


Usage 


Selecting a Brush and Material 


In the Tool Settings select the brush, material and color type 
to use with the tool. The Draw tool uses Draw Brush types. 
See Brush Settings for more information. 


Free-hand Drawing 


Click and hold LB or use the pen tip to make free-hand 
drawing on the viewport. 


Drawing free-hand strokes. 


Stabilize Stroke 


Shift-LMB toggle the use of Stabilize Stroke on the brush to 
have more control while drawing and get smoother lines. 


Drawing strokes using Stabilize Stroke. 
Straight Lines 


Alt-LMB Constrains the drawing of the strokes to horizontal or 
vertical straight lines. 


Switching to the Erase Tool 


Ctrl-LMB changes temporally to the active Erase tool. See 
Erase Tool for more information. 


You can also use B to delete all the points in the selected 
drawing area. 


Fill Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar > Fill 


The Fill tool is used to automatically fill closed strokes areas. 


Brush Settings 


You can also configure the brush main settings exposed on 
the Tool Settings for convenience. 


Direction Ctrl 
The portion of area to fill. 


Normal: Fills the area inside the shape under 
the cursor. 
Inverted: Fills the area outside the shape under 
the cursor. 
Precision 


Multiplier for fill boundary accuracy. Higher values are 
more accurate but slower. 


Dilate/Contract 
Size in pixels to expand or shrink the fill area from the 
strokes boundary. 


Thickness 
The thickness radius of the boundary stroke in pixels. 


Advanced 


Boundary 
Sets the type of fill boundary limits calculation to 
perform. 


All: Use the thickness of the strokes and 
the editing lines together. 

Stroke: Use only the thickness of the strokes 
(ignore edit lines). 

Line: Use only the edit lines (ignore strokes). 


Show Lines (grid icon) 
Toggle show auxiliary lines to see the fill boundary. 


Layers 
Determines which Layers are used for boundary strokes. 


Visible: Calculates boundaries based on all 
visible layers. 
Active: Calculates boundaries based on the 


active layer. 

Layer Above: Calculates boundaries based on the 
layer above the active layer. 

Layer Below: Calculates boundaries based on the 
layer below the active layer. 


All Above: Calculates boundaries based on all 
layers above the active layer. 
All Below: Calculates boundaries based on all 


layers below the active layer. 
Simplify 
Number of simplify steps to apply to the boundary line. 
Higher values reduce the accuracy of the final filled area. 


Ignore Transparent 


When enabled, strokes with transparency does not take 
into account on fill boundary calculations. 


The value slider controls the threshold to consider a 
material transparent. 


Limit to Viewport 
When enabled, fill only visible areas in the viewport. 


Gap Closure 


Gap closure lines are automatic temporarily lines that help 
to close gaps on the strokes. 


Size 
Control the Size of the line extension or the 
circumference to use to calculate the lines that will close 
the gaps. 


Mode s 
Sets the type of Gap closure method to use. 


Radius: Uses the Radius of circumference of 
opened nearest points to calculate a 
line that close the gap. 

Extend: Extends the opened strokes to close 


gaps. 
Visual Aids 
Toggle show closure lines helper. 


Strokes Collision D 
Check if extend lines collide with strokes, stopping the 
extension if a collision is detected. 


Only Collide Lines 
Use for closing gaps only if the extend strokes collide. 


Usage 


Selecting a Brush and Material 


In the Tool Settings select the brush, material and color type 
to use with the tool. The Fill tool uses Fi// Brush types. See 
Brush Settings for more information. 


Filling Areas 


Click LmB in a closed stroke area. The tool will automatically 
calculate the boundary and create a new closed stroke filled 
with the material selected. 


Use the fill 

tool to 
Original leak Final filled 
Drawing. materials drawing. 

on closed 

areas. 


Boundary Strokes 


If you have a large gap in an area that you want fill, you can 
add boundary strokes manually, a temporary auxiliary lines 


for closing open shapes. To create a boundary stroke use 
Alt-LMB and draw a line to close the desired area. 


a 
BZ 
ES 
Use the Fill 
EN Add tool to 
boundary leak 
Original strokes to material 
drawing. close open on the 
areas (red new 
lines). closed 
area. 


When you are satisfied with the fill result you can delete the 
boundary strokes using the Clean Up tool in the Grease 
Pencil Menu in Edit Mode. 


Automatic Gap Closure 


A more automatic way to close gaps in an area that you 
want fill is using temporarily helper lines. There are two 
method to use “Radius” or “Extend” 


Radius use temporary auxiliary lines calculated from the 
radius of nearby open points to close open shapes. Set the 
size more than zero to control the circle size over opened 
points (the circle will disappear when the line close the gap). 
Click over the area you want to be filled and change the 
length of the strokes using PageUp PageDown Or Wheel. When you 


are satisfied with the length and you are sure the 
temporarily strokes cross each other, click again to fill the 
area. 


Use Use Fill 
Radius Tool to 
mode to leak 
Original close open material 
Drawing. areas (Red on the 
circles and new 
cyan closed 
lines). area. 


Extend use temporary auxiliary lines extending the actual 
strokes ends for closing open shapes. Set the size more than 
zero to use the extended lines, click over the area you want 
to be filled and change the length of the strokes using 
PageUp/PageDown, Wheel Or a pen’s MMB. When you are satisfied 
with the length and you are sure the temporarily strokes 
cross each other, click again to fill the area. 
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area. 


Switch to Draw Tool 


Use Ctri-LMB to change temporary to the active draw tool. 
For example to manually cover small areas difficult to reach 
for the Fill tool. See Draw Tool for more information. 


Erase Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar > Erase 


The Erase tool erase already drawn strokes. 


Brush Settings 


Radius 
The radius of the brush in pixels. 


F allows you to change the brush size interactively by 
dragging the pointer or by typing a number then confirm. 


Use Pressure (pressure sensitivity icon) 
Uses stylus pressure to control how strong the effect 
iS. 


Occlude Eraser (overlapping squares icon) 
Erase only strokes visible and not occluded by 
geometry. 


Default Eraser 
Use this brush when enabling the eraser tool with the 
fast switch key (Ctrl). 


Mode 
Determines how the erase tool behaves. 


Dissolve: To simulate a raster type eraser, this 
eraser type affects the strength and 
thickness of the strokes before actually 
delete a point. 


Point: Delete one point at a time. 
Stroke: Delete an entire stroke. 
Strength 


Control how much will affect the eraser has on the stroke 
transparency (alpha). 


You can change the brush strength interactively by 
pressing Shift-F in the 3D Viewport and then moving the 
pointer and then Ls. You can also enter the size 
numerically. 


Use Pressure (pressure sensitivity icon) 


Uses stylus pressure to control how strong the effect 
iS. 


Affect Stroke Strength 


The amount of deletion of the stroke strength (alpha) 
while erasing. 


Affect Stroke Thickness 


The amount of deletion of the stroke thickness while 
erasing. 


Display Cursor 
Shows the brush shape in the viewport. 


Usage 


Selecting a Brush 


In the Tool Settings select the brush to use with the tool. The 
Erase tool uses Erase Brush types (soft, point and stroke). 


Dissolve Erasing 


e Select an erase brush of type Soft/Hard. 

e Adjust brush settings. 

e Click and hold Ls or use the Pen tip to delete strokes on 
the viewport. 


Ny Ny 


The eraser 
Original affect the Final 
drawing. transparency result. 
of the 
strokes. 


Point Erasing 


e Select an erase brush of type Point. 

e Adjust brush settings. 

e Click and hold Ls or use the Pen tip to delete strokes on 
the viewport. 


Original 
drawing. 


Stroke Erasing 


e Select an erase brush of type Stroke. 
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The eraser 
delete one 
point ata 
time. 


e Adjust brush settings. 
e Click and hold LmsB or use the Pen tip to delete strokes on 


the viewport. 
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Tint Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar > Tint 


The Tint tool allows you to paint onto strokes point mixing 
the material base color with a selected color. 


Brush Settings 


Mode 
Defines how Color Attributes affect to the strokes. 


Stroke and Fill: 
Color Attributes affects both the Stroke 
and Fill materials. 


Stroke: Color Attributes affects the Stroke 
material only. 
Fill: Color Attributes affects the Fill material 
only. 
Usage 


Selecting a Brush, Color & Mode 


In the Tool Settings select the brush, color and mode to use 
with the tool. 


You can configure the brush main settings included in the 
Tool Settings for convenience. For the vertex paint brushes 
configuration and settings see Vertex Paint Brush. 


Ctrl-LMB erase the Color Attribute. 
Painting 


Click and hold LmsB or use the pen tip to paint onto the stroke 
points. 


Vertex painting stroke points. 
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Cutter Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar >» Cutter 


The Cutter tool delete points in between intersecting 
strokes. 


Tool Settings 


Flat Caps 
Mark newly created End Caps as Flat. 


Threshold 
Determine the threshold for stroke intersections. 


Usage 


Draw a dotted line around the strokes you want to be cut. 
After releasing the mouse button all the points on the 
selected strokes will be deleted until another intersecting 
stroke is found. 


Original Lasso Final 
drawing. Selecting result. 
the 
strokes to 
be cut. 


Eyedropper 


Reference 
Mode: Draw Mode 
Tool: Toolbar » Eyedropper 


The Eyedropper tool is used to create materials or palette 
color based on sampled colors in the 3D Viewport. 


Tool Settings 


Material: Create a new material with the Stroke 
Base Color to be the sampled color. 
Palette: Add a new color to the color palette based 


on the sampled color. 


Usage 


e LMB Create a stroke material. 
e Shift-LMB Create a fill material. 
e Shift-Ctrl-LMB Create both a stroke and fill material. 


Line Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar > Line 


The Line tool create straight lines. 


Tool Settings 


You can configure the brush main settings exposed on the 
Tool Settings for convenience. For the draw brushes 
configuration and settings see: Draw Brush. 


Subdivisions 
The number of stroke points between each stroke edge. 


Thickness Profile 
Use a curve widget to define the stroke thickness from 
the start (left) to end (right) of the stroke. 


Use Curve 
When enabled, the stroke use a curve profile to control 
the thickness along the line. 


Different thickness profile samples. 


Usage 


Selecting a Brush and Material 


In the Tool Settings select the brush, material and color type 
to use with the tool. The Line tool uses Draw Brush types. 
See Brush Settings for more information. 


Creating Lines 


1. Click (LMB or the Pen tip) and drag the start point. 

2. Release on the desired end point. 

3. After releasing you can move the start and end point by 
clicking and dragging on the yellow manipulators. 

4. Then confirm (Return/MMB) or cancel (Esc/RMB). 


While dragging you can use Shift to Snapping the line to 
horizontal, vertical or 45° angle or use Alt to create the line 


from a center point. 


NumpadPlus and NumpadMinus or using the mouse Wheel will 
increase or decrease the amount of points in the final line. 


click and 
dragging 


the start 
point. 


The line 
Moving start after 
and end confirming. 


points with 
manipulators. 


Extruding 


Before confirming you can use E to extrude the end point of 
the line to generate multiple connected lines. 
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Polyline Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar » Polyline 


The Polyline tool create multiple straight lines. 


Tool Settings 


You can configure the brush main settings exposed on the 
Tool Settings for convenience. For the draw brushes 
configuration and settings see: Draw Brush. 


Subdivisions 
The number of stroke points between each stroke edge. 


Thickness Profile 


Use a curve widget to define the stroke thickness from 
the start (left) to end (right) of the stroke. 


Use Curve 


When enabled, the stroke use a curve profile to 
control the thickness along the line. 


Different thickness profile samples. 


Usage 


Selecting a Brush and Material 


In the Tool Settings select the brush, material and color type 
to use with the tool. The Line tool uses Draw Brush types. 
See Brush Settings for more information. 


Creating Polylines 


1. Click (LMB or the Pen tip) and drag the start point. 

2. Release on the desired end point. 

3. Click multiple times on different locations to create 
multiple connected lines. 

4. Then confirm (Return/MMB) or Cancel (Esc/RMB). 


While dragging you can use Shift to snapping the line to 
horizontal, vertical or 45° angle. 


NumpadPlus and NumpadMinus or using the mouse Wheel will 
increase or decrease the amount of points in the final line. 
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Arc Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar > Arc 


The Arc tool create simple arcs. 


Tool Settings 


You can configure the brush main settings exposed on the 
Tool Settings for convenience. For the draw brushes 
configuration and settings see: Draw Brush. 


Subdivisions 
The number of stroke points between each stroke edge. 


Thickness Profile 


Use a curve widget to define the stroke thickness from 
the start (left) to end (right) of the stroke. 


Use Curve 
When enabled, the stroke use a curve profile to control 
the thickness along the arc. 


Different thickness profile samples. 


Usage 


Selecting a Brush and Material 


In the Tool Settings select the brush, material and color type 
to use with the tool. The Arc tool uses Draw Brush types. See 
Brush Settings for more information. 


Creating Arcs 


1. Click (LMB or the Pen tip) and drag the start point. 

2. Release on the desired end point. 

3. After releasing you can tweak the arc using a single cyan 
manipulator (hand icon). 

4. Then confirm (Return/MMB) or cancel (Esc/RMB). 


While dragging you can use Shift to make a perfect arc, use 
Alt to create the arc from a center point or M to flip. 


NumpadPlus and NumpadMinus or using the mouse Wheel will 
increase or decrease the amount of points in the final arc. 
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Extruding 


Before confirming you can use E to extrude the end point of 
the arc to generate multiple connected arcs. 
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Curve Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar >» Curve 


The Curve tool create complex Bézier style curves. 


Tool Settings 


You can configure the brush main settings exposed on the Tool 
Settings for convenience. For the draw brushes configuration 
and settings see: Draw Brush. 


Subdivisions 
The number of stroke points between each stroke edge. 


Thickness Profile 
Use a curve widget to define the stroke thickness from the 
Start (left) to end (right) of the stroke. 


Use Curve 
When enabled, the stroke use a curve profile to control 
the thickness along the curve. 


Different thickness profile samples. 


- 


Usage 


Selecting a Brush and Material 


In the Tool Settings select the brush, material and color type 
to use with the tool. The Curve tool uses Draw Brush types. 
See Brush Settings for more information. 


Creating Curves 


1. Click (LMB or the Pen tip) and drag the start point. 

2. Release on the desired end point. 

3. After releasing you can tweak the curve using two cyan 
Bézier like manipulators. 

4. Then confirm (Return/MMB) or cancel (Esc/RMB). 


While dragging you can hold Shift to use only one 
manipulator to tweak the curve (like the Arc tool), use Alt to 
create the arc from a center point. 


NumpadPlus and NumpadMinus or using the mouse Wheel will 
increase or decrease the amount of points in the final curve. 


click and 

dragging Tweaking The curve 
the start curve with after 

point. the confirming. 


manipulators. 


Extruding 


Before confirming you can use E to extrude the end point of 
the curve to generate multiple connected curves. 


The 
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Box Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar >» Box 


The Box tool create rectangular shapes. 


Tool Settings 


You can configure the brush main settings exposed on the 
Tool Settings for convenience. For the draw brushes 
configuration and settings see: Draw Brush. 


Subdivisions 
The number of stroke points between each stroke edge. 


Thickness Profile 


Use a curve widget to define the stroke thickness from 
the start (left) to end (right) of the stroke. 


Use Curve 
When enabled, the stroke use a curve profile to control 
the thickness along the line. 


Usage 


Selecting a Brush and Material 


In the Tool Settings select the brush, material and color type 
to use with the tool. The Box tool uses Draw Brush types. 
See Brush Settings for more information. 


Creating Boxes 


1. Click (LMB or the Pen tip) and drag the start point. 

2. Release on the desired end point. 

3. After releasing you can move the start and end point by 
clicking and dragging on the yellow manipulators. 

4. Then confirm (Return/MMB) or cancel (Esc/RMB). 


While dragging you can use Shift to make a perfect square 
or use Alt to create the box from a center point. 


NumpadPlus and NumpadMinus or using the mouse Wheel will 
increase or decrease the amount of points in the final box. 
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Circle Tool 


Reference 
Mode: Draw Mode 
Tool: Toolbar >» Circle 


The Circle tool create oval shapes. 


Tool Settings 


You can configure the brush main settings exposed on the 
Tool Settings for convenience. For the draw brushes 
configuration and settings see: Draw Brush. 


Subdivisions 
The number of stroke points between each stroke edge. 


Thickness Profile 
Use a curve widget to define the stroke thickness from 
the start (left) to end (right) of the stroke. 


Use Curve 
When enabled, the stroke use a curve profile to control 
the thickness along the line. 


Usage 


Selecting a Brush and Material 


In the Tool Settings select the brush, material and color type 
to use with the tool. The Circle tool uses Draw Brush types. 
See Brush Settings for more information. 


Creating Circles 


1. Click (LMB or the Pen tip) and drag the start point. 

2. Release on the desired end point. 

3. After releasing you can move the start and end point by 
clicking and dragging on the yellow manipulators. 

4. Then confirm (Return/MMB) or cancel (Esc/RMB). 


While dragging you can use Shift to make a perfect circle or 
use Alt to create the circle from a center point. 


NumpadPlus and NumpadMinus or using the mouse Wheel will 
increase or decrease the amount of points in the final circle. 
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Interpolate 


Reference 

Mode: Draw Mode 

Tool: Toolbar » Interpolate 
Shortcut: Ctrl-E 


The Interpolate tool interpolates strokes between the 
previous and next keyframe by adding a single keyframe. 
When you are on a frame between two keyframes and click 
and drag a new breakdown keyframe will be added. This 
way you define the final interpolation for the new stroke. 


Usage 


Set the Playhead on the Timeline between the two 
keyframes you want to interpolate. Click and drag from left 
to right to set the desired interpolation percentage and 
release to confirm, a new breakdown keyframe will be 
added. 


Tools Settings 


e Brushes 
o Brush Types 
e Brush Settings 
e Color 
o Material 
o Color Attribute 


Brushes 


Brush 
The Data-Block Menu to 
select a preset brush 
type or a custom brush. 


Add Brush 
When you add a 
brush, the new brush 
is a clone of the 
current one. 


Brush Specials 
Reset Brush 
Reset the current 
brush to its default 
settings. 


Reset All Brushes 
Reset all brushes 
to their default 
settings. 


Custom Icon 


Allows definition of 
a custom brush 
icon. 


Image Path 


& Fill 


Brushes 
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Fill Area 


Brush Settings 


ata Normal 
Precision 
Dilate/Contract 
Thickness 
Advanced 
¥ Cursor 
Color 


Workspace 


Brush data-block panel. 


Defines the path to the image to use as custom 


icon. 


Note 


In order to save a custom brush in a blend-user, enable 
Fake User. 


Brush Types 


Draw Brushes 


Draw brushes are the special type of brushes that uses 
Grease Pencil for drawing tools. The brush can be changed 
in the Tool Settings. The different draw brushes (pencil, Ink, 
marker, etc.) are settings variations of the same Draw 
Brush. You can create many brushes, each with unique 
settings to get different artistic result while drawing. 


Fill Brushes 


Fill brushes are the special type of brushes that uses Grease 
Pencil for the Fil/ tools. The brush can be changed in the Tool 
Settings. The different fill brushes are settings variations of 
the same Fill Brush. You can create many brushes, each with 
unique settings to get different result when filling areas. 


Erase Brushes 


Erase brushes are the special types of brushes that uses 
Grease Pencil for Erase tools. The brush can be changed in 
the Tool Settings. Soft and hard eraser brushes are settings 
variations of the same Erase Brush. You can create many 
brushes, each with unique settings to get different effects 


while erasing. The Erase Brush has also other two special 
eraser types: point and stroke. 


Brush Settings 


Material 
Data-block selector for the material. Except for the Erase 
tool of course. 


Pin Material (pin icon) 
Pin the material to the brush. 


The final appearance of the strokes is a combination 
of the brush and material used, binding the material 
to the brush gives more control and avoids a lack of 
coordination between the two. 


Color 


Controls the source of the stroke color. The mode can be 
pinned to the brush by enabling the Pin icon in the Tool 
Settings header. 


Material 


Use the stroke/fill base color material. 


Color Attribute 


Use Color Attribute. 


Color Picker 
The color of the brush. See Color Picker. 


Color Palette 
Active Color Palette. See Color Palette. 


Mode 
The color transformation will be applied on the stroke 
and/or the fill color. 


Stroke: Only paint over strokes. 

Fill: Only paint over fill areas. 

Stroke & Fill: | Paint over strokes and fill areas. 
Mix Factor 


Mixing factor between the selected color and the base 
material color. 


Stroke Placement 


Reference 
Mode: Draw Mode 
Header: Stroke Placement 


The Stroke Placement selector helps to select the location in 
which the newly created strokes are drawn. 


Note 


The Stroke Placement selected has effect only for new strokes 
and does not affect the existing ones. 


Placement Options 


Origin 
Strokes 
are troke PI nt 
placed at ts Origin 
Grease Yet 3D Cursor 
Pencil TJ Surface 
object 
origin. 
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© Stroke 


Stroke Placement selector on 3D Viewport header. 
3D Cursor 


Strokes 
are placed at 3D cursor. 


Surface 
Strokes will stick on mesh surfaces. 


Offset 


Distance from the mesh surface to place the new strokes. 


Stroke 
Strokes will stick on other strokes. 


Target 
All Points 
All the points of the new stroke sticks to other strokes. 


End Points 
Only the start and end points of the new stroke sticks to 
other strokes. 


First Point 
Only the start point of the new stroke sticks to other 
strokes. 


Examples 


Stroke using different Stroke Placements. 
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Drawing Planes 


Reference 
Mode: Draw Mode and Sculpt Mode 
Header: Drawing Planes 


The Drawing Planes selector helps to select the plane in which the 
newly created strokes are drawn. 


To see which plane you are using when drawing strokes, you can enable 
Canvas in Viewport Overlays. See Viewport Display to know more about 
Canvas settings. 


Note 


The Drawing Plane selected has effect only for new strokes and does 
not affect the existing ones. 


Plane Options 


Front 
Strokes are 
drawn on the 


plane 
determined by BL Front (x2) 
the XZ axes a —- 
(front view). vei — 
Side 
Strokes are Drawing Planes selector in the 3D Viewport header. 
drawn on the 
plane 


determined by 
the YZ axes (side view). 


Top 


Strokes are drawn on the plane determined by the XY axes (top 
view). 


View 
Strokes are drawn with the current 3D Viewport orientation. 


Cursor 
Strokes are drawn with the current 3D cursor orientation. 


Examples 


Stroke using different Drawing Planes with Canvas overlay activated. 


Front. Side. Top. View. 
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Cursor. 


Guides 


Reference 
Mode: Draw Mode 
Header: Guides 


Guides are drawing aids that make it easier to create different 
types of strokes. The Guides can be activated with the button 
next to the selector (grid icon). 


Guide Types 


Circular 
Constrai 
ns the | 
drawing Circular 
of new Radial 

Parallel 
strokes ati 
to form Isometric 
rings 
from the : in 
selected Cursor Custom Object 
referenc 
e point. 
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Guide selector activated in the 3D Viewport header. 
Radial 


Constral 
ns the drawing of new strokes to form rays from the selected 
reference point. 


Parallel 
Constrains the drawing of new strokes to form parallel lines. 


Angle 
Angle direction of the parallel lines. 


Grid 
Constrains the drawing of new strokes to form parallel 
horizontal or vertical lines. 


Isometric 


Constrains the drawing of new strokes to vertical or isometric 
lines. 


Angle 
Angle direction of the isometric lines. 


Common Options 


Use Snapping 
When enabled, snap the drawn strokes to an angle or spacing. 


Spacing 
Guide spacing. 


Reference Point 


Determines the origin point to use for the creation of the lines. 
Applies only for Circular and Radial guides. 


Cursor 
Use the cursor as a reference point. 


Custom 
Use a custom location as a reference point. 


Custom Location 
XYZ 


Object 
Use an object as a reference point. 


Object 
A Data ID menu to select the object (usually an empty), 
which location will be used as a reference point. 


Examples 


Examples of strokes using different types of Guides. 
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Sculpt Mode 


e Introduction 
o Sculpt Mode 
o Sculpting Options 
o Keyboard Shortcuts 
¢ Sculpting Tools 
e Brush Settings 
o Advanced 
o Advanced 
o Cursor 


Introduction 


Sculpt Mode is similar to Edit Mode in that it is used to alter 
the shape of a drawing, but Sculpt Mode uses a very 
different workflow: Instead of dealing with individual 
elements (points and edit lines), an area of the model is 
altered using a brush. In other words, instead of selecting a 
group of points, Sculpt Mode manipulates the drawing in the 
brush region of influence. 


Sculpt Mode 


Radius 
@ SculptMode v fo 
@ Object Mode 
Edit Mode 


@ Sculpt Mode 


A Draw 
a] Vertex Paint 
1) Weight Paint 
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3D Viewport Mode selector: Sculpt Mode. 


Sculpt Mode is selected from the Mode menu in the 3D 
Viewport header. Once Sculpt Mode is activated, the Toolbar 
of the 3D Viewport will change to Sculpt Mode specific 
panels. A red circle will appear and follow the location of the 
cursor in the 3D Viewport. 


Sculpting Options 


gS Sculpt Mode + PRK KK Multiframe vi View 


General sculpting options. 


Selection Mask 
Sculpt Mode in Grease Pencil allows you to select points 
or strokes to restrict the effect of the sculpting tools to 
only a certain areas of your drawing. 


You can use the selection tools in the Toolbar for a quick 
selection. You can restrict sculpting only on the selected 
points or strokes with the Selection mode buttons. 


Multiframe 


Sometimes you may need to modify several frames at 
the same time with the sculpting tools. 


You can activate multiframe edition with the Multiframe 
button next to the modes selector (faded lines icon). See 
Multiframe for more information. 


Keyboard Shortcuts 


e Invert stroke toggle ctrl 
e Change active material U 


Sculpting Tools 


For Grease Pencil sculpt modes each brush type is exposed 
as a tool, the brush can be changed in the Tool Settings. See 
Brush for more information. 


Smooth Y A 
Eliminates irregularities in the area of the ae 
drawing within the brush’s influence by lita 
smoothing the positions of the points. Z Strenath 

Thickness oe Cea 
Increase or decrease the points thickness in J\_ Grab 
the area of the drawing within the brush’s SP Push 
influence. 

© Twist 

Strength ef Sa 
Increase or decrease the points A 
transparency (alpha) in the area of the 4 Clone 


drawing within the brush’s influence. 


> 
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Randomize 
Add noise to the strokes in the area of the 
drawing within the brush’s influence by moving points 
location in a random way. 


Grab 
Used to drag a group of points around. Unlike the other 
brushes, Grab does not modify different points as the 
brush is dragged across the model. Instead, Grab selects 
a group of points on mouse-down, and pulls them to 
follow the mouse. The effect is similar to moving a group 
of points in Edit Mode with Proportional Editing enabled. 


Push 
Moves points in the direction of the brush stroke. 


Twist 
Twist the points in counter-clockwise (CCW) or Clockwise 


(CW) rotation. 


Pinch/Inflate 
Pulls points towards the center of the brush. The inverse 
setting is Inflate, in which points are pushed away from 
the center of the brush. 


Clone 
Adds copies of the strokes in the clipboard in the center 
of the brush. You have to copy the selected strokes you 
want into the clipboard with ctri-c before using the tool. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Brush Settings 


Reference 

Mode: Sculpt Mode 

Panel: Sidebar > Tool >» Brush Settings 
Radius 


This option controls the radius of the brush, measured in 
pixels. F allows you to change the brush size interactively 
by dragging the mouse and then Lne (the texture of the 
brush should be visible inside the circle). Typing a 
number then enter while using F allows you to enter the 
size numerically. Brush size can be affected by enabling 
the pressure sensitivity icon, if you are using a Graphics 
Tablet. 


Strength 
Controls how much each application of the brush affects 
the model. For example, higher values cause the 
Randomize brush to add noise to the strokes more 
quickly, and cause the Smooth brush to soften the 
strokes more quickly. 


You can change the brush strength interactively by 
pressing Shift-F in the 3D Viewport and then moving the 
brush and then Lms. You can enter the size numerically 
also while in Shift-F sizing. Brush strength can be 
affected by enabling the pressure sensitivity icon, if a 
supported tablet is being used. 


Use Falloff 


When enabled, use Strength falloff for the brush. Brush 
Strength decays with the distance from the center of the 
brush. 


Sculpt Strokes 
Filters the effect of the brush over the strokes. Applies to 
Smooth and Randomize brushes only. 


Note 
If there is no filter selected Affect Position is the default 
behavior. 


Affect Position 
Toggles the brush effect on the position of the stroke 


points. 


Affect Strength 
Toggles the brush effect on the strength (alpha) of the 


stroke points. 


Affect Thickness 
Toggles the brush effect on the thickness of the stroke 


points. 


Affect UV 
Toggles the brush effect on the UV rotation of the 


stroke points. 


Direction 
The influence direction of the brush. This can be Add or 
Subtract. 


Advanced 


Advanced 


Auto-Masking 
Strokes 
Affect only strokes under the cursor. 


Material 
Affect only the active material. 


Layer 
Affect only the active layer. 


Cursor 


The cursor can be disabled by toggling the checkbox in the 
Cursor header. 


Color 
Set the color of the brush ring. Depending on the current 
mode there will be options to set a single Color or a Color 
for Adding/Subtracting. 


Edit Mode 


Introduction 
o Accessing Stroke Editing Tools 
Editing _Tools 
Curve Editing 
o Usage 
o Curve Editing Popover 
o Curve Data 
o Operators 
e Grease Pencil Menu 
Transform 
Mirror 
snap 
Active Layer 
Animation 
Interpolation 
Duplicate 
Split 
Copy 
Paste & Paste by Layer 
Separate 
Clean Up 
Recalculate Geometry 
o Delete 
e Stroke Menu 
o Subdivide 
Simplify 
Trim 
Outline 
Join 
Move to Layer 
Assign Material 
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Set_as Active Material 
Arrange 
Close 
Toggle Cyclic 
Toggle Caps 
Switch Direction 
Set Start Point 
Normalize Thickness 
Normalize Opacity 
Scale Thickness 
Reset Fill Transform 
e Point Menu 
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Introduction 


Blender provides a variety of tools for editing Grease Pencil 
strokes. These are tools used to add, duplicate, move and 
delete elements. 


Accessing Stroke Editing Tools 


These are available through the different tools in the 
Toolbar, the Stroke menu in the 3D Viewport header, and 
context menus in the 3D Viewport, as well as individual 
Shortcut keys. 


Toolbar 


When you select a stroke and Tab into Edit Mode, the Toolbar 
changes from Object Tools to Stroke editing Tools. These are 
only some of the stroke editing tools. 


Menus 
The Stroke Menu is located in the header. 


Context Menu 


RMB brings up the complete Stroke Menu. 


Editing Tools 


Select 
Select or moved. 


Select Box 
Select geometry by dragging a box. 


Select Circle 
Select geometry by painting on it. 


Select Lasso 


Select geometry by drawing a lasso. 


Cursor 
Change the location of the 3D Cursor. 


Move 
Translation tool. 


Rotate 
Rotation tool. 


Scale 
Scale tool. 


Scale Cage 


Select Box 


Cursor 
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Annotate 


Change the scale of an object by controlling its cage. 


Transform 


Tool to adjust the objects translation, rotations and scale. 


Extrude — 


Extrusion tools duplicate points, while keeping the new 
geometry connected with the original points. 


Radius Alt-S 
Expand or contract the thickness radius of the selected 
points. 


Bend Shift-W 
Bend selected points between the 3D cursor and the 
pointer. 


Shear Shift-Ctrl-Alt-S 
Shear selected points along the horizontal or vertical 
screen axis. 


To Sphere Shift-Alt-S 
Move selected points outward in a spherical shape 
around the selected strokes’ center. 


Transform Fill 
Change the Translation, Rotation and scale of strokes fill. 


Interpolate Ctrl-E 
Automatically create a breakdown keyframe between two 
normal keyframes. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 


Erase previous drawn annotations. 


Curve Editing 


Curve Editing allows you to edit Grease Pencil strokes using 
Bézier curves. 


Usage 


1. Select the desired strokes to edit as curves. 
2. Activate curve editing in the 3D Viewport’s header with 
the toggle button (Bézier curve icon). 
3. Once activated you can: 
o Edit the curves with the curve handles. 
o Select strokes to automatically convert them to 
curves. 


Note 

Selecting points in between is disabled while in curve 
editing is active. 

See also 


The curve editing handles display can be tweaked in the 
Overlays popover. 


Curve Editing Popover 


Reference 


Mode: Edit Mode 


Panel: 3D Viewport » Header > Curve Editing 


§ 7 Curve Editing v 


Curve Resolution 32 
Threshold 0.10000 
Comer Angle 90° 

¥ Adaptive Resolution 


Curve Editing popover. 


Curve Resolution 
Number of points generated along each curve segment 
(between two handles) if Adaptive Resolution is disabled. 


Threshold 
Threshold used for curve fitting. Maximum distance the 
fitted curve can deviate from the target stroke. A 
threshold of 0.0 will generate a curve point for every 
stroke point. Higher thresholds will result in higher 
approximations of the target stroke but also smoother 
curve. 


Corner Angle 
Any detected corner with an angle above the specified 
amount will create a sharp (non-aligned) handle. 


Adaptive Resolution 
When activated, the Curve Resolution is no longer 
constant for all curve segments but calculated 
dynamically. The length of each segment is 
approximated, then multiplied by the Curve Resolution 
and rounded down. This will be the number of points to 


generate for that segment. With Adaptive Resolution the 
points will be distribute more evenly across all the 
strokes. The Curve Resolution option will change the 
point density. 


Adaptive Resolution. 


Off. 


Curve Data 


Once a stroke has been converted to a curve, the data will 
be saved to the file. When Curve Editing is deactivated and 
the curve is changed, for example using Sculpt Mode, then 
the curve will be refitted once Curve Editing is activated 
again. 


Operators 


Curve editing is currently more limited than stroke editing. 
Every operation in Edit Mode for strokes and stroke points 
work for curves as well except for the following: 


Duplicate 

Copy and Paste 

Snap to Cursor and Cursor to selected 
Flip 

Simplify and Simplify Fixed 


Trim 
Separate 
Split 
Interpolate 


Grease Pencil Menu 


Transform 
Strokes can be edited by transforming the locations of points. 


Move, Rotate & Scale 


Reference 

Mode: Edit Mode 

Tool: Toolbar » Move, Rotate, Scale 

Menu: Grease Pencil > Transform > Move, Rotate, Scale 
Shortcut: G, R, S 


Like other elements in Blender, points and strokes can be moved G, rotated R or 
scaled s as described in the Basic Transformations section. When in Edit Mode, 
Proportional Editing is also available for the transformation actions. 


Transform Snapping 


Basic move, rotate and scale transformations for selected points/strokes. See 
Move, Rotate, Scale Basics for more information. 


Tools 

Reference 

Mode: Edit Mode 

Menu: Grease Pencil >» Transform 
Tool: Toolbar » Bend/Shear 


The Bend, Shear, To Sphere, Extrude and Shrink Fatten transform tools are 
described in the Editing_tools section. 


Mirror 


Reference 


Mode: Edit Mode 
Menu: Grease Pencil > Mirror 


Shortcut: Ctrl-M 


The Mirror tool is also available, behaving exactly the same as with mesh 
vertices. 


Snap 


Reference 

Mode: Edit Mode 

Menu: Grease Pencil » Snap 
Shortcut: Shift-S 


Mesh snapping also works with Grease Pencil components. 


Active Layer 


Reference 

Mode: Edit Mode, Draw Mode 
Menu: Grease Pencil » Active Layer 
Shortcut: Y 


Select the active layer. 


Animation 

Reference 

Mode: Edit Mode, Draw Mode 
Menu: Grease Pencil >» Animation 
Shortcut: I 


The stroke animation tools are described in the Animation section. 


Interpolation 
Reference 
Mode: Edit Mode, Draw Mode 


Menu: Grease Pencil > Interpolation 


The stroke animation tools are described in the Animation section. 


Duplicate 

Reference 

Mode: Edit Mode 

Menu: Grease Pencil » Duplicate 
Shortcut: Shift-D 


Duplicates the selected elements, without creating any connections with the 
rest of the strokes (unlike Extrude, for example), and places the duplicate at 
the location of the original elements. 


Split 


Reference 

Mode: Edit Mode 

Menu: Grease Pencil > Split 
Shortcut: V 


Splits (disconnects) the selected points from the rest of the stroke. The 


separated points are left exactly at the same position as the original points but 
they belong to a new stroke. 


Copy 


Reference 

Mode: Edit Mode 

Menu: Grease Pencil » Copy 
Shortcut: Ctrl-C 


Copy the selected points/strokes to the clipboard. 
Paste & Paste by Layer 


Reference 


Mode: Edit Mode 
Menu: Grease Pencil » Paste, Grease Pencil » Paste by Layer 


Shortcut: Ctrl-V 


Type 
Paste to Active 
Pastes the points/strokes copied from the clipboard into the active layer. 
This is the default behavior and the mode used when using Grease Pencil 
> Paste. 


Paste by Layer 
Pastes the points/strokes copied from the clipboard into the layer they 
were copied from. 


Separate 

Reference 

Mode: Edit Mode 

Menu: Grease Pencil » Separate 
Shortcut: P 


Separate the selected elements into a new Grease Pencil object. 


Selected Points 
Separate the selected points into a new object. 


Selected Strokes 
Separate the selected strokes into a new object. If one point of a stroke is 
selected, the entire stroke will be separated. 


Active Layer 
Separate all the strokes in the active layer into a new object. See 2D Layers 
for more information. 


Clean Up 
These tools help to cleanup degenerate geometry on the strokes. 
Boundary Strokes 


Reference 


Mode: Edit Mode 
Menu: Grease Pencil » Clean Up » Boundary Strokes 


Removes boundary strokes used by the Fill tool. See Fill tool for more 
information. 


Mode 
Active Frame Only 
Removes boundary strokes from the current frame. 


All Frames 
Removes boundary strokes from all frames. 


Boundary Strokes All Frames 


Reference 


Mode: Edit Mode 
Menu: Grease Pencil » Clean Up >» Boundary Strokes all Frames 


Same as Boundary Strokes but Mode is set to All Frames. 


Delete Loose Points 


Reference 


Mode: Edit Mode 
Menu: Grease Pencil » Clean Up » Delete Loose Points 


Removes unconnected points. 
Merge by Distance 


Reference 


Mode: Edit Mode 
Menu: Grease Pencil » Clean Up > Merge by Distance 


Merge by Distance is a useful tool to simplify a stroke by merging the selected 
points that are closer than a specified distance to each other. Note, unless 


using Unselected, selected points must be contiguous, else they will not be 
merged. 


Merge Distance 
Sets the distance threshold for merging points. 


Unselected 


Allows points in selection to be merged with unselected points. When 
disabled, selected points will only be merged with other selected ones. 


Delete Duplicate Frames 


Reference 
Mode: Edit Mode 
Menu: Grease Pencil » Clean Up » Delete Duplicated Frames 


Removes any duplicated animation frames. 


Reproject 

Reference 

Mode: Edit Mode 

Menu: Grease Pencil » Clean Up » Reproject 


Sometimes you may have drawn strokes unintentionally in different locations in 
the 3D space but they look right from a certain plane or from the camera view. 


You can use Reproject to flatten all the selected strokes from a certain 
viewpoint. 


Reprojected Type 


Front: Reproject selected strokes onto the front plane (XZ). 
Side: Reproject selected strokes onto the side plane (YZ). 
Top: Reproject selected strokes onto the top plane (XY). 
View: Reproject selected strokes onto the current view. 
Surface: Reproject selected strokes onto the mesh surfaces. 
Cursor: Reproject selected strokes onto 3D cursor rotation. 


Surface Offset 


When Surface Mode is activated controls the stroke offset from the object. 


Keep Original 
Maintains the original strokes after applying the tool. 
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Recalculate Geometry 


Reference 
Mode: Edit Mode and Draw Mode 
Menu: Grease Pencil » Clean Up » Recalculate Geometry 


This operator updates all internal geometry data. It is not intended that you will 
have to use this operator but it can help in cases where strokes are drawn ina 
strange way or when you opened an old file. 


Delete 

Reference 

Mode: Edit Mode 

Menu: Grease Pencil >» Delete 
Shortcut: X, Delete, Ctrl-X 


Options for the Erase pop-up menu: 


Points 
Deletes the selected points. When only one point remains, there is no more 
visible stroke, and when all points are deleted, the stroke itself is deleted. 
Strokes 
Deletes all the strokes that selected points belongs to. 


Frames 
Deletes all the strokes at the current frame and in the current layer/channel. 


Dissolve Ctrl-X 


Deletes the selected points without splitting the stroke. The remaining points 
in the strokes stay connected. 


Dissolve between Ctrl-X 


Deletes all the points between the selected points without splitting the 
stroke. The remaining points in the strokes stay connected. 


Dissolve Unselect ctrl-x 
Deletes all the points that are not selected in the stroke without splitting the 
stroke. The remaining points in the strokes stay connected. 


Delete All Active Frames 
Deletes all the strokes at the current frame in all layers/channels. 


Stroke Menu 


This page covers many of the tools in the Strokes menu. 
These are tools that work primarily on strokes, however, 
some also work with point selections. 


Subdivide 


Reference 
Mode: Edit Mode 
Menu: Stroke > Subdivide 


Subdivides the strokes by inserting points between the 
selected points. 


Number of Cuts 
The number of subdivisions to perform. 


Smooth 
The amount of the smoothness on subdivided points. 


Repeat 
Number of times to repeat the procedure. 


Selected Points 
When enabled, limits the effect to only the selected 
points within the stroke. 


Position 
When enabled, the operator affect the points location. 


Thickness 


When enabled, the operator affect the points thickness. 


Strength 
When enabled, the operator affect the points strength 
(alpha). 


UVs 
When enabled, the operator affect the UV rotation on the 
points. 


Simplify 


Reference 
Mode: Edit Mode 
Menu: Stroke » Simplify 


Reduce the amount of points in the strokes. 


Fixed 
Deletes alternated points in the strokes, except the start 
and end points. 


Steps 
The number of times to repeat the procedure. 


Adaptive 
Uses the RDP algorithm (Ramer-Douglas-Peucker 
algorithm) for points deletion. The algorithm tries to 
obtain a similar line shape with fewer points. 


Factor 
Controls the amount of recursively simplifications 
applied by the algorithm. 


Sample 
Recreates the stroke geometry with a predefined length 
between points. 


Length 
The distance between points on the recreated stroke. 
Smaller values will require more points to recreate the 
stroke, while larger values will result in fewer points 
needed to recreate the curve. 


Sharp Threshold 
The maximum angle between points on the recreated 
stroke. Smaller values will require more points to 
recreate the stroke, while larger values will result in 
fewer points needed to recreate the curve. 


Trim 

Reference 

Mode: Edit Mode 
Menu: Stroke > Trim 


Trims selected stroke to first loop or intersection. 


Original stroke. Result of trim 


operation. 
Outline 
Reference 
Mode: Edit Mode 
Menu: Stroke > Outline 


Converts a stroke to an outline. 


View 
The projection method to generate the outline 


View: Use the viewport’s view as a projection. 
Front: Use the X-Z axes view as a projection. 
Side: use the Y-Z axis view as a projection 
Top: Use the X-Y axes view as a projection 
Camera: Use the view from the active camera as 


a projection. 


Material Mode 
How materials are assigned to the outline. 


Active Material: 
The stroke outline will be assigned the 
active material. 

Keep Material: The stoke outline will have the same 
material as before. 

New Material: A new material will be created and 
assigned to the outline. 


Thickness 
Thickness of the stroke perimeter. 


Keep Shape 
Try to keep global shape when the stroke thickness 
change. 


Subdivisions 
Number of subdivisions for the start and end caps. 


Sample Length 
The length each resulting segment of the outline. Smaller 
values create outlines closer to the original shape. 


Generated stroke 


Original stroke. after outline 
operation. 
Join 
Reference 
Mode: Edit Mode 
Menu: Stroke » Join > Join, Join and Copy 


Shortcut: Ctrled. Shitt=Ctri<3 


Join two or more strokes into a single one. 


Type 
Join ctri-J 
Join selected strokes by connecting points. 


Join and Copy Shift-Ctrt-J 


Join selected strokes by connecting points in a new 
stroke. 


Leave Gaps 


When enabled, do not use geometry to connect the 
strokes. 


Move to Layer 


Reference 

Mode: Edit Mode 

Menu: Stroke » Move to Layer 
Shortcut: M 


A pop-up menu to move the stroke to a different layer. You 


can choose the layer to move the selected strokes to from a 


list of layers of the current Grease Pencil object. You can 
also add a new layer to move the selected stroke to. When 


creating a new layer, there is another pop-up to type in the 
name of the new layer. 


Assign Material 


Reference 


Mode: Edit Mode 


Menu: Stroke » Assign Material 


Changes the material linked to the selected stroke. You can 
choose the name of the material to be used by the selected 
stroke from a list of materials of the current Grease Pencil 
object. 


Set as Active Material 


Reference 
Mode: Edit Mode 
Menu: Stroke > Set as Active Material 


Sets the active object material based on the selected stroke 
material. 


Arrange 

Reference 

Mode: Edit Mode 
Menu: Stroke » Arrange 


Change the drawing order of the strokes in the 2D layer. 


Bring to Front 
Moves to the top the selected points/strokes. 


Bring Forward 
Moves the selected points/strokes upper the next one in 
the drawing order. 


Send Backward 


Moves the selected points/strokes below the previous one 
in the drawing order. 


Send to Back 
Moves to the bottom the selected points/strokes. 


Close 

Reference 

Mode: Edit Mode 
Menu: Stroke >» Close 
Shortcut: F 


Close or open strokes by connecting the last and first point. 


Type 
Close All 
Close all open selected strokes. 


Open All 
Open all closed selected strokes. 


Toggle 
Close or Open selected strokes as required. 


Create Geometry 
When enabled, points are added for closing the strokes. If 
disabled, the operator act the same as Toggle Cyclic. 


Toggle Cyclic 


Reference 


Mode: Edit Mode 
Menu: Stroke >» Toggle Cyclic 


Toggles between an open stroke and closed stroke (cyclic). 


Type 
Close All 
Close all open selected strokes. 


Open All 
Open all closed selected strokes. 


Toggle 
Close or Open selected strokes as required. 


Create Geometry 
When enabled, points are added for closing the 
strokes like when using the Close tool. If disabled, the 
stroke is close without any actual geometry. 


Toggle Caps 


Reference 
Mode: Edit Mode 
Menu: Stroke » Toggle Caps 


Toggle ending cap styles of the stroke. 


Default 
Sets stroke start and end points to rounded (default). 


Both 
Toggle stroke start and end points caps to flat or 
rounded. 


Start 
Toggle stroke start point cap to flat or rounded. 


End 
Toggle stroke end point cap to flat or rounded. 
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Switch Direction 


Reference 
Mode: Edit Mode 
Menu: Stroke > Switch Direction 


Reverse the direction of the points in the selected strokes 
(i.e. the start point will become the end one, and vice 


versa). 
Set Start Point 


Reference 


Mode: Edit Mode 
Menu: Stroke > Set Start Point 


Set the start point for cyclic strokes. 


Normalize Thickness 


Reference 
Mode: Edit Mode 
Menu: Stroke >» Normalize Thickness 


Makes the thickness equal for the entire stroke. 


Mode 
Stroke Property to normalize. 


Value 
Thickness value to use on all points of the stroke. 


Normalize Opacity 


Reference 


Mode: Edit Mode 
Menu: Stroke » Normalize Opacity 
Makes the opacity equal for the entire stroke. 


Mode 
Stroke Property to normalize. 


Value 
Opacity value to use on all points of the stroke. 


Scale Thickness 


Reference 


Mode: Edit Mode 
Menu: Stroke > Scale Thickness 


When enabled, scales the stroke thickness during scale 
transformations. 


Reset Fill Transform 


Reference 


Mode: Edit Mode 
Menu: Stroke > Reset Fill Transform 


Reset all fill translation, scaling and rotations in the selected 
strokes. 


Point Menu 


Extrude 

Reference 

Mode: Edit Mode 

Menu: Point > Extrude 
Tool: Toolbar > Extrude 
Shortcut: E 


Extrudes points by duplicating the selected points, which 
then can be moved. The new points stay connected with the 
Original points of the edit line. 


Note 


Since Grease Pencil strokes can only have one start an end 
point, a new stroke will be created when extrude 
intermediate points in the strokes. 


Smooth 

Reference 

Mode: Edit Mode 
Menu: Point » Smooth 


Softens strokes by reducing the differences in the locations 
of the points along the line, while trying to maintain similar 


values that make the line fluid and smoother. 


Repeat 
The number of times to repeat the procedure. 


Factor 
The amount of the smoothness to apply. 


Selected Points 
When enabled, limits the effect to only the selected 
points within the stroke. 


Position 
When enabled, the operator affect the points location. 


Thickness 
When enabled, the operator affect the points thickness. 


Strength 
When enabled, the operator affect the points strength 
(alpha). 


UVs 
When enabled, the operator affect the UV rotation on the 
points. 


Merge 


Reference 
Mode: Edit Mode 
Menu: Point » Merge 


Combine all selected points into a unique stroke. All the 
selected points will be connected by new edit lines when 


needed to create the new stroke. 


Vertex Paint Mode 
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Introduction 


Vertex Painting is a simple way of painting color onto a 
Grease Pencil object, by directly manipulating the color of 
points/vertices, rather than use only the materials base 
color. 


Stroke with original base material color (left) and 
with vertex painting (right). 


When a point is painted, the color of the points is mixing 
with the base material color according to the settings of the 
brush. 


Note 


A vertex in Grease Pencil is called point. Point and vertex 
names are equivalent. 


Vertex Paint Mode 


Vertex Paint Mode is selected from the Mode menu in the 3D 
Viewport header. Once Vertex Paint Mode is activated, the 
Toolbar of the 3D Viewport will change to Vertex Paint Mode 
specific panels. 
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3D Viewport Mode selector set to Vertex Paint Mode. 


Vertex Paint Options 


o-o 


Pp Vertex Paint vig 


General Vertex Paint options. 


Selection Mask 
Vertex Paint Mode in Grease Pencil allows you to select 
points or strokes to restrict the effect of the painting 
tools to only a certain areas of your drawing. 


You can use the selection tools in the Toolbar for a quick 
selections. 


You can restrict painting only on the selected points or 
strokes with the Selection mode toggle. 


Multiframe 


Sometimes you may need to modify several frames at 
the same time with the painting tools. 


You can activate multiframe edition with the Multiframe 
button next to the modes selector (faded lines icon). See 
Multiframe for more information. 


Vertex Paint Tools 


Draw 
Paints a specified color over the object. 


Blur 


Smooths out the colors of adjacent vertices. 


In this mode the Color Value is ignored. The 
strength defines how much the colors are 
blurred. 


Average 


Smooths color by painting the average 
resulting color from all colors under the 
brush. 


Smear 


Draw 


Blur 


Average 


Smear 


— Replace 


Annotate 


Select Box 


Smudges colors by grabbing the colors under the brush 
and “dragging” them. This can be imagined as a finger 


painting tool. 


Replace 


Change the color only to the stroke points that already 


have a color applied. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Brush Settings 


Painting needs paint brushes and Blender provides a Brush 
panel within the Toolbar when in Vertex Paint Mode. 


Brush 
In the Data-Block menu you find predefined Brush 


presets. And you can create your own custom presets as 
needed. 


Radius 
This option controls the radius of the brush, measured in 
pixels. F allows you to change the brush size interactively 
by dragging the mouse and then Lms (the texture of the 
brush should be visible inside the circle). Typing a 
number then enter while using F allows you to enter the 
size numerically. 


Pressure 
Brush size can be affected by enabling the pressure 
sensitivity icon, if you are using a Graphics Tablet. 


Strength 
How powerful the brush is when applied. 


Pressure 
Strength can be affected by enabling the pressure 
sensitivity icon, if you are using a Graphics Tablet. 


Mode 
Stroke: Only paint over strokes. 
Fill: Only paint over fill areas. 


Stroke & Fill: Paint over strokes and fill areas. 


Cursor 
See the global brush settings for Cursor settings. 


Color Picker 


The color of the brush. See Color Picker. 


Note 


Note that Vertex Paint works in SRGB space and the RGB 
representation of the same colors will be different between 
the paint tools and the materials that are in linear space. 


Color Palette 


The active Color Palette. See Color Palette. 


Falloff 


See the global brush settings for Falloff settings. 


Editing 


Set Color Attribute 


Reference 
Mode: Vertex Paint Mode 
Menu: Paint > Set Color Attribute 


Sets the active color to all selected vertices. 


Reset Vertex Color 


Reference 


Mode: Vertex Paint Mode 
Menu: Paint » Reset Vertex Color 


Removes the Color Attribute information of the active 
strokes, if no strokes are selected, all strokes are reset. 


Invert 

Reference 

Mode: Vertex Paint Mode 
Menu: Paint > Invert 


Invert RGB values. 


Levels 


Reference 


Mode: 


Vertex Paint Mode 
Menu: 


Paint > Levels 


Adjust the levels of Color Attributes. 


Hue Saturation Value 


Reference 


Mode: 


Vertex Paint Mode 
Menu: 


Paint >» Hue Saturation Value 


Adjust the color’s HSV values. 


Bright/Contrast 


Reference 


Mode: 


Vertex Paint Mode 
Menu: 


Paint > Bright/Contrast 


Adjust the color’s brightness/contrast. 


Weight Paint Mode 
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Introduction 


Assigning weight to the points is primarily used for rigging 
strokes in cut-out animation, where the vertex groups are 
used to define the relative bone influences on the strokes. 
See Using Vertex Group for more information. 


Note 


A vertex in Grease Pencil is called point. Point and vertex 
names are equivalent. 


Weight Painting is a method to maintain large amounts of 
weight information in an intuitive way. The selected Grease 
Pencil object is displayed slightly shaded with a rainbow 
color spectrum. The color visualizes the weights associated 
to each point in the active vertex group. By default blue 
means unweighted and red means fully weighted. 


You assign weights to the points of the object by painting on 
it with weight brushes. Starting to paint on a strokes 
automatically adds weights to the active vertex group (a 
new vertex group is created if needed). 


Weight Paint 


ey a. Radius 
fF) Weight Paint » ((C 
@ Object Mode rive 
fa Edit Mode 

a Sculpt Mode 

a Draw 


"me Vertex Paint 


5) Weight Paint 


3D Viewport Mode selector: Weight Paint Mode. 


Weight Paint Mode is selected from the Mode menu in the 
3D Viewport header. Once Weight Paint Mode is activated, 
the Toolbar of the 3D Viewport will change to Weight Paint 
Mode specific panels. A red circle will appear and follow the 
location of the cursor in the 3D Viewport. 


Weight Options 


Multiframe 


Sometimes you may need to assign weight to several 
frames at the same time with the Weight Paint tools. 


You can activate multiframe edition with the Multiframe 
button next to the modes selector (faded lines icon). See 
Multiframe for more information. 


Weight Paint Tools 


For Grease Pencil Weight Paint modes each brush type is 
exposed as a tool, the brush can be changed in the Tool 
Settings. See Brush for more information. 


Draw WA. “eight 
Paints a specified weight over the strokes. 


f. Annotate 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Brush 


Painting needs paint brushes and Blender provides a Brush 
panel within the Toolbar when in Weight Paint Mode. 


Brush 
In the Data-Block menu you find predefined Brush 
presets. And you can create your own custom presets as 
needed. 


Radius 
The radius defines the area of influence of the brush. 


Strength 
This is the amount of paint to be applied per brush 
stroke. 


Use Falloff 
When enabled, use Strength falloff for the brush. Brush 
Strength decays with the distance from the center of the 
brush. 


Weight 
The weight (visualized as a color) to be used by the 
brush. 


Weights Menu 


Reference 
Mode: Edit Mode 
Menu: Weights 


This page covers many of the tools in the Weights menu. 


Normalize All 


Reference 
Mode: Edit Mode 
Menu: Weights >» Normalize All 


For each point, this tool makes sure that the sum of the 
weights across all vertex groups is equal to 1. It normalizes 


all of the vertex groups, except for locked groups, which 
keep their weight values untouched. 


Lock Active 


Keep the values of the active group while normalizing all 
the others. 


Normalize 
Reference 
Mode: Edit Mode 


Menu: Weights >» Normalize 


This tool only works on the active vertex group. All points 
keep their relative weights, but the entire set of weights is 
scaled up such that the highest weight value is 1.0. 


Invert 

Reference 

Mode: Edit Mode 
Menu: Weights > Invert 


Replaces each weight of the selected vertex group by x -1.0 
weight. 


Examples: 


e Original 1.0 converts to 0.0 
e Original 0.5 remains 0.5 
e Original 0.0 converts to 1.0 


Subset 


Restrict the tool to a subset. See The Subset Option 
about how subsets are defined. 


Add Weights 


Add vertices that have no weight before inverting (these 
weights will all be set to 1.0). 


Remove Weights 


Remove vertices from the vertex group if they are 0.0 
after inverting. 


Smooth 


Reference 


Mode: Edit Mode 
Menu: Weights » Smooth 


Smooths the weights of the active vertex group. 


Generate Weights 


Reference 
Mode: Edit Mode 
Menu: Weights » Generate Weights 


Generate automatic weight for armatures (requires an 
Armature modifier). 


With Empty Group 
When parenting it will create an empty vertex groups on 
the child objects (if they do not exist already) for and 
named after each deforming bone in the armature. 


With Automatic Weights 
Works similar to With Empty Groups, but it will not leave 
the vertex groups empty. It calculates how much 
influence a particular bone would have on points based 
on the distance from those points to a particular bone 
(“bone heat” algorithm). This influence will be assigned 
as weights in the vertex groups. 


Object Mode 


e Convert to Geometry 
o Options 
o Example 
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o Usage 
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Convert to Geometry 


Reference 
Mode: Object Mode 
Menu: Object >» Convert > Path, Bézier Curve, 


Polygon Curve 


In the 3D Viewport, sketches on the active layer can be 
converted to geometry, based on the current view settings, 
by transforming the points recorded when drawing (which 
make up the strokes) into 3D space. Currently, all points will 
be used, so it may be necessary to simplify or subdivide 
parts of the created geometry for standard use. Sketches 
can currently be converted into curves in Object Mode. 


Options 


Type 
The type of object to convert to. 


Path 
Create NURBS 3D curves of order 2 (i.e. behaving like 
polylines). 


Bézier Curve 
Create Bézier curves, with free “aligned” handles (i.e. 
also behaving like polylines). 


Polygon Curve 
Bézier curve with straight line segments (auto 
handles). 


Note 
Converting to Mesh 


If you want to convert your sketch to a mesh, simply 
choose NURBS first, and then convert the created curve 
to a mesh. 


Bevel Depth 
The Bevel Depth to use for the converted curve object. 


Bevel Resolution 
The Bevel Resolution to use for the converted curve 
object. 


Normalize Weight 
Will scale weights value so that they fit into the (0.0 to 
1.0) range. 


Radius Factor 
Multiplier for the points’ radii (Set from the stroke’s 
width). 


Link Strokes 
Will create a single spline, i.e. curve element, from all 
strokes in active Grease Pencil layer. This is especially 
useful if you want to use the curve as a path. All the 
strokes are linked in the curve by “zero weights/radii” 
sections. 


Timing 


Grease Pencil stores “dynamic” data, i.e. how fast strokes 
are drawn. When converting to curve, this data can be used 
to create an Evaluate Time F-Curve (in other words, a path 


animation), that can be used e.g. to control another object’s 
position along that curve (Follow Path constraint, or, 
through a driver, Curve modifier). So this allows you to 
reproduce your drawing movements. 


Link Strokes has to be enabled for all timing options. 


Timing Mode 
This control lets you choose how timing data is used. 


No Timing 
Just create the curve, without any animation data 
(hence all following options will be hidden). 


Linear 
The path animation will be a linear one. 


Original 
The path animation will reflect to original timing, 
including for the “gaps” (i.e. time between strokes 
drawing). 


Custom Gaps 
The path animation will reflect to original timing, but 
the “gaps” will get custom values. This is especially 
useful if you want to shorten large pauses between 
some strokes. 


Frame Range 
The “length” of the created path animation, in frames. In 
other words, the highest value of Evaluation Time. 


Start Frame 
The starting frame of the path animation. 


Realtime 


When enabled, the path animation will last exactly the 
Same duration it has taken you to draw the strokes. 


End Frame 
When Realtime is disabled, this defines the end frame of 
the path animation. This means that the drawing timing 
will be adjusted to fit into the specified range. 


Gap Duration 
Custom Gaps only. The average duration (in frames) of 
each gap between strokes. Please note that, the value 
will only be exact if Realtime is enabled, otherwise it will 
be scaled, exactly as the strokes’ timing is. 


Example 


Here is a simple “hand writing” video created with curves 
converted from sketch data. 


The blend-file from the above example can be found here. 


Trace Image to Grease 
Pencil 


Reference 
Mode: Object Mode 
Menu: Object >» Convert > Trace Image to 


Grease Pencil 


The Trace Image to Grease Pencil tool traces a black and 
white image and generates Grease Pencil strokes. If the 
image is not black and white, it will be internally converted. 
For better results, convert the images manually to black and 
white. Also try to keep the resolution of the image small; 
high resolutions can produce very dense strokes. 


Usage 


1. Add an Image Empty to the scene. 
2. Run Trace Image to Grease Pencil. 


Options 


Target Object 


The Grease Pencil object name. If left empty, a new 
Grease Pencil object will be created. 


Thickness 
The thickness of the generated Grease Pencil strokes. 


Resolution 
Resolution of the generated Grease Pencil strokes i.e. 
how many control points the stroke will have. A higher 
resolution will preserve more detail from the original 
image. 


Scale 
The object scale applied to the generated Grease Pencil 
object. 


Sample 
Recreates the stroke geometry with a predefined length 
between points. Smaller values will require more points 
to recreate the stroke, while larger values will result in 
fewer points needed to recreate the curve. A value of 0 
disables stroke sampling. 


Color Threshold 
Determine the Luminance threshold above which strokes 
are generated. 


Turn Policy 
Determines how to resolve ambiguities during 
decomposition of an image into paths. 


Black: Prioritizes to connect black 
(foreground) components. 

White: Prioritizes to connect white 
(background) components. 

Left: Always take a left turn. 

Right: Always take a right turn. 

Minority: Prioritizes to connect the color (black or 


white) that occurs least frequently in 
the local neighborhood of the current 
position. 

Majority: 


Prioritizes to connect the color (black or 
white) that occurs most frequently in 
the local neighborhood of the current 
position. 

Random: Choose pseudo-randomlly. 


Mode 
Determines if the image being traced is a single image or 
image sequence. 


Single: The image empty is a single image or 
the current frame of an image 
sequence. 

Sequence: The image empty is an Image 
Sequence. 


Start at Current Frame 
When enabled, start the tracing process at the current 
image frame. 


Trace Frame 
Used to trace only one frame of the image sequence, set 
to zero to trace all. 
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Troubleshooting 


e Markers 
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Types 

Visualization 

Add Marker 

Selecting 

Editing 

Bind Camera to Markers 


Shape Keys 
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Introduction 
Shape Keys Panel 
Workflow 


Motion Paths 


Options 
Example 


Introduction 


Animation 


Animation is making an object move or change shape over 
time. Objects can be animated in many ways: 


Moving as a whole object 
Changing their position, orientation or size in time; 


Deforming them 
Animating their vertices or control points; 


Inherited animation 
Causing the object to move based on the movement of 
another object (e.g. its parent, hook, armature, etc.). 


In this chapter, we will cover the first two, but the basics 
given here are actually vital for understanding the following 
chapters as well. 


Animation is typically achieved with the use of keyframes. 


See also 
Related Sections 


e Physical Simulation 
e Motion Tracking 


State Colors 


Y Transform Y Transform Y Transform ¥ Transform 


Location Location Location Location 
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State colors of properties. 
Properties have different colors and menu items for different 
states. 


Gray Not animated 


Keyframed on the current 


Yellow 
frame 
G Keyframed on a different 
reen 
frame 
Changed from the 
range keyframed value 
Purple Controlled by a driver 


The changed value highlight currently doesn’t work with 
NLA. 


Rigging 


Rigging is a general term used for adding controls to 
objects, typically for the purpose of animation. 


Rigging often involves using one or more of the following 
features: 


Armatures 
This allows mesh objects to have flexible joints and is 
often used for skeletal animation. 


Constraints 
To control the kinds of motions that make sense and add 
functionality to the rig. 


Object Modifiers 
Mesh deformation can be quite involved, there are 
multiple modifiers that help control this. 


Shape Keys 
To support different target shapes (such as facial 
expressions) to be controlled. 


Drivers 
So your rig can control many different values at once, as 
well as making some properties automatically update 
based on changes elsewhere. 


Rigging can be as advanced as your project requires, rigs 
are effectively defining own user interface for the animator 
to use, without having to be concerned the underlying 
mechanisms. 


Examples 


e An armature is often used with a modifier to deform a 
mesh for character animation. 

e A camera rig can be used instead of animating the 
camera object directly to simulate real-world camera 
rigs (with a boom arm, mounted on a rotating pedestal 


for example, effects such as camera jitter can be added 
too). 


See also 


The content of this chapter is simply a reference to how 
rigging is accomplished in Blender. It should be paired with 
additional resources such as Nathan Vegdahl’s excellent 
introduction to the fundamental concepts of character 
rigging, Humane Rigging. 


Keyframes 


e Introduction 
o Visualization 
o Interpolation 
o Keyframe Types 
o Handles & Interpolation Mode Display 
e Editing 
Insert Keyframe 
Delete Keyframes 
Clear Keyframes 
Editing _Keyframes 
Examples 
e« Keying Sets 
o Keying Set Panel 
o Active Keying Set Panel 
o Adding Properties 
o Whole Character Keying Set 


o Oo 0 0 90 


Introduction 


A Keyframe is simply a marker of time which stores the 
value of a property. 


For example, a Keyframe might define that the horizontal 
position of a cube is at 3 m on frame 1. 


The purpose of a Keyframe is to allow for interpolated 
animation, meaning, for example, that the user could then 
add another key on frame 10, specifying the cube’s 
horizontal position at 20 m, and Blender will automatically 
determine the correct position of the cube for all the frames 
between frame 1 and 10 depending on the chosen 
interpolation method (e.g. Linear, Bézier, Quadratic, etc.). 


An overview of existing keyframes can be seen via the Dope 
Sheet editor. 


Visualization 


There are some important visualization features in the 3D 
Viewport that can help animation. 


When the current frame is a keyframe for the current active 
object, the name of this object (shown in the upper left 
corner of the 3D Viewport) turns yellow. 


Object Mode 


User Perspective 


Object Mode + View 


User Perspective 
(10) Collection | Cube 


Top: Current frame is a keyframe for Cube. Bottom: 
Current frame isn’t a keyframe. 


Interpolation 


Keyframe interpolation is represented and controlled by 
animation curves, also Known as F-Curves. These curves can 
be viewed and modified via the Graph Editor. 


Constant, Linear, Quadratic and Bézier interpolation, 
with Linear extrapolation. 


The X axis of the curve corresponds to time, while Y 
represents the value of the property. Keyframes themselves 
define points of the curve, while interpolation is controlled 
by additional parameters. 


The Interpolation Mode is the main setting that specifies for 
each keyframe how the curve is interpolated from that key 
to the next one. There are a number of modes with fixed 
Shapes, e.g. Constant, Linear, Quadratic etc, and a free form 
Bézier mode. 


Extrapolation specifies how the curve extends before the 
first, and after the last keyframe. The main available choices 
are Constant and Linear; it is also possible to configure the 
curve to loop. 


Bézier interpolation is controlled by handles, which have a 
handle type and position. The position of Free and Aligned 
handles must be set manually from the Graph editor, while 
Vector, Automatic and Auto Clamped handles are computed 
automatically from keyframe values. 


Interpolation, Extrapolation and Handle Type can also be 
changed from the Dope Sheet editor. 


Auto Clamped 
| Vi 


Vector 


| 


Handle smoothing modes. Yellow: None, Cyan: 
Continuous Acceleration. 


The method how the three automatic handle types are 
computed is controlled by the per-curve Auto Handle 
Smoothing setting. The None mode resembles how most 
other software works and only considers the values of the 
immediately adjacent keys. The Continuous Acceleration 
mode considers the shape of the whole curve, which 
produces smoother results out of the box, but means that 
changes in one key affect interpolation over a larger section 
of the curve; it also tends to overshoot more with Automatic 
handles. 


Keyframe Types 


For visually distinguishing regular keyframes from different 
animation events or states (extremes, breakdowns, or other 
in-betweens) there is the possibility of applying different 
colors on them for visualization. 


Keyframe (white / ee aa 
yellow diamond) 
Normal Key Marne: Left: not selected; Right: selected. 


Breakdown (small cyan 
diamond) 
Breakdown state. e.g. for transitions between key poses. 


Moving Hold (dark gray / orange diamond) 
A keyframe that adds a small amount of motion around a 
holding pose. In the Dope Sheet it will also display a bar 
between them. 


Extreme (big pink diamond) 
An ‘extreme’ state, or some other purpose as needed. 


Jitter (tiny green diamond) 
A filler or baked keyframe for keying on ones, or some 
other purpose as needed. 


Handles & Interpolation Mode 
Display 


Dope Sheet can display the Bézier handle type associated 
with the keyframe, and mark segments with non-Bézier 
interpolation. This facilitates basic editing of interpolation 
without the use of the Graph Editor. 


The icon shape represents the type of the Bézier Handles 
belonging to the keyframe. 


Auto 
Circle Clamped 
(default) From top: summary, Bézier, linear. 
Circle With Aotamatc 
Dot 
Square Vector 
Clipped 
Diamond evanee 


Diamond __‘ Free 


If the handles of a keyframe have different types, or in case 
of summary rows representing multiple curves, out of the 
available choices the icon that is furthest down the list is 
used. This means that if a grouped row uses a circle icon, it 
is guaranteed that none of the grouped channels have a 
non-auto key. 


Horizontal green lines mark the use of non-Bézier 
Interpolation. The line is dimmed in summary rows if not all 
grouped channels have the same interpolation. 


Display of this information can be disabled via the Show 
Handles and Interpolation option of the Dope Sheet’s View 
Menu. 


Editing 


Insert Keyframe 


Reference 

Mode: Object Mode 

Menu: Object >» Animation » Insert Keyframe... 
Shortcut: I 


There are several methods of adding new keys. Namely: 


e In the 3D Viewport, pressing I will bring up a menu to 
choose what to add a keyframe to. 

e Hovering over a property and pressing I or with the 
context menu by RMB a property and choose /nsert 
Keyframe from the menu. 


Auto Keyframe 
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Timeline Auto Keyframe. 


Auto Keyframe is the record button in the Timeline header. 
Auto Keyframe adds keyframes automatically to the set 
frame if the value for transform type properties changes. 


See Timeline Keyframe Control for more info. 


Delete Keyframes 


Reference 

Mode: Object Mode 

Menu: Object » Animation » Delete Keyframes... 
Shortcut: Alt-I 


There are several methods of removing keyframes: 


e In the 3D Viewport press Alt-I to remove keys from 
selected objects on the current frame. 

e When the mouse is over a value, press Alt-I. 

e RMB a value and choose Delete Keyframe from the menu. 


Clear Keyframes 


Reference 

Mode: Object Mode 

Menu: Object » Animation » Clear Keyframes... 
Shortcut: Shift-Alt-I 


Removes all keyframes from the selected object. 


Editing Keyframes 


Keyframes can be edited in two editors. To do so go to either 
the Graph Editor or the Dope Sheet. 


Examples 


Keyframe Animation 


This example shows you how to animate a cube’s location, 
rotation, and scale. 


1. First, in the Timeline, or other animation editors, set the 
frame to 1. 

2. With the cube selected in Object Mode, press I in the 3D 
Viewport. From the Insert Keyframe menu select 
LocRotScale. This will record the location, rotation, and 
scale, for the cube on frame 1. 

. Set the frame to 100. 

. Use Move G, Rotate R, Scale s, to transform the cube. 

. Press I in the 3D Viewport. From the Insert Keyframe 
menu, select LocRotScale. 
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To test the animation, press Spacebar to play. 


Keying Sets 


Keying sets 
area 
collection 
of BBone Shape 
animated Delta Location 
p ro pe rt j es Delta Rotation 
that are mils Scale 
used to — 
animate , LocRotScale 
and LocScale 
keyframe Rotation 
multiple 
properties 
at the 
same time. 
For 
example, using keying sets you can press I in the 3D 
Viewport, Blender will add keyframes for all the properties in 
the active keying set. There are some built-in keying sets 
and, also custom keying sets called Absolute Keying Sets. To 
select and use a keying set, set the Active Keying Set in the 
Keying_popover in the Timeline header, or the Keying Set 
panel, or press Shift-Ctrl-Alt-I in the 3D Viewport. 


Available 


The Active Keying Sets data ID in the Timeline. 


Keying Set Panel 


Reference 


Editor: Properties 
Panel: Scene >» Keying Set 


This panel is used to add, select, manage Absolute Keying 
Sets. 


Y Keying Sets 


by Keying Set 


Description 


Export to File 
¥ Active Keying Set 


Paths 


Y Keyframing Settings 


General Override 


The Keying Set panel. 


Active Keying Set 
The List View of keying sets in the active scene. 


Add + 
Adds an empty keying set. 


Description 
A short description of the keying set. 


Export to File 
Export keying set to a Python script File.py. To re-add the 
keying set from the File.py, open then run the File. py 
from the Text Editor. 


Keyframing Settings 


General Override 
These options control all properties in the keying set. 
Note that the same settings in Preferences override 
these settings if enabled. 


Active Set Override 
These options control individual properties in the keying 
set. 


Common Settings 
Only Needed 
Only insert keyframes where they are needed in the 
relevant F-Curves. 


Visual Keying 
Insert keyframes based on the visual transformation. 


XYZ to RGB 
For new F-Curves, set the colors to RGB for the 
property set, Location XYZ for example. 


Active Keying Set Panel 


Reference 
Editor: Properties 
Panel: Scene > Active Keying Set 


This panel is used to add properties to the active keying set. 


¥ Active Keying Set 
Paths 


on! ’ 
.@ location 


Target ID-Blo.. 2» @ Cube 
Data Path 9S location 
Array Allltems 
F-Curve Grouping Keying Set Name 
¥ Keyframing Settings 


General Override Active Set Override 
af af 
fo & 


XYZtoRGB @@ of 


The Active Keying Set panel. 


Paths 
A collection of paths in a List View each with a Data Path 
to a property to add to the active keying set. 


Add + 
Adds an empty path. 


Target ID-Block 
Set the ID Type and the Object /Ds data path for the 
property. 


Data Path 
Set the rest of the Data Path for the property. 


Array All Items 
Use All Items from the Data Path or select the array index 
for a specific property. 


F-Curve Grouping 


This controls what group to add the channels to. 


Keying Set Name, None, Named Group 


Adding Properties 


Reference 

Menu: Context menu » Add All/Single to Keying 
Set 

Shortcut: K 


Some ways to add properties to keying sets. 


RMB the property in the User Interface, then select Add Single 
to Keying Set or Add All to Keying Set. This will add the 
properties to the active keying set, or to a new keying set if 
none exist. 


Hover the mouse over the properties, then press k, to add 
Add All to Keying Set. 


Whole Character Keying Set 


The built-in Whole Character keying set is made to keyframe 
all properties that are likely to get animated in a character 
rig. It was also implicitly used by the Old Pose Library 
system. 


In order to determine which bones to add keys for, and 
which bones to skip, the keying set uses the bone names. 
The following bone name prefixes will be skipped: 


“COR”, “DEF”, “GEO”, “MCH”, “ORG”, “WIS” 


Armatures 
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Introduction 


An armature in Blender can be thought of as similar to the 
armature of a real skeleton, and just like a real skeleton an 
armature can consist of many bones. These bones can be 
moved around and anything that they are attached to or 
associated with will move and deform in a similar way. 


An “armature” is a type of object used for rigging. A rig is 
the controls and strings that move a marionette (puppet). 
Armature object borrows many ideas from real-world 
Skeletons. 


Your First Armature 


In order to see what we are talking about, let us try to add 
the default armature in Blender. 


(Note that armature editing details are explained in the 
armatures editing section.) 


Open a default scene, then: 


. Delete all objects in the scene. 

. Make sure the cursor is in the world origin with Shift-c. 

. Press Numpad1 to see the world in Front view. 

. Add a Single Bone (Add > Armature). 

. Press NumpadDelete to see the armature at maximum 
ZOOM. 
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The default armature. 


The Armature Object 


As you can see, an armature is like any other object type in 
Blender: 


e It has an origin, a position, a rotation and a scale factor. 

e It has an Object Data data-block, that can be edited in 
Edit Mode. 

e It can be linked to other scenes, and the same armature 
data can be reused on multiple objects. 

e All animation you do in Object Mode is only working on 
the whole object, not the armature’s bones (use the 
Pose Mode to do this). 


As armatures are designed to be posed, either for a static or 
animated scene, they have a specific state, called “rest 
position”. This is the armature’s default “shape”, the default 
position/rotation/scale of its bones, as set in Edit Mode. 


In Edit Mode, you will always see your armature in rest 
position, whereas in Object Mode and Pose Mode, you 


usually get the current “pose” of the armature (unless you 
enable the Rest Position button of the Armature panel). 


Bones 
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Introduction 


Bones are the base elements of armatures. The visualization 
of bones can be set in the Armatures Viewport Display. 


Classification 


Bones in an Armature can be generally classified into two 
different types: 


1. Deforming Bones 
2. Control Bones 


Deforming Bones 


Are bones which when transformed will result in vertices 
associated with them also transforming in a similar way. 
Deforming Bones are directly involved in altering the 
positions of vertices associated with their bones. 


Control Bones 


Are Bones which act in a similar way to switches, in that, 
they control how other bones or objects react when they are 
transformed. A Control Bone could for example act as a 
Sliding switch control when the bone is in one position to the 
left, it could indicate to other bones that they react ina 
particular way when transformed, and when the Control 
Bone is positioned to the right, transforming other bones or 
objects could do something completely different. Control 
Bones are not directly used to alter the positions of vertices; 


in fact, Control Bones often have no vertices directly 
associated with themselves. 


Structure 


They have three elements: 


1. The “start joint” named root 
or head. 

2. The “body” itself. 

3. And the “end joint” named tip 
or tail. 


With the default armature in Edit 
Mode, you can select the root and 
the tip, and move them as you do‘ The elements of a bone. 
with mesh vertices. 


Both root and tip (the “joints”) define the bone by their 
respective position. 


They also have a radius property, only useful for the 
envelope deformation method (see below). 


Roll 


Activating the Axes checkbox will show local axes for each 
bone’s tip. The Y axis is always aligned along the bone, 
oriented from root to tip, this is the “roll” axis of the bones. 


Bones Influence 


’ 


Basically, a bone controls a geometry when vertices “follow’ 
the bone. This is like how the muscles and skin of your 
finger follow your finger-bone when you move a finger. 


To do this, you have to define the 
strength of influences a bone has ona —Tipradius 
certain vertex. 


The simplest way is to have each bone | Ppsectaaerree 
affecting those parts of the geometry 
that are within a given range from it. 
This is called the envelope technique, oot radius 
because each bone can control only the 
geometry “enveloped” by its own 
influence area. 


A bone in 
If a bone is visualized as Envelope, in Envelope 
Edit Mode and in Pose Mode you can visualization, in 
see the area of influence, which Edit Mode. 


depends on: 


e« The distance property and 
e the root’s radius and the tip’s radius. 


Our armature in Envelope visualization, in Pose 
Mode. 


All these influence parameters are further detailed in the 
Skinning_pages. 


Tools 


e Toolbar 
¢ Tool Settings 
o Options 


Toolbar 


Mesh Edit Mode tools: 


select 
Select or move. 


Select Box 
Select geometry by dragging a box. 


Select Circle 
Select geometry by dragging a circle. 


Select Lasso 
Select geometry by drawing a lasso. 


Cursor 
Change the location of the 3D Cursor. 


Move 
Translation tool. 


Rotate 
Rotation tool. 


Scale 
Scale tool. 


Scale Cage 
Change the scale of an object by controlling its cage. 


Transform 
Tool to adjust the objects translation, rotations and scale. 


Annotate 
Draw free-hand annotation. 


Annotate Line 
Draw straight line annotation. 


Annotate Polygon 
Draw a polygon annotation. 


Annotate Eraser 
Erase previous drawn annotations. 


Measure 
Measure distances in the scene. 


Roll 


Rotates a bone around its local Y axis. 


Bone Size 
Todo. 


Bone Envelope 
Todo. 


Extrude 
Creates a new bone connected to the last selected joint. 


Extrude to Cursor 
Creates a new bone between the last selected joint 
and the mouse position. 


Shear 
Todo. 


Tool Settings 
Options 


X-Axis Mirror 


See X-Axis Mirror Pose Mode. 


Selecting 


You can select and edit bones of armatures in Edit Mode and 
in Pose Mode. Here, we will see how to select bones in Edit 
Mode. Selecting bones in Pose Mode is similar to selecting in 
Edit Mode with a few specific differences that will be 
detailed in the posing part. 


Similar to vertex/edge selection in meshes, there are two 
ways to select whole bones in Edit Mode: 


1. Directly, by selecting the bone’s body. 
2. Selecting both of its joints (root and tip). 


This is an important point to understand, because selecting 
bones’ joints only might lead to non-obvious behavior, with 
respect to which bone you actually select. 


Note that unlike the mesh display type, the armature 
display type has no effect on selection behavior. In other 
words, you can select a bone’s joint or body the same way 
regardless of the bone visualization chosen. 


Selecting Bone Joints 


To select bones’ joints you have the standard selection 
methods. 


Inverse Selection 


As stated above, you have to remember that these selection 
tools are for bones’ joints only, not the bones’ bodies. 


For example, the /nverse selection option Ctrt-I inverts the 
selection of bones’ joints, not of bones (see /nverse 
selection). 


Remember that a bone is selected only if both its joints are 
selected. So, when the selection status of bones’ joints is 
inverted, a new set of bones is selected. 


Inverse selection. 


The result of the 
inverse selection 
Ctrl-I: The bones 
Two bones selected. joints selection has 
been inverted, and 
not the bones 
selection. 


Selecting Connected Bone Joints 


Another example is: when you select the root of a bone 
connected to its parent, you also implicitly select the tip of 
its parent (and vice versa). 


Note 


Remember that when selecting bones’ joints, the tip of the 
parent bone is the “same thing” as the root of its children 


bones. 


Selecting Bones 


By clicking on a bone’s body, you will select it (and hence 
you will implicitly select its root and tip). 


Using Shift-click, you can add to/remove from the selection. 


You also have some advanced selection options, based on 
their relations. 


Pick Shortest Path ctri-click 
Selects the path from the active bone to the bone under 
the mouse. 


Deselecting Connected Bones 


There is a subtlety regarding connected bones. 


When you have several connected bones selected, if you 
deselect one bone, its tip will be deselected, but not its root, 
if it is also the tip of another selected bone. 


To understand this, look at Fig. Bone deselection in a 
selected chain.. 


Bone deselection in a selected chain. 


A selected chain. Two selected bones. 


After Sshift-clicking “Bone.003”: 


e “Bone.003” ‘s tip (which is same as “Bone.004” ‘s root) 
is deselected. 

e “Bone” is “Bone.003” ‘s parent. Therefore, “Bone.003” 
‘s root is the same as the tip of “Bone”. Since “Bone” is 
still selected, its tip is selected. Thus the root of 
“Bone.003” remains selected. 


Select Mirror 


Reference 

Mode: Edit Mode 

Menu: Select >» Select Mirror 
Shortcut: Shift-Ctri-M 


Flip the selection from one side to another. 


More/Less 

Reference 

Mode: Edit Mode 

Menu: Select >» More/Less 


More Ctrl-NumpadPlus 
Expand the current selection to the connected bones. 


Less Ctrl-NumpadMinus 


Contrast the selection, deselect bones at the boundaries 
of each selection region. 


Linked 


Reference 

Mode: Edit Mode 
Menu: Select > Linked 
Shortcut: Ctrl-L 


Selects all the bones in the chain which the active (last 
selected) bone belongs to. 


All Forks 
Selects all bones connected to the active bone even if 
the branch off from the current bone. 


Linked bones selection. 


A single selected Its whole chain 
bone. selected with Linked. 


Parent/Child 


Parent [, Child ] 


You can deselect the active bone and select its 
immediate parent or one of its children. 


Extend Parent/Child 


Extend Parent shift-[, Extend Child Shift-] 
Similar to Parent/Child but it keeps the active bone in the 
selection. 


Similar 

Reference 

Mode: Edit Mode 
Menu: Select > Similar 
Shortcut: Shift-G 

Children 


Extends the selection to all hierarchical descendant 
bones. 


Immediate Children 
Extends the selection to all direct child bones. 


Siblings 
Selects bones that have the same parent as the active 
bone. 


Length 
Selects bones with a similar bone length (between tip 
and tail) under the specified Threshold. 


Direction (Y axis) 


Select bones aligned on the Y axis (along the bone’s 
length). 


Prefix 
Select bones with matching name prefix (Separated by .). 


Suffix 
Select bones with matching name suffix (separated by .). 


Layer 
Select bones on the same layer. 


Group 
Select bones in the same group. 


Shape 


Select bones using the same shape object (in Pose 
Mode). 


Select Pattern 


Reference 
Mode: Object Mode 
Menu: Select >» Select Pattern... 


Selects all bones whose name matches a given pattern. 
Supported wild-cards: * matches everything, ? matches any 
single character, [abc] matches characters in “abc”, and 
[!'abc] match any character not in “abc”. As an example 
*house* matches any name that contains “house”, while 
floor* matches any name starting with “floor”. 


Case Sensitive 
The matching can be chosen to be case sensitive or not. 


Extend 
When Extend checkbox is checked the selection is 
extended instead of generating a new one. 


Editing 


Introduction 
o Add Menu 
o Locking Bones 
Transform 
o Scale Radius 
o Scale Envelope Distance 
o Align Bones 
Bone Roll 
o Recalculate Roll 
o Set Roll 
Extrude 
o Mouse Clicks 
Duplicate 
Fill Between Joints 
Split 
Separate Bones 
Subdivide 
Switch Direction 
Symmetrize 
Naming 
o Naming Conventions 
o Auto-Name 
o Flip Names 
Change Layers 
o Change Armature Layers 
o Change Bone Layers 
Parenting 
Properties 
Delete 
o Bones 
o Dissolve 


Introduction 


As with any other object, you edit your armature in Edit 
Mode Tab. 


The set of bone editing tools is quite similar to the one for 
mesh editing. 


Important 


One important thing to understand about armature editing 
is that you edit the rest position of your armature, i.e. its 
“default state”. An armature in its rest position has all 
bones with no rotation and scaled to 1.0 in their own local 
space. 


The different poses you might create afterwards are based 
on this rest position. So if you modify it in Edit Mode, all the 
poses already existing will also be modified. Thus you 
should in general be sure that your armature is definitive 
before starting to skin and pose it! 


Note 
Please note that some tools work on bones’ joints, while 


others work on bones themselves. Be careful not to get 
confused. 


Add Menu 


Reference 


Mode: Edit Mode 
Menu: Add 
Shortcut: Shift-A 


In the 3D Viewport, Shift-A to add a new bone to your 
armature. 


This bone will be: 


Of one unit of length. 

Oriented towards the global Z axis. 

With its root placed at the 3D cursor position. 
With no relationship with any other bone of the 
armature. 


Locking Bones 


You can prevent a bone from being transformed in Edit Mode 
in several ways: 


e All bones can be locked clicking on the Lock checkbox of 
their Transform panel in the Bones tab; 

e Press Shift-w Toggle Bone Options » Locked 

e Select Armature » Bone Settings > Toggle a Setting. 


If the root of a locked bone is connected to the tip of an 
unlocked bone, it will not be locked, i.e. you will be able to 
move it to your liking. This means that in a chain of 
connected bones, when you lock one bone, you only really 
lock its tip. With unconnected bones, the locking is effective 
on both joints of the bone. 


Transform 


We will not detail here the various ¥ Transform 
transformations of bones, nor things like Head 
axis locking, pivot points, and so on, as 
they are common to most object editing, 
and already described in the mesh section. [Illia 
The same goes for mirroring, as it is nearly ; 

the same as with mesh editing. Just keep in 
mind that bones’ roots and tips behave 


Radius 


more or less like meshes’ vertices, and Roll 


bones themselves act like edges in a mesh. Length 


Envelope 


As you know, bones can have two types of 


relationships: They can be parented, and in 
addition connected. Parented bones 
behave in Edit Mode exactly as if they had 
no relations. They can be moved, rotated, 


The Transform 
panel for 
armatures in 
Edit Mode. 


scaled, etc. without affecting their 

descendants. However, connected bones 

must always have parent’s tips connected to child’s roots, so 
by transforming a bone, you will affect all its connected 
parent/children/siblings. 


While with other transform tools, the “local axes” means the 
object’s axes, here they are the bone’s own axes (when you 
lock to a local axis, by pressing the relevant key twice, the 
constraint is applied along the selected bone’s local axis, not 
the armature object’s axis). 


Finally, you can edit in the Transform panel in the Sidebar 
region the positions and radius of both joints of the active 
selected bone, as well as its roll rotation. 


Scale Radius 


Reference 

Mode: Edit Mode 

Menu: Armature » Transform > Scale Radius 
Shortcut: AlLt-S 


You can alter the radius that a bone has by selecting the 
head, body or tail of a bone, and then press Alt-S and move 
the mouse left or right. If the body is selected the mean 
radius will be scaled. And as usual, with connected bones, you 
scale at the same time the radius of the parent’s tip and of 
the children’s roots. 


You can also alter the bone radius by selecting the tail or head 
of the bone you wish to alter, then navigate to Properties » 
Bone » Deform > Radius Section and entering new values for 
the Tail and Head number fields. 


Bone Scale and Scale Radius comparison. 


A single selected 
bone in Octahedron After normal scale. 
visualization. 


A single selected After Scaled Radius. 

bone in Envelope Its length remains the 

visualization. same, but its joints’ 
radius are bigger. 


Note that, when you resize a bone (either by directly scaling 
it, or by moving one of its joints), Blender automatically 
adjusts the end-radii of its envelope proportionally to the size 
of the modification. Therefore, it is advisable to place all the 
bones first, and only then edit their properties. 


Scale Envelope Distance 


Reference 

Mode: Edit Mode and Pose Mode 

Menu: Armature » Transform > Scale Envelope 
Distance 

Shortcut: Ctrl-Alt-S 


You can alter the size of the Bone Envelope volume by clicking 
on the body of the bone you want to alter, ctr1-Alt-s then 
drag your mouse left or right and the Bone Envelope volume 
will alter accordingly. 


You can also alter the Bone Envelope volume by selecting the 
Bone you wish to alter and then navigate to Properties >» Bone 


>» Deform > Envelope » Distance then enter a new value into 
it. 

Altering the Bone Envelope volume does not alter the size of 
the bone just the range within which it can influence vertices 
of child objects. 


Envelope scaling example. 


A single bone 
selected in Envelope 
visualization. 


Its envelope distance 
scaled. 


“Bone size” scaling example. 


The same 
A single armature in 
iderault Its Object Mode 
size” bone envelope and B Bone 
selected in distance visualization, 
B-Bone scaled. with . 
visualization. Bone.004 = 

size scaled 


up. 


Align Bones 


Reference 

Mode: Edit Mode 

Menu: Armature » Transform » Align Bones 
Shortcut: Ctrl-Alt-A 


Rotates the selected bones to achieve the same orientation as 
the active one. 


Bone Roll 


In Edit Mode, you can control the bone roll (i.e. the rotation 
around the Y axis of the bone). 


However, after editing the armature, or when using Euler 
Rotation, you may want to set the bone roll. 


Recalculate Roll 


Reference 

Mode: Edit Mode 

Menu: Armature > Bone Roll » Recalculate Roll 
Shortcut: Shift-N 


Axis Orientation 
Local Tangent 


Align roll relative to the axis defined by the bone and 
its parent. 


X,Z 


Global Axis 
Align roll to global X, Y, Z axis. 


Ke Nae 


Active Bone 
Follow the rotation of the active bone. 


View Axis 


Set the roll to align with the viewport. 


Cursor 
Set the roll towards the 3D cursor. 


Flip Axis 
Reverse the axis direction. 


Shortest Rotation 
Avoids rolling the bone over 90 degrees from its current 
value. 


Set Roll 


Reference 

Mode: Edit Mode 

Menu: Armature > Bone Roll >» Set Roll 
Shortcut: Ctrl-R 


This is a transform mode where you can edit the roll of all 
selected bones. 


Extrude 


Reference 

Mode: Edit Mode 

Menu: Armature > Extrude 
Shortcut: E, Shift-E 


When you press E, for each selected tip (either explicitly or 
implicitly), a new bone is created. This bone will be the child 
of “its” tip owner, and connected to it. As usual, once 
extrusion is done, only the new bones’ tips are selected, and 


in select mode, so you can place them to your liking. See 
Fig. Extrusion example.. 


Extrusion example. 


An armature with The three extruded 
three selected tips. bones. 


You also can use the rotating/scaling extrusions, as with 
meshes, by pressing respectively E R and E S - as well as 
locked extrusion along a global or local axis. 


Mirror extrusion example. 


A single selected The two mirror- 
bone’s tip. extruded bones. 


Bones have an extra “mirror extruding” tool, called by 
pressing Shift-E. By default, it behaves exactly like the 
standard extrusion. But once you have enabled X-Axis Mirror 
editing option, each extruded tip will produce two new 
bones, having the same name except for the “_L’/ “_R” 
suffix (for left/right, see the naming conventions). The “ L’ 
bone behaves like the single one produced by the default 
extrusion - you can move, rotate or scale it exactly the 
Same way. The “ _R” bone is its mirror counterpart (along the 
armature’s local X axis), see Fig. Mirror extrusion example.. 


Important 


Canceling the extrude action causes the newly created 
bones to snap back to the source position, (creating zero 
length bones). These will be removed when exiting Edit 
Mode, however, they can cause confusion and it’s unlikely 
you want to keep them. If you realize the problem 
immediately, undo the extrude action. 


In case you are wondering, you cannot just press x to solve 
this as you would in mesh editing, because extrusion selects 
the newly created tips, and as explained below the Delete 


tool ignores bones’ joints. To get rid of these extruded bones 
without undoing, you would have to move the tips, then 
select the bones and delete them. 


Mouse Clicks 


Reference 
Mode: Edit Mode 
Shortcut: Ctrl-RMB 


If at least one bone is selected, Ctrl-RMB-clicking adds a new 
bone. 


About the new bone’s tip: 


After you Ctrl-RMB-clicked it becomes the active element in 
the armature, it appears to be right where you clicked, but 
(as in mesh editing) it will be on the plane parallel to the 
view and passing through the 3D cursor. 


The position of the root and the parenting of the new bone 
depends on the active element: 


ctri-clicking when the active element is a bone. 


If the active element is a bone: 


e The new bone’s root is placed on the active bone’s tip. 
e The new bone is parented and connected to the active 
bone (check the Outliner in Fig. Ctrl-clicking when the 

active element is a tip.). 


ctri-clicking when the active element is a tip. 


If the active element is a tip: 


e The new bone’s root is placed on the active tip. 

e The new bone is parented and connected to the bone 
owning the active tip (check the Outliner in Fig. Ctrl- 
clicking when the active element is a tip.). 


ctri-clicking when the active element is a 
disconnected root. 


If the active element is a disconnected root: 


e The new bone’s root is placed on the active root. 


e The new bone is not parented to the bone owning the 
active root (check the Outliner in Fig. Ctrl-clicking when 
the active element is a disconnected root.). 


And hence the new bone will not be connected to any bone. 


ctri-clicking when the active element is a connected 
root. 


If the active element is a connected root: 


e The new bone’s root is placed on the active root. 

e The new bone is parented and connected to the parent 
of the bone owning the active root (check the Outliner in 
Fig. Ctrl-clicking_when the active element is a connected 
root.). 


This should be obvious because if the active element is a 
connected root then the active element will be also the tip 
of the parent bone, so it is the same as the second case. 


As the tip of the new bone becomes the active element, you 
can repeat these Ctri-RMB clicks several times, to 
consecutively add several bones to the end of the same 
chain. 


Duplicate 


Reference 

Mode: Edit Mode 

Menu: Armature >» Duplicate 
Shortcut: Shift-D 

Note 


This tool works on selected bones; selected joints are 
ignored. 


As in mesh editing, by pressing Shift-D the selected bones 
will be duplicated. The duplicates become the selected 
elements and they are placed in select mode, so you can 
move them wherever you like. 


If you select part of a chain, by duplicating it you will get a 
copy of the selected chain, so the copied bones are 
interconnected exactly like the original ones. 


The duplicate of a bone which is parented to another bone 
will also be parented to the same bone, even if the root 
bone is not selected for the duplication. Be aware, though, 
that if a bone is parented and connected to an unselected 
bone, its copy will be parented, but not connected to the 
unselected bone (see Fig. Duplication example.). 


Duplication example. 


An armature with 
three selected bones 
and a selected 
single root. 


The three duplicated 
bones. Note that the 
selected chain is 
preserved in the 
copy, and that 
Bone.006 is 
parented but not 
connected to 
Bone.OO1, as 
indicated by the 
black dashed line. 
Similarly, Bone.007 
is parented but not 
connected to 
Bone.003. 


Fill Between Joints 


Reference 

Mode: Edit Mode 

Menu: Armature » Fill Between Joints 
Shortcut: F 


The main use of this tool is to create one bone between two 


selected joints by pressing F, similar to how in mesh editing 
you can “create edges/faces”. 


If you have one root and one tip selected, the new bone: 


e Will have the root placed on the selected tip. 
e Will have the tip placed on the selected root. 


e Will be parented and connected to the bone owning the 
selected tip. 


Fill between a tip and a root. 


; Active tip on the 
Active tip on the left. right. 


If you have two tips selected, the new bone: 


e Will have the root placed on the selected tip closest to 
the 3D cursor. 

e Will have the tip placed on the other selected tip. 

e Will be parented and connected to the bone owning the 
tip used as the new bone’s root. 


Fill between tips. 


3D cursor on the 3D cursor on the 
left. right. 


If you have two roots selected, you will face a small problem 
due to the event system in Blender not updating the 
interface in real-time. 


When clicking F, similar to the previous case, you will see a 
new bone: 


e With the root placed on the selected root closest to the 
3D cursor. 

e With the tip placed on the other selected root. 

e Parented and connected to the bone owning the root 
used as the new bone’s root. 


If you try to move the new bone, Blender will update the 
interface and you will see that the new bone’s root moves to 
the tip of the parent bone. 


Fill between roots. 


Before Ul update (3D After UI update, 
correct visualization. 


cursor on the left). 


Clicking F with only one bone joint selected will create a 
bone from the selected joint to the 3D cursor position, and it 


will not parent it to any bone in the armature. 


Fill with only one bone joint selected. 


Fill with only one 
root selected. 


Fill with only one tip 
selected. 


You will get an error when: 


¢ Trying to fill two joints of the same bone. 
¢ Trying to fill more than two bone joints. 


Split 


Reference 

Mode: Edit Mode 
Menu: Armature » Split 
Shortcut: Y 


Disconnects the selection and clears the parent at the start 
and end. ToDo <2.8 add. 


Separate Bones 


Reference 

Mode: Edit Mode 

Menu: Armature » Separate Bones 
Shortcut: P 


You can, as with meshes, separate the selected bones ina 
new armature object Armature >» Separate, Ctri-Alt-P and of 
course, in Object Mode, you can join all selected armatures 
in one Object > Join Objects, Ctri-J. 


Subdivide 


Reference 
Mode: Edit Mode 
Menu: Armature > Subdivide 


You can subdivide bones, to get two or more bones where 
there was just one bone. The tool will subdivide all selected 
bones, preserving the existing relationships: the bones 
created from a subdivision always form a connected chain of 
bones. 


To create an arbitrary number of bones from each selected 
bone in the Subdivide Multi Adjust Last Operation panel. 


Number of Cuts 
Specifies the number of cuts. As in mesh editing, if you 


set n cuts, you will get n + 1 bones for each selected 
bone. 


Subdivision example. 


An armature with The selected bone 
one selected bone, has been “cut” two 
just before multi- times, giving three 


subdivision. sub-bones. 


Switch Direction 


Reference 

Mode: Edit Mode 

Menu: Armature > Switch Direction 
Shortcut: Alt-F 


This tool allows you to switch the direction of the selected 
bones (i.e. their root will become their tip, and vice versa). 


Switching the direction of a bone will generally break the 
chain(s) it belongs to. However, if you switch a whole (part 
of a) chain, the switched bones will still be 
parented/connected, but in “reversed order”. See the Fig. 
Switching_example.. 


Switching example. 


An armature with The selected bones 
one selected bone, have been switched. 
and one selected Bone.005 is no more 
chain of three connected nor 
bones, just before parented to 
switching. anything. The chain 


of switched bones 
still exists, but 


reversed (now 
Bone.002 is its root, 
and Bone is its tip). 
Bone.003 is now a 
free bone. 


Symmetrize 


Reference 
Mode: Edit Mode 
Menu: Armature >» Symmetrize 


This operator will mirror the selected bones along the X axis 
based on Blender’s bone naming_convention for 
symmetrical armatures, either from left to right or right to 
left, depending on the selection. 


Note 


If the side of the bone cannot be determined, it will be 
ignored. 


Bones with the opposite names that don’t yet exist will be 
created, and already existing ones will be overwritten. If 
matching bones are selected on both sides, mirroring will 
happen from right to left. 


Symmetrized bone and constraint properties will have the 
necessary changes to mirror their behaviors. When 
symmetrizing bones with Action Constraints, the necessary 
keyframes will be added to the target Action to result in 
symmetrical movement when the Action is activated. 


Note 


Note that bone or constraint drivers will not be created or 
affected in any way. 


Naming 


Reference 
Mode: All Modes 
Panel: Properties » Bone Properties 


You can rename your bones, either using the Name field in 
the Bones Properties. It is also possible to rename by 
double-clicking bones in the Outliner. 


Blender also provides you some tools that take advantage of 
bones named in a left/right symmetry fashion, and others 
that automatically name the bones of an armature. 


Naming Conventions 


Naming conventions in Blender are not only useful for you in 
finding the right bone, but also to tell Blender when any two 
of them are counterparts. 


In case your armature can be mirrored in half (i.e. it is 
bilaterally symmetrical), it is worthwhile to stick to a 
left/right naming convention. This will enable you to use 
some tools that will probably save you time and effort (like 
the X-Axis Mirror editing tool). 


\ Neck 
Shoulder_L 


Shoulder_R ‘a r¢ 


t 


An example of left/right bone naming in a simple rig. 


1. First you should give your bones meaningful base- 


” a“ 


names, like “leg”, “arm”, “finger”, “back”, “foot”, etc. 


2. If you have a bone that has a copy on the other side (a 
pair), like an arm, give it one of the following separators: 


o Left/right separators can be either the second 
position “L_calfbone” or last-but-one “calfbone.R”. 

o If there is a lower or upper case “L’, “R”, “left” or 
“right”, Blender handles the counterpart correctly. 
See below for a list of valid separators. Pick one and 
stick to it as close as possible when rigging; it will 
pay Off. 


Examples of valid separators: 


o (nothing): handLeft -> handRight 

“_" (underscore): hand_L -> hand_R 
“.” (dot): hand.| -> hand.r 

“-" (dash): hand-l -> hand-r 

”" (space): hand LEFT -> hand RIGHT 


o Oo 0 O 


Note 


Note that all examples above are also valid with the 
left/right part placed before the name. You can only 
use the short “L’/ “R” code if you use a separator (e.g. 
“handl’/ “handR” will not work!). 


3. Before Blender handles an armature for mirroring or 
flipping, it first removes the number extension, e.g. 
“O01”. 


4. You can copy a bone named “bla.L’ and flip it over using 
Elio Names. Blender will name the copy “bla.L.001” and 
flipping the name will give you “bla.R”. 


Auto-Name 

Reference 

Mode: Edit Mode 

Menu: Armature >» Names >» Auto-Name 


Left/Right, Front/Back, Top/Bottom 


The three AutoName entries of the Armature » Names menu 
allow you to automatically add a suffix to all selected bones, 
based on the position of their root relative to the armature’s 
origin and its local coordinates: 


AutoName Left/Right 
Will add the “.L’ suffix to all bones with a positive X 
coordinate root, and the “.R” suffix to all bones with a 
negative X coordinate root. If the root is exactly at 0.0 on 
the X axis, the X coordinate of the tip is used. If both 
joints are at 0.0 on the X axis, the bone will just get a 


period suffix, with no “L’/ “R” (as Blender cannot decide 
whether it is a left or right bone...). 


AutoName Front/Back 
Will add the “.Bk” suffix to all bones with a positive Y 
coordinate root, and the “.Fr” suffix to all bones with a 
negative Y coordinate root. The same as with AutoName 
Left-Right goes for 0.0 Y coordinate bones... 


AutoName Top/Bottom 
Will add the “.Top” suffix to all bones with a positive Z 
coordinate root, and the “.Bot” suffix to all bones with a 
negative Z coordinate root. The same as with AutoName 
Left-Right goes for 0.0 Z coordinate bones... 


Flip Names 


Reference 
Mode: Edit Mode 
Menu: Armature >» Names » Flip Names 


You can flip left/right markers (see above) in selected bone 
names. This can be useful if you have constructed half of a 
symmetrical rig (marked for a left or right side) and 
duplicated and mirrored it, and want to update the names 
for the new side. Blender will swap text in bone names 
according to the above naming conventions, and remove 
number extensions if possible. 


Change Layers 


Change Armature Layers 


Reference 

Mode: Edit Mode 

Menu: Armature >» Change Armature Layers 
Shortcut: Shift-M 


Each armature has 32 Layers to organize armatures by 
“regrouping” them into sets of bones. Only bones in active 
layers will be visible/editable, but they will always be 
effective (i.e. move objects or deform geometry), whether in 
an active layer or not. This tool changes which layers are 
visible in the 3D Viewport. To show several layers at once, 
Shift-LMB on the desired layers to view. To move bones to a 
given layer, use Change Bone Layers. 


Change Bone Layers 


Reference 

Mode: Edit Mode 

Menu: Armature » Change Bone Layers 
Shortcut: M 


Todo. 


Parenting 


Reference 

Mode: Edit Mode 

Menu: Armature >» Parent 

Panel: Properties >» Bones » Relations 
Shortcut: Ctrl-P, Alt-P 


You can edit the relationships between bones (and hence 
create/modify the chains of bones) both from the 3D 
Viewport and the Properties. Whatever method you prefer, 
it’s always a matter of deciding, for each bone, if it has to 
be parented to another one, and if so, if it should be 
connected to it. 


To parent and/or connect bones, you can: 


In the 3D Viewport, select the bone and then its future 
parent, and press ctri-P (or Armature >» Parent » Make 
Parent...). In the small Make Parent menu that pops up, 
choose Connected if you want the child to be connected to 
its parent, else click on Keep Offset. If you have selected 
more than two bones, they will all be parented to the last 
selected one. If you only select one already-parented bone, 
or all selected bones are already parented to the last 
selected one, your only choice is to connect them, if not 
already done. If you select only one non-parented bone, you 
will get the Need selected bone(s) error message... 


Note 


With this method, the newly-children bones will not be 
scaled nor rotated - they will just be moved if you choose 
to connect them to their parent’s tip. 


In the Properties, Bones tab, for each selected bone, you 
can select its parent in the Parent data ID to the upper right 
corner of its Relations panel. If you want them to be 
connected, just enable the checkbox to the right of the list. 


Note 


With this method, the tip of the child bone will never be 
moved - so if Connected is enabled, the child bone will be 
completely transformed by the operation. 


Parenting example. 


Bone.005 re- 
. parented to 
The starting Bone.002, but not 


armature, with 
Bone.005 parented 
and connected to 
Bone.004. 


connected to it 
(same result, using 
either ctrl-P 2 in 3D 
Viewport, or the 
Bones tab settings). 


Bone.005 parented Bone.005 parented 


and connected to and connected to 
Bone.002, using Bone.002. 

Ctri-P 1in 3D 

Viewport. Using the Parent 


data ID of Bone.005 
Relations panel. 


To disconnect and/or free bones, you can: 


e Ina 3D Viewport, select the desired bones, and press 
Alt-P (or Armature » Parent > Clear Parent...). In the 
small Clear Parent menu that pops up, choose Clear 
Parent to completely free all selected bones, or 
Disconnect Bone if you just want to break their 
connections. 

In the Properties, Bones tab, for each selected bone, you 
can select no parent in the Parent data ID of its 
Relations panel, to free it completely. If you just want to 
disconnect it from its parent, disable the Connected 
checkbox. 


Note that relationships with non-selected children are never 
modified. 


Properties 


Reference 

Mode: Edit Mode 

Menu: Armature » Bone Settings > ... 
Shortcut: Shift-W, Shift-Ctrl-w, ALt-W 


Most bones’ properties (except the transform ones) are 
regrouped in each bone’s panels, in the Bones tab in Edit 
Mode. Let us detail them. 


Note that some of them are also available in the 3D 
Viewport, through the three pop-up menus within the same 
entry: 


e Toggle Setting: Shift-w or Armature » Bone Settings > 
Toggle a Setting 

e Enable Setting: Shift-ctrl-w or Armature > Bone Settings 
>» Enable a Setting 

e Disable Setting: Alt-w or Armature > Bone Settings > 
Disable a Setting 


Display Wire 
Always display the bone as wireframe. 


Deform 
(also Shift-w > (Deform, ...)). 


Multiply Vertex Group by Envelope 
(also Shift-w > (Multiply Vertex Group by Envelope, ...)). 


These settings control how the bone influences its 
geometry, along with the bones’ joints radius. This will be 


detailed in the skinning_part. 


Inherit Rotation 


The bone automatically rotates together with its parent 
in Pose Mode. For more details, see the relations page. 


Lock 
(also Shift-w > (Locked, ...)) This will prevent all editing of 
the bone in Edit Mode; see bone locking. 


Delete 


Bones 

Reference 

Mode: Edit Mode 

Menu: Armature > Delete > Bones 
Shortcut: X 


This tool delete selected bones, selected joints are ignored. 


If you delete a bone in a chain, its child(ren) will be 
automatically re-parented to its own parent, but not 
connected, to avoid deforming the whole armature. 


Deletion example. 


An armature with The two bones have 

two selected bones, been deleted. Note 

just before deletion. that Bone.002, 
previously 


connected to the 
deleted Bone.0OO1, is 
now parented but 


not connected to 
Bone. 


Dissolve 


Reference 

Mode: Edit Mode 

Menu: Armature > Delete > Dissolve 
Shortcut: Ctrl-X 


Todo 2.76. 


Properties 
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Transform 
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Technical Details 
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Deform 
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ie) 


(e) 


ie) 


1) 


Introduction 


Reference 
Mode: Object Mode, Edit Mode and Pose Mode 
Panel: Properties >» Bone 


When bones are selected (hence in Edit Mode and Pose 
Mode), their properties are shown in the Bone tab of the 
Properties. This shows different panels used to control 
features of each selected bone; the panels change 
depending on which mode you are working in. 


Transform 


Reference 
Mode: Edit Mode and Pose Mode 
Panel: Bone >» Transform 


When in Edit Mode you can use this panel to control position 
and roll of individual bones. Whereas in Pose Mode you can 
only set location for the main bone, and you can now set 
rotation and scale. 


In addition, in Pose Mode it is possible to restrict changes in 
position, rotation and scale by axis on each bone in the 
armature. 


Head X, Y, Z 
Location of head end of the bone. 


Tail X, Y, Z 
Location of tail end of the bone. 


Roll 
Bone rotation around head-tail axis. 


Lock 
Bone is not able to be transformed when in Edit Mode. 


Bendy Bones 


Reference 
Mode: All Modes 
Panel: Bone » Bendy Bones 


Bendy Bones (B-Bones) are an easy way to replace long 
chains of many small rigid bones. A common use case for 
curved bones is to model spine columns or facial bones. 


Technical Details 


Blender treats the bone as a section of a Bézier curve 
passing through the bones’ joints. Each of the Segments will 
bend and roll to follow this invisible curve representing a 
tessellated point of the Bézier curve. The control points at 
each end of the curve are the endpoints of the bone. The 
Shape of the B-Bones can be controlled using a series of 
properties or indirectly through the neighboring bones (i.e. 
first child and parent). The properties construct handles on 
either end of the bone to control the curvature. 


When using the B-bone as a constraint target Data ID offers 
an option to follow the curvature. 


Note 


However, if the bone is used as a target rather than to 

deform geometry, only Armature and Copy Transforms 

constraints will use the full transformation including roll 
and scale. 


Display 


You can see these segments only if bones are visualized as 
B-bones. 


When not visualized as B-Bones, bones are always shown as 
rigid sticks, even though the bone segments are still present 
and effective. This means that even in e.g. Octahedron 
visualization, if some bones in a chain have several 
segments, they will nonetheless smoothly deform their 
geometry. 


Rest Pose 


The initial shape of a B-Bone can be defined in Edit Mode as 
a rest pose of that bone. This is useful for curved facial 
features like curved eyebrows or mouths. 


B-Bones have two sets of the Bendy Bone properties - one 
for Edit Mode (i.e. the Rest Pose/Base Rig) and another for 
Pose Mode - adding or multiplying together their values to 
get the final transforms. 


Example 


Bones with just one The Bézier curve 

segment in Edit Superposed to the 

Mode. chain, with its 
handles placed at 
bones’ joints. 


The same armature 
in Object Mode. 


In Fig. Bones with just one segment in Edit Mode. we 
connected three bones, each one made of five segments. 


Look at Fig. The same armature in Object Mode., we can see 
how the bones’ segments smoothly “blend” into each other, 
even for roll. 


Bone.005 
Bane.004 


Bone.003 


Bone.001 


An armature in Pose Mode, B-Bone visualization: 
Bone.003 has one segment, Bone.004 has four, and 
Bone.005 has sixteen. 


Options 


Seg ments ¥ Bendy Bones 
The number of Segments 2 
segments, which the Display Size X 0.10000 
given bone is subdivided Zz 0.10000 
into. Segments are small, Curve In X 0.00000 
rigid linked child bones 2 i 
that interpolate between AAS BEY siesicaaat 
the root and the tip. The ae —— 
higher this setting, the ap = 
smoother “bends” the Inherit End Roll 
bone, but the heavier the Scale In X 1.000 
pose calculations. Y 1.000 

ys 1.000 

Display Size Xx, Z Scale Out X 1.000 
Controls the visible | _ 
thickness of the bone ras 
segments when the 41606 
armature is rendered in Scale Easing 
the B-Bones mode. Start Handle Automatic 

Curve In/Out X, Y, Z Scale =X Y 
Applies offsets to the eee “tomatic 


curve handle positions 
on the plane 
perpendicular to the 
bone’s primary (Y) axis. 
As a result, the handle 
moves per axis (XZ) 


Bendy Bones panel. 


further from its original location, causing the curve to 
bend. 


Roll In, Out 
The roll value (or twisting around the main Y axis of the 
bone) is interpolated per segment, between the start and 
end roll values. It is applied as a rotational offset on top 
of the rotation defined by the handle bones. 


Inherit End Roll 
If enabled, the Rol! Out value of the Start Handle bone 
(connected parent by default) will be implicitly added to 
the Roll In setting of the current bone. 


Scale In/Out X, Y, Z 


Scaling factors that adjust the thickness of each segment 
for the X and Z axes, or introduce non-uniform spacing 
along the Y axis. Similar to Ro// it is interpolated per 
segment. 


Since all segments are still uniformly scaled in the Y 
direction to fit the actual length of the curve, only the 
ratio between Scale In Y and Scale Out Y actually 
matters. 


Ease In, Out 
The Ease In/Out number fields, change the “length” of 
the “auto” Bézier handle to control the “root handle” and 
“tip handle” of the bone, respectively. These values are 
proportional to the default length, which of course 
automatically varies depending on bone length, angle 
with the reference handle, and so on. 


Although easing is a scale-like value, the Edit Mode and 
Pose Mode versions of the values are added, so they get 
corresponding start values of 1 and O by default. 


Ease In/Out settings example, with a materialized Bézier 
curve. 


Bone.004 with 


default In and Out Bone.004 with In at 


(1.0). 2.0, and Out at 0.0. 


Scale Easing 


If enabled, the final easing values are implicitly multiplied 
by the corresponding Scale Y values. 


Custom Handles 


B-Bones can use custom bones as their reference bone 
handles, instead of only using the connected parent/child 
bones. 


Start/End Handle 


Specifies the type of the handle from the following 
choices: 


Automatic: The connected parent (or first 
connected child) of the bone is chosen 
as the handle. Calculations are done 
according to the Absolute handle type 
below. 


Absolute: The Bézier handle is controlled by the 
position of the head (tail) of the 
handle bone relative to the head (tail) 
of the current bone. Note that for this 
to work, there must be a nonzero 
distance between these bones. If the 
handle is also a B-Bone, additional 
processing is applied to further smooth 
the transition, assuming that the bones 
in effect form a chain. 

Relative: The Bézier handle is controlled by the 
offset of the head (tail) of the handle 
bone from its rest pose. The use of this 
type is not recommended due to 
numerical stability issues near zero 
offset. 

Tangent: The Bézier handle is controlled by the 
orientation of the handle bone, 
independent of its location. 


Custom Handle 
For types other than Automatic, a bone to use as handle 
has to be manually selected. Switching to a custom 
handle type without selecting a bone can be used to 
effectively disable the handle. 


It is valid for two bones to refer to each other as handles 
- this correlation is applied in connected chains with 
Automatic handles. 


Scale X/Y/Z/Ease 
If enabled, the final Scale and/or Ease values are 
multiplied by the corresponding local scale channels of 
the handle bone. This step is applied independently of 
Scale Easing and doesn’t interact with it, i.e. enabling Y 
and Scale Easing doesn’t replace the Ease toggle. These 


toggles are a more efficient replacement for up to eight 
trivial drivers passing segment scale data from the 
handle bones into the B-Bone option properties. 

Tip 

Keying Set 


The “BBone Shape” Keying Set includes all Bendy Bones 
properties. 


Curve X/Y Out 


Scale Out 


Roll Out 
Curve X/Y In 


Scale In 


Roll In 


Visualization of the Bendy Bones properties. 


From Left: 1) Curve X/Y offsets, 2) Scale In/Out, 3) 
Roll In/Out 


Relations 


Reference 
Mode: All Modes 
Panel: Bone > Relations 


Y Relations 


Parent 


Relative Parenting 


Bone Group * 


¥ Inherit Rotation 


Inherit Scale —- Full 


Relations panel. 


In this panel you can arrange sets of bones in different layers 
for easier manipulation. 


Bone Layers 


Moving Bones between Layers 


Obviously, you have to be in Edit Mode or Pose Mode to move 
bones between layers. Note that as with objects, bones can lay 
in several layers at once, just use the usual Shift-LmB Clicks... 
First of all, you have to select the chosen bone(s)! 


e In the Properties, use the “layer buttons” of each selected 
bone Relations panel (Bones tab) to control in which 


layer(s) it lays. 

e In the 3D Viewport, use the menu Armature >» Move Bone 
To Layer or Pose >» Move Bone To Layer or press M to show 
the usual pop-up layers menu. Note that this way, you 
assign the same layers to all selected bones. 


Parenting 


Parent 
A Data ID to select the bone to set as a parent. 


Relative Parenting Pose Mode Only 
Changes how transformation of the bone is applied to its 
child Objects. 


Bone Group Pose Mode Only 
To assign a selected bone to a given bone group use the 
Bone Group data ID. 


Connected 
The Connected checkbox set the head of the bone to be 


connected with its parent root. 


Transformations 


Bones relationships have effects on transformations behavior. 
By default, children bones inherit: 


e Their parent position, with their own offset of course. 

e Their parent rotation (i.e. they keep a constant rotation 
relatively to their parent). 

e Their parent scale, here again with their own offset. 


Examples of transforming parented/connected bones. 


The Rotation of Scaling of a 


armature in a root root bone. 
its rest bone. 
position. 


Exactly like standard children objects. You can modify this 
behavior on a per-bone basis, using the Relations panel in the 
Bones tab: 


Local Location 
When disabled, the location transform property is evaluated 
in the parent bone’s local space, rather than using the 
bone’s own rest pose local space orientation. 


Inherit Rotation 
When disabled, this will “break” the rotation relationship to 
the bone’s parent. This means that the child will keep its 
rotation in the armature object space when its parent is 
rotated. 


Inherit Scale 
Specifies which effects of parent scaling the bone inherits: 


Full: The bone inherits all effects of parent 
scaling and shear. 


Fix Shear: Full parent effects are applied to the rest 
state of the child, after which any shear is 
removed in a way that preserves the bone 
direction, length and volume, and 
minimally affects roll on average. The 
result is combined with the local 
transformation of the child. 


If the inherited scale is non-uniform, this 
does not prevent shear from reappearing 
due to local rotation of the child bone, or 
of its children. 


Aligned: Parent scaling is inherited as if the child 
was oriented the same as the parent, 
always applying parent X scale over child 
X scale, and so on. 


Average: Inherits a uniform scaling factor that is the 
total change in the volume of the parent. 


None: Ignores all scaling and shear of the parent. 


None (Legacy): 
Ignores all scaling, provided the parent is 
not sheared. If it is, there are no 
guarantees. 
This choice replicates the behavior of the 
old Inherit Scale checkbox, and may be 
removed in a future release. 


These inheriting behaviors propagate along the bones’ 
hierarchy. So when you scale down a bone, all its descendants 
are by default scaled down accordingly. However, if you disable 
one bone’s Inherit Scale or Inherit Rotation property in this 
“family”, this will break the scaling propagation, i.e. this bone 
and all its descendants will no longer be affected when you 
scale one of its ancestors. 


Tip 


The various Inherit Scale options are provided as tools in 
avoiding shear that is caused by non-uniform scaling 
combined with parenting and rotation. There is no obvious 
best way to achieve that, so different options are useful for 
different situations. 


None 


Useful for gaining full control over the scaling of the child 
in order to e.g. manually overwrite it with constraints. 


Average 
Useful to block squash and stretch propagation between 
sub-rigs, while allowing uniform changes in the size and 
volume to pass through. 


Aligned 
Can be used within bone chains, e.g. tentacles, in order to 
propagate lengthwise scaling as lengthwise, and sideways 
as sideways, no matter how the tentacle bends. Similar to 
using None with Copy Scale from parent. 


Fix Shear 
May be useful at the base of an appendage in order to 
reallocate squash and stretch between axes based on the 
difference in rest pose orientations of the parent and child. 
It behaves closest to Ful// while suppressing shear. 


Examples of transforming parented/connected bones with 
Inherit Rotation disabled. 


The 

yellow Rotation of a Scaling of a 
outlined bone with an bone with an 
Inherit Inherit Inherit 
Rotation Rotation Rotation 
disabled disabled disabled 
bone in bone among bone among 
the its its 


armature. 


descendants. 


descendants. 


Connected bones have another specificity: they cannot be 
moved. Indeed, as their root must be at their parent’s tip, if 
you do not move the parent, you cannot move the child’s root, 
but only its tip, which leads to a child rotation. This is exactly 
what happens, when you press G with a connected bone 
selected, Blender automatically switches to rotation operation. 


Bones relationships also have important consequences on how 
selections of multiple bones behave when transformed. There 
are many different situations which may not be included on 
this list, however, this should give a good idea of the problem: 


e Non-related selected bones are transformed 
independently, as usual. 


e When several bones of the same “family” are selected, 
only the “most parent” ones are really transformed - the 
descendants are just handled through the parent 
relationship process, as if they were not selected (see Fig. 
Scaling_ bones, some of them related. the third tip bone, 
outlined in yellow, was only scaled down through the 
parent relationship, exactly as the unselected ones, even 
though it is selected and active. Otherwise, it should have 
been twice smaller!) 


Scaling bones, some of them related. 


e When connected and unconnected bones are selected, and 
you start a move operation, only the unconnected bones 


are affected. 


e When a child connected hinge bone is in the selection, and 
the “most parent” selected one is connected, when you 
press G, nothing happens, because Blender remains in 
move operation, which of course has no effect on a 
connected bone. 


So, when posing a chain of bones, you should always edit its 
elements from the root bone to the tip bone. This process is 
known as Forward Kinematics (FK). We will see in a later page 
that Blender features another pose method, called !nverse 
Kinematics (IK), which allows you to pose a whole chain just by 
moving its tip. 


Note 


This feature is somewhat extended/completed by the pose 
library tool. 


Inverse Kinematics 


Reference 
Mode: Pose Mode 
Panel: Bone >» Inverse Kinematics 


Y Inverse Kinematics 


IK Stretch 


Lock IK X 


Stiffness X 


Limit X 


Limit Y 


Limit Z 


Control Rotation 


IK Rotation Weight 0.000 


The Inverse Kinematics panel. 


This panel controls the way a bone or set of bones behave 
when linked in an inverse kinematic chain. 


Deform 


Reference 
Mode: All Modes 
Panel: Bone >» Deform 


¥ ¥ Deform 


Envelope Distance 0.25m 
Envelope Weight 1.000 


Envelope Multiply 


Radius Head 0.1m 
Tail 0.1m 


The Deform panel. 
In this panel you can set deformation options for each bone. 


Toggling the checkbox in the panel header off, prevents the 
bone from deforming the geometry at all, overriding any 
weights that it might have been assigned before; it mutes 
its influence. 


It also excludes the active bone in the automatic weight 
calculation when the mesh is parented to the armature 
using the Armature Deform tool with the With Automatic 
Weights option. 


Envelope 


Envelopes is the most general skinning method. It works 
with all available object types for skinning (meshes, lattices, 


curves, surfaces and texts). It is based 
on proximity between bones and their —Tipradius 
geometry, each bone having two 

different areas of influence, shown in 
the Envelope visualization: Influence area 


e The inside area, materialized by the 
“solid” part of the bone, and 
controlled by both root and tip 


radius. 
e The outside area, materialized by 
the lighter part around the bone, Bone influence 
and controlled by the Distance areas for 
setting. envelopes 
method. 
See also 


The editing_pages for how to edit these properties. 


Envelope Distance 
The Distance defines a volume which is the range within 
the bone has an influence on vertices of the deformed 
object. The geometry is less and less affected by the 
bone as it goes away by following a quadratic decay. 


Single bone with various envelope sizes. 


Envelope Weight 


A bone property, that controls the global influence of the 
bone over the deformed object, when using the 
envelopes method. 


It is only useful for the parts of geometry that are 
“shared”, influenced by more than one bone (generally, 
at the joints...) - a bone with a high weight will have 
more influence on the result than one with a low weight... 
Note that when set to 0.0, it has the same effect as 
disabling the Deform option. 


Envelope Multiply 


This option controls how the two deforming methods 
interact, when they are both enabled. By default, when 
they are both active, all vertices belonging to at least 
one vertex group are only deformed through the vertex 
groups method. The other “orphan” vertices being 
handled by the envelopes one. When you enable this 
option, the “deformation influence” that this bone would 
have on a vertex (based from its envelope settings) is 
multiplied with this vertex’s weight in the corresponding 


vertex group. In other words, the vertex groups method 
is further “weighted” by the envelopes method. 


Radius Head, Tail 


Set the radius for the head and the tail of envelope 


bones. Inside this volume, the geometry if fully affected 
by the bone. 


Three Armature Bones all using Envelope Weight. 


The 1st with a default radius value, the two 
others with differing Tail and Head radius values. 


Viewport Display 


Reference 
Mode: Object and Pose Mode 
Panel: Bone » Viewport Display 


¥ Viewport Display 


¥ Custom Shape 


Custom Object 


Viewport Display panel. 


Display panel lets you customize the look of your bones 
taking the shape of another existing object. 


Hide 
Hides the selected bone. 


Custom Shape 


Blender allows you to give to each bone of an armature a 
specific shape (in Object Mode and Pose Mode), using 
another object as “template”. In order to be visible the 
Shapes checkbox has to be enabled (Armature » Viewport 
Display panel). 


Custom Object 
Object that defines the custom shape of the selected 
bone. 


Scale X, Y, Z 
Additional scaling factor to apply to the custom shape. 


Translation X, Y, Z 
Additional translation factor to apply to the custom 
Shape. 


Rotation X, Y, Z 
Additional rotation factor to apply to the custom shape. 


Override Transform 
Bone that defines the display transform of the custom 
shape. 


Scale to Bone Length 
Option not to use bones length, so that changes in Edit 
Mode don’t resize the custom shape. 


Wireframe 
When enabled, bone is displayed in wireframe mode 
regardless of the viewport display mode. Useful for non- 
obstructive custom bone chains. 


Workflow 


To assign a custom shape to a bone, you have to: 


1. Switch to Pose Mode Ctrl-Tab. 

2. Select the relevant bone by clicking on it. 

3. Go to the Display panel Custom Shape field and select 
the 3D object previously created in the scene; in this 


example we are using a cube and a cone. You can 
optionally set the At field to another bone. 


The armature with shape assigned to bone. Note the 
Origin of the Cone object. 


Note 


These shapes will never be rendered, like any bone, 
they are only visible in the 3D Viewport. 

Even if any type of object seems to be accepted by the 
Object field (meshes, curves, even metas...), only 
meshes really work. All other types just make the bone 
invisible. 

The origin of the shape object will be at the root of the 
bone (see the bone page for root/tip). 

The object properties of the shape are ignored (i.e. if 
you make a parallelepiped out of a cube by modifying 
its dimensions in Object Mode, you will still have a 
cube-shaped bone...). 

The “along bone” axis is the Y one, and the shape 
object is always scaled so that one unit stretches along 


the whole bone length. 

e If you need to remove the custom shape of the bone, 
just right-click in the Custom Shape field and select 
Reset to default value in the pop-up menu. 


So to summarize all this, you should use meshes as shape 
objects, with their center at their lower -Y end, and an 
overall Y length of 1.0 unit. 


Custom Properties 


Reference 
Mode: Pose Mode 
Panel: Bone >» Custom Properties 


See the Custom Properties page for more information. 


Properties 


Introduction 
o Motion Paths 
o Inverse Kinematics 
o Custom Properties 
¢ Skeleton 
e Viewport Display 
Bone Groups 
o Color Set 
o Assign and Select 


e Pose Library 


Introduction 


The Armature tab in Properties contains various panels 
gathering the armature settings. 


Motion Paths 


Reference 
Mode: All Modes 
Panel: Armature > Motion Paths 


In the Motion Paths panel you can enable visualization of the 
motion path your skeleton leaves when animated. 


Inverse Kinematics 


Reference 
Mode: All Modes 
Panel: Armature > Inverse Kinematics 


Defines the type of IK solver used in your animation. 
Custom Properties 


Reference 


Mode: All Modes 
Panel: Armature » Custom Properties 


See the Custom Properties page for more information. 


Skeleton 


Reference 
Mode: All Modes 
Panel: Armature > Skeleton 


¥ Skeleton 


Pose Position Rest Position 


Protected Layers 


Skeleton panel. 


In this panel you can arrange sets of bones into different 
layers for easier manipulation. 


Pose Position 


A radio button to switch between Pose Position and Rest 
Position. 


In Edit Mode, you always see armatures in their rest 
position, in Object Mode and Pose Mode, by default, you 
see them in Pose Position (i.e. as it was transformed in 
the Pose Mode). If you want to see it in the rest position 
in all modes, select Rest Position. 


Armature Layers 
Each armature has 32 layers to organize armatures by 
“regrouping” them into sets of bones. Only bones in 


active layers will be visible/editable, but they will always 
be effective (i.e. move objects or deform geometry), 
whether in an active layer or not. This property changes 
which layers are visible in the 3D Viewport. To show 
several layers at once, Shift-LMB on the desired layers to 
view. To move bones to a given layer, use Change Bone 


Layers. 


Protected Layers 
You can lock a given bone layer for all Proxies of your 
armature, i.e. all bones in this layer will not be editable. 


Note 
Protected Layers in proxy are restored to proxy settings 


on file reload and undo. 


Viewport Display 


Reference 

Mode: All Modes 

Panel: Armature >» Viewport Display 
Display As 


This controls the way the bones appear in the 3D 
Viewport. 


Octahedral bone Stick bone display. 


display. 

B-Bone bone Envelope bone 

display. display. 
Octahedral 


This is the default visualization, well suited for most of 
editing tasks. It materializes: 


e The bone root (“big” joint) and tip (“small” joint). 


e The bone “size” (its thickness is proportional to its 
length). 
e The bone roll (as it has a square section). 


Note the 40° rolled Bone.001 bone. 


Stick 


This is the simplest and most non-intrusive 
visualization. It just materializes bones by sticks of 
constant (and small) thickness, so it gives you no 
information about root and tip, nor bone size or roll 
angle. 


Note that Bone.001 roll angle is not visible 
(except by its XZ axes). 


B-Bone 


This visualization shows the curves of “smooth” multi- 
segmented bones; see the Bendy Bones for details. 


An armature of B- The same 


Bones, in Edit armature in 
Mode. Object Mode. 
Envelope 


This visualization materializes the bone deformation 
influence. More on this in the bone page. 


Wire 
This simplest visualization shows the curves of 
“smooth” multi-segmented bones. 


An armature of The same 
Wire, in Pose armature in Edit 
Mode. Mode. 


Show 
Names 


Displays the name of each bone. 


Shapes 
When enabled, the default standard bone shape is 
replaced, in Object Mode and Pose Mode, by the 
shape of a chosen object (see Shaped Bones for 
details). 


Group Colors 
Use the Bone Group colors to color the bone. For more 
details see Bone Groups. 


In Front 
When enabled, the bones of the armature will always 
be shown on top of the solid objects (meshes, 
surfaces, ...). l.e. they will always be visible and 
selectable (this is the same option as the one found in 
the Display panel of the Object data tab). Very useful 
when not in Wireframe mode. 


Axis 
When enabled, the (local) axes of each bone are 
displayed (only relevant for Edit Mode and Pose Mode). 


Position 
The position for the axes display on the bone. 
Increasing the value moves it closer to the tip; 
decreasing moves it closer to the root. 


Bone Groups 


Reference 

Mode: Pose Mode 

Panel: Properties » Armature » Bone Groups 
Menu: Pose >» Bone Groups > ... 


This panel allows the creation, deletion and editing of Bone 
Groups. Bone Groups can be used for selection or to assign 
a color theme to a set of bones. In example to color the left 
parts of the rig as blue and right parts as red. 


Active Bone Group 
The Bone Group List view. 


Color Set 


You can assign a “color theme” to a group (each bone will 
have these colors). Remember you have to enable the 
Colors checkbox (Display panel) to see these colors. 


Color Set 
A select menu. 


Default Colors: The default (gray) colors. 

nn - Theme Color Set: 
One of the twenty Blender presets by 
the theme. 

Custom Set: A custom set of colors, which is specific 
to each group. 


Regular 


The first color field is the color of unselected bones. 


Select 
The second color field is the outline color of selected 
bones. 


Active 
The third color field is the outline color of the active 
bone. 


As soon as you alter one of the colors, it is switched to the 
Custom Set option. 


Assign and Select 


In the 3D Viewport, using the Pose >» Bone Groups menu 
entries, and/or the Bone Groups pop-up menu Ctrl-G, you 
can: 


Assign 
Assigns the selected bones to the active bone group. It is 
important to note that a bone can only belong to one 


group. 


Remove 
Removes the selected bones from the active bone group. 


Select 
Selects the bones in the active bone group. 


Deselect 
Deselects the bones in the active bone group. 


Note 


A single bone can be assigned to a group in the Relations 
panel. 


Tip 


Bones belonging to multiple groups is possible with the 
Selection Sets add-on. 


Pose Library 


Reference 

Mode: All Modes 

Panel: Properties » Object Data Properties > 
Pose Library 

Warning 


This properties panel is obsolete and will be removed in 
Blender 3.1. 


The Asset Browser based pose library was introduced in 
Blender 3.0 and replaces this pose library panel. To convert 
poses to the new pose library, see Converting Old Pose 
Libraries. 


Pose Library 


The pose library is a way to 


store pose positions so the "9, PLB-Spring facials.col. ai 
same position can be used 02.055 A#7 a 
again later in the animation or 8 - 
to store different rest poses. petal - 
Pose libraries are saved to oe ie a 
Actions. They are not generally cA wD a 
used as actions, but can be 02.055 A#13 v 


converted to and from. The 
Pose Library panel is used to 


save, apply, and manage The Pose Library panel. 
armature poses. 


See also 


Pose Library Editing. 


Action 
A Data-Block Menu for Actions or pose libraries. 


Pose Libraries 
A List view of poses for the active pose library. 


Add + 
If a pose is added, a pose marker is created. The 
Whole Character keying set is used to determine 
which bones to key. If any bones are selected, only 
keyframes for those bones are added, otherwise all 
bones in the keying set are keyed. Bones that are 
ignored by the Whole Character keying set are always 
ignored, regardless of their selection state. 


Add New 
Adds a new pose to the active pose library with the 
current pose of the armature. 


Add New (Current Frame). 
Will add a pose to the pose library based on the 
current frame selected in the Timeline. In contrast 
to Add New and Replace Existing which 
automatically allocate a pose to an action frame. 


Replace Existing 
Replace an existing pose in the active pose library 
with the current pose of the armature. 


Apply Pose (magnifying glass icon) 
Applies the active pose to the selected pose bones. 


Sanitize Action (book icon) 


Makes an action suitable for use as a pose library. This 
is used to convert an Action to a pose library. A pose is 
added to the pose library for each frame with 
keyframes. 


Move (up/down arrow icon) 
Moves the pose up/down in the list. 


Convert Old-Style Pose Library 
Converts the pose library to pose assets. For more 
information, see Converting Old Pose Libraries. 


Structure 


Armatures mimic real 
Skeletons. They are 
made out of bones, 
which are (by default) 
rigid elements. But you 
have more possibilities 
than with real 
Skeletons: In addition to 
the “natural” rotation of 
bones, you can also 
move and even scale 
them! And your bones 
do not have to be 
connected to each 
other; they can be 
completely free if you 
want. However, the 
most natural and useful setups imply that some bones are 
related to others, forming so-called “chains of bones”, which 
create some sort of “limbs” in your armature, as detailed in 
Chains of Bones. 


Example of a very basic armature. 


Chains of Bones 


The bones inside an armature can be completely 
independent from each other (i.e. the modification of one 
bone does not affect the others). But this is not often a 
useful set up: To create a leg, all bones “after” the thigh 
bone should move “with” it in a well-coordinated manner. 
This is exactly what happens in armatures by parenting a 


bone to the next one in the limb, you create a “chains of 
bones”. These chains can be ramified. For example, five 
fingers attached to a single “hand” bone. 


Bone.005 
Bone.0O4 


MBone.003 


Bone.001 Bone.002 


An armature with two chains of bones. 


Bones are chained by linking the tip of the parent to the root 
of the child. Root and tip can be connected, i.e. they are 
always exactly at the same point; or they can be free, like in 
a standard parent-child object relationship. 


A given bone can be the parent of several children, and 
hence be part of several chains at the same time. 


The bone at the beginning of a chain is called its root bone, 
and the last bone of a chain is the tip bone (do not confuse 
them with similar names of bones’ joints!). 


Chains of bones are a particularly important topic in posing 
(especially with the standard forward kinematics versus 
“automatic” inverse kinematics posing techniques). You 
create/edit them in Edit Mode, but except in case of 


connected bones, their relationships have no effect on bone 
transformations in this mode (i.e. transforming a parent 
bone will not affect its children). 


The easiest way to manage bones relationships is to use the 
Relations panel in the Bone tab. 


Skinning 


e Introduction 

e Armature Deform Parent 
o With Empty Groups 
o With Automatic Weights 
o With Envelope Weights 


Introduction 


We have seen in previous pages how to design an armature, 
create chains of bones, etc. Now, having a good rig is not 
the final goal, unless you want to produce a “Dance 
Macabre” animation, you will likely want to put some flesh 
on your skeletons! Surprisingly, “linking” an armature to the 
object(s) it should transform and/or deform is called the 
“skinning” process... 


The human mesh skinned on its armature. 


In Blender, you have two main skinning types: 


1. You can Parent/Constrain Objects to Bones - then, when 
you transform the bones in Pose Mode, their “children” 
objects are also transformed, exactly as with a standard 
parent/children relationship... The “children” are never 
deformed when using this method. 


2. You can Use the Armature Modifier on entire Mesh, and 
then, some parts of this object to some bones inside this 
armature. This is the more complex and powerful 
method, and the only way to really deform the 
geometry of the object, i.e. to modify its vertices/control 
points relative positions. 


Hint 
Retargeting 
Retargeting, which is a way to apply motion-capture data 


(acquired from real world) to a rig, is available through 
add-ons and importers. 


Armature Deform Parent 


Reference 

Mode: Object Mode and Pose Mode 

Menu: Object/Pose >» Parent » Armature Deform 
Shortcut: Ctrl-P 


Armature Deform Parenting is a way of creating and setting 
up an Armature Modifier. 


To use Armature Deform Parenting you must first select all 
the child objects that will be influenced by the armature and 
then lastly, select the armature object itself. Once all the 
child objects and the armature are selected, press Ctrl-P 
and select Armature Deform in the Set Parent To pop-up 
menu. 


The armature will be the parent object of all the other child 
objects and each child object will have an Armature Modifier 
with the armature associated (Object field). 


Bone associated with Mesh Object. 


With Empty Groups 


When parenting it will create empty vertex groups on the 
child objects (if they do not already exist) for and named 
after each deforming bone in the armature. The newly 
created vertex groups will be empty. This means they will 
not have any weights assigned. Vertex groups will only be 
created for bones which are setup as deforming (Properties 
>» Bone >» Deform Panel). 


You can then manually select the vertices and assign them 
to a particular vertex group of your choosing to have bones 
in the armature influence them. 


Choose this option if you have already created (and 
weighted) all the vertex groups the mesh requires. 


Example 


For example, if you have an armature which consists of 
three bones named “BoneA’, “BoneB” and “BoneC” and 
cube mesh called “Cube”. If you parent the cube to the 
armature, the cube will get three new vertex groups created 
on it called “BoneA’, “BoneB” and “BoneC”. Notice that each 
vertex group is empty. 


Cube in Edit Mode using Armature Deform with 
empty groups. 


With Automatic Weights 


With Automatic Weights parenting works similar to With 
Empty Groups, but it will not leave the vertex groups empty. 
It calculates how much influence a particular bone would 
have on vertices based on the distance from those vertices 
to a particular bone (“bone heat” algorithm). This influence 
will be assigned as weights in the vertex groups. 


This method of parenting is certainly easier to setup, but it 
can often lead to armatures which do not deform child 
objects in ways you would want. Overlaps can occur when it 
comes to determining which bones should influence certain 
vertices when calculating influences for more complex 


armatures and child objects. Symptoms of this confusion are 
that when transforming the armature in Pose Mode, parts of 
the child objects do not deform as you expect; If Blender 
does not give you the results you require, you will have to 
manually alter the weights of vertices in relation to the 
vertex groups they belong to and have influence in. 


With Envelope Weights 


Works in a similar way to With Automatic Weights. The 
difference is that the influences are calculated based on the 
Bone Envelopes settings. It will assign a weight to each 
vertex group the vertices that is inside its bone’s influence 
volume, depending on their distance to this bone. 


This means newly included/excluded vertices or new 
envelope settings will not be taken into account. You will 
have to apply Armature Deform With Envelope Weights 
parenting again. 


Tip 


If you want the envelope setting to be used instantly, bind 
the Armature Modifier to Bone Envelopes. 


Two sets of armatures, each with three bones. 
Warning 
If you had defined vertex groups using same names as 
Skinned bones, their content will be completely overridden 
by both Automatic and Envelope Weights. In this case With 
Empty Groups could be used instead. 


See also 


Vertex Groups for Bones. 


Posing 
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Introduction 


Once an armature is skinned by the needed object(s), you 
need a way to configure the armature into positions known 
as poses. Basically, by transforming the bones, you deform 
or transform the skinned object(s). However, you will notice 
that you cannot do this in Edit Mode - remember that Edit 
Mode is used to edit the default, base, or “rest” position of 
an armature. You may also notice that you cannot use 
Object Mode either, as here you can only transform whole 
objects. 


So, armatures have a third mode dedicated to the process 
of posing known as Pose Mode. In rest position (as edited in 
Edit Mode), each bone has its own position/rotation/scale to 
neutral values (i.e. 0.0 for position and rotation, and 1.0 for 
scale). Hence, when you edit a bone in Pose Mode, you 
create an offset in the transform properties, from its rest 
position. This may seem quite similar if you have worked 
with relative shape keys or Delta Transformations. 


Even though it might be used for completely static 
purposes, posing is heavily connected with animation 
features and techniques. So if you are not familiar at all with 
animation in Blender, it might be a good idea to read the 
animation chapter first, and then come back here. 


Visualization 


Bone State Colors 


The color of the bones are based on their state. There are 
six different color codes, ordered here by precedence (i.e. 
the bone will be of the color of the bottom-most valid state): 


e Gray: Default. 

e Blue wire-frame: in Pose Mode. 

e Green: with Constraint. 

e Yellow: with IK Solver constraint. 

e Orange: with Targetless Solver constraint. 


Note 


When Bone Groups colors are enabled, the state colors will 
be overridden. 


Selecting 


Selection in Pose Mode is very similar to the one in Edit 
Mode, with a few deviations: You can only select whole 
bones in Pose Mode, not roots/tips... 


Box Select 


Reference 

Mode: All Modes 

Menu: Select >» Box Select 
Shortcut: B 


Interactive box selection. 


Circle Select 


Reference 

Mode: All Modes 

Menu: Select > Circle Select 
Shortcut: C 


Interactive circle selection. 


Lasso Select 


Reference 


Mode: 
Menu: 


Shortcut: 


All modes 


Select > Lasso Select 
Ctrl-Alt-LMB 


See Select Lasso. 


Select Mirror 


Reference 


Mode: 
Menu: 
Shortcut: 


Edit Mode 


Select > Select Mirror 
Shift-Ctrl-M 


Flip the selection from one side to another. 


Constraint Target 


Reference 


Mode: 
Menu: 


Todo. 
Linked 


Reference 


Mode: 
Menu: 
Shortcut: 


Pose Mode 
Select » Constraint Target 


Pose Mode 


Select > Linked 
Ctrl-L 


Selects all the bones in the chain which the active (last 
selected) bone belongs to. 


All Forks 
Selects all bones connected to the active bone even if 
the branch off from the current bone. 


Linked bones selection. 


A single selected Its whole chain 
bone. selected with Linked. 


Select More/Less 


Reference 

Mode: Pose Mode 

Menu: Select >» Select More/Less 
Parent [, Child ] 


You can deselect the active bone and select its 
immediate parent or one of its children. 


Extend Parent Shift-[, Extend Child Shift-] 
Similar to Parent/Child but it keeps the active bone in the 
selection. 


Grouped 


Reference 

Mode: Pose Mode 
Menu: Select >» Grouped 
Shortcut: Shift-G 


You can select bones based on their group and/or layer, 
through the Select Grouped pop-up menu Shift-G: 


Layer 
To select all bones belonging to the same layer(s) as the 
selected ones, use the Jn Same Layer entry. 


Group 
To select all bones belonging to the same group(s) as the 
selected ones, use the /n Same Group entry. 


Keying Set 
ToDo. 


Select Pattern 


Reference 
Mode: Object Mode 
Menu: Select >» Select Pattern... 


Selects all bones whose name matches a given pattern. 
Supported wild-cards: * matches everything, ? matches any 
single character, [abc] matches characters in “abc”, and 
[!'abc] match any character not in “abc”. As an example 


*house* matches any name that contains “house”, while 
floor* matches any name starting with “floor”. 


Case Sensitive 
The matching can be chosen to be case sensitive or not. 


Extend 
When Extend checkbox is checked the selection is 
extended instead of generating a new one. 


Editing 
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Introduction 


In Pose Mode, bones behave like objects. So the transform 
actions (move, rotate, scale, etc.) are very similar to the 
same ones in Object Mode (all available ones are regrouped 
in the Pose > Transform submenu). However, there are some 
important specificities: 


e Bones’ relationships are crucial (see Bone Parenting). 

e The “transform center” of a given bone (i.e. its default 
pivot point, when it is the only selected one) is its root. 
Note by the way that some pivot point options seem to 
not work properly. In fact, except for the 3D Cursor one, 
all others appear to always use the median point of the 
selection (and not e.g. the active bone’s root when 
Active Object is selected, etc.). 


Basic Posing 


As previously noted, bones’ transformations are performed 
based on the Rest Position of the armature, which is its 
state as defined in Edit Mode. This means that in rest 
position, in Pose Mode, each bone has a scale of 1.0, and 
null rotation and position (as you can see it in the Transform 
panel, in the 3D Viewport’s Sidebar). 
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= Bohe.005 


Bone.001 


| 


An example of a rotation locked to the local Y axis, 
with two bones selected. 


Note that the two green lines materializing the axes 
are centered on the armature’s center, and not each 
bone’s root... 


Moreover, the local space for these actions is the bone’s 
own one (visible when you enable the Axes option of the 
Armature panel). This is especially important when using 
axis locking, for example, there is no specific “bone roll” tool 
in Pose Mode, as you can rotate around the bone’s main 
axis just by locking on the local Y axis R Y Y... This also 
works with several bones selected; each one Is locked to its 
own local axis! 


When you pose your armature, you are supposed to have 
one or more objects skinned on it! And obviously, when you 
transform a bone in Pose Mode, its related objects or 
object’s shape is moved/deformed accordingly, in real-time. 
Unfortunately, if you have a complex rig set-up and/or a 
heavy skin object, this might produce lag during interactive 


editing. If you experience such troubles, try enabling the 
Delay Deform button in the Armature panel the skin objects 
will only be updated once you confirm the transform 
operation. 


Clear Transform 


Reference 
Mode: Pose Mode 
Menu: Pose > Clear Transform 


Once you have transformed some bones, if you want to 
return to their rest position, just clear their transformations. 


All 
Resets location, rotation, and scaling of selected bones to 
their default values. 


Location, Rotation, Scale Alt-G, Alt-R, Alt-S 
Clears individual transforms. 


Note that in Envelope visualization, Alt-S does not clear 
the scale, but rather scales the Distance influence area of 
the selected bones. (This is alSo available through the 
Pose » Scale Envelope Distance menu entry, which is 
only effective in Envelope visualization, even though it is 
always available...) 


Reset Unkeyed 
Clears the transforms to their keyframe state. 


Only Selected 
Operate on just the selected or all bones. 


Apply 


Reference 

Mode: Pose Mode 
Menu: Pose >» Apply 
Shortcut: Ctrl-A 


Pose as Rest Pose 
Conversely, you may define the current pose as the new 
rest pose (i.e. “apply” current transformations to the Edit 
Mode). When you do so, the skinned objects/geometry is 
also reset to its default, undeformed state, which 
generally means you will have to skin it again. 


Pose Selected as Rest Pose 
Same as Pose as Rest Pose but only applies to selected 
bones. 


Visual Transform to Pose 
Applies the position of the bone after Constraints; 
allowing the constraints to be deleted and the bones will 
remain in their constrained positions. 


Assign Custom Property Values as Default 
Assign the current values of custom properties as their 
defaults, for use as part of the rest pose state in NLA 
track mixing. 


In-Betweens 


There are several tools for editing a 
poses in an animation. °° Sg. Breakdowner 


é*  \ Push 


There are also in Pose Mode a 
bunch of armature-specific editing er mains 
options/tools, like auto-bones 
naming, properties 
switching/enabling/disabling, etc., In-Betweens Tools. 
that were already described in the 

armature editing pages. See the 

links above... 


Push Pose from Rest Pose 


Reference 
Mode: Pose Mode 
Menu: Pose > In-Betweens >» Push Pose from 


Rest Pose 


Similar to Push Pose from Breakdown but interpolates the 
pose to the rest position instead. Only one keyframe is 
needed for this tool unlike two for the other. 


Relax Pose to Rest Pose 


Reference 


Mode: Pose Mode 


Menu: Pose > In-Betweens > Relax Pose to Rest 
Pose 


Similar to Relax Pose to Breakdown but works to bring the 
pose back to the rest position instead. Only one keyframe is 
needed for this tool unlike two for the other. 


Push Pose from Breakdown 


Reference 

Mode: Pose Mode 

Tool: Toolbar > In-Betweens Tools >» Push 

Menu: Pose > In-Betweens » Push Pose from 
Breakdown 

Shortcut: Ctrl-E 


Push Pose interpolates the current pose by making it closer 
to the next keyframed position. 


Relax Pose to Breakdown 


Reference 

Mode: Pose Mode 

Tool: Toolbar > In-Betweens Tools > Relax 

Menu: Pose » In-Betweens » Relax Pose to 
Breakdown 

Shortcut: ALt-E 


Relax pose is somewhat related to the above topic, but it is 
only useful with keyframed bones. When you edit such a 
bone (and hence take it “away” from its “keyed position”), 


using this tool will progressively “bring it back” to its “keyed 
position”, with smaller and smaller steps as it comes near it. 


Pose Breakdowner 


Reference 

Mode: Pose Mode 

Tool: Toolbar region » In-Betweens Tools » 
Breakdowner 

Menu: Pose > In-Betweens » Pose Breakdowner 

Shortcut: LMB-drag 


Creates a suitable breakdown pose on the current frame. 


The Breakdowner tool can be constrained to work on 


specific transforms and axes, by pressing the following keys 
while the tool is active: 


G, R, S: move, rotate, scale 

B: Bendy bones 

c: custom properties 

xX, Y, Z: to the corresponding axes 


Blend to Neighbor 


Reference 
Mode: Pose Mode 
Menu: Pose » In-Betweens » Blend to Neighbor 


Shortcut: Shift-Alt-E 


Transitions the current pose with the neighboring keyframes 
in the timeline. In order for this operator to work, there must 
be a keyframe before and after the current frame. 


Propagate 


Reference 

Mode: Pose Mode 
Menu: Pose > Propagate 
Shortcut: Alt-P 


The Propagate tool copies the pose of the selected bones on 
the current frame over to the keyframes delimited by the 
Termination Mode. |It automates the process of copying and 
pasting. 


Termination Mode 


Modes which determine how it decides when to stop 
overwriting keyframes. 


While Held 
The most complicated of the modes available, as it 
tries to guess when to stop propagating by examining 
the pauses in the animation curves per control (i.e. all 
F-Curves for a bone, instead of per F-Curve). 


To Next Keyframe 
Simply copies the pose to the first keyframe after (but 
not including any keyframe on) the current frame. 


To Last Keyframe 
Will simply replace the last keyframe (i.e. making 
action cyclic). 


Before Frame 
To all keyframes between current frame and the End 
frame option. This option is best suited for use from 


scripts due to the difficulties in setting this frame 
value, though it is possible to set this manually via the 
Adjust Last Operation panel if necessary. 


Before Last Keyframe 
To all keyframes from current frame until no more are 
found. 


On Selected Keyframes 
Will apply the pose of the selected bones to all 
selected keyframes. 


On Selected Markers 
To all keyframes occurring on frames with Scene 
Markers after the current frame. 


End Frame 
Defines the upper-bound for the frame range within 
which keyframes will be affected (with the lower bound 
being the current frame). 


Copy/Paste Pose 


Reference 

Mode: Pose Mode 

Menu: Pose >» Copy Pose, Pose » Paste Pose, 
Pose » Paste Pose Flipped 

Shortcut: Ctrl-C, Ctrl-V, Shift-Ctrl-v 


Blender allows you to copy and paste a pose, either through 
the Pose menu, or by using hotkeys. 


Copy Pose 
Copy the current pose of selected bones into the pose 
buffer. 


Paste Pose 
Paste the buffered pose to the currently posed armature. 


Paste Pose Flipped 
Paste the X axis mirrored buffered pose to the currently 
posed armature. 


Here are important points: 


e This tool works at the Blender session level, which 

means you can use it across armatures, scenes, and 

even files. However, the pose buffer is not saved, so you 

lose it when you close Blender. 

There is only one pose buffer. 

Only the selected bones are taken into account during 

copying (i.e. you copy only selected bones’ pose). 

e During pasting, on the other hand, bone selection has 
no importance. The copied pose is applied on a per- 


name basis (i.e. if you had a forearm bone selected when 
you copied the pose, the forearm bone of the current 
posed armature will get its pose when you paste it - and 
if there is no such named bone, nothing will happen...). 
e What is copied and pasted is in fact the position, 

rotation or scale of each bone, in its own space. This 
means that the resulting pasted pose might be very 
different from the originally copied one, depending on: 

o The rest position of the bones. 

o And the current pose of their parents. 


The rest position of The rest position of 
the original the destination 
armature. armature. 


Examples of pose copy/paste. 


The first 
copied 
pose 
(note that 
only two 
bones are 
selected 
and hence 
copied). 


“~N 


The same 
pose as 
above is 
copied, 
but this 
time with 
all bones 
selected. 


The pose 
pasted on 
the 
destination 
armature. 


The pose 
pasted on 
the 
destination 


armature. 


The pose 
mirror- 
pasted on 
the 
destination 
armature. 


The pose 
mirror- 
pasted on 
the 
destination 
armature. 


Pose Library 


This section describes the pose library, which is based on 
the Asset Browser. For an overview of the asset system, see 
the Asset Libraries section. 


Note 


At the moment of writing, the pose library is meant to be 
used in Pose Mode. In other words, it only works when 
posing an armature, and not for general object animation. 


What Is a Pose Asset? 


A pose asset is an action that has been marked as asset, 
and that contains exactly one frame of animation data. 
Usually these are created via the Create Pose Asset button 
(see below), but any action that is keyed on exactly one 
frame can be seen as pose asset. 


Each pose in the library is stored in its own action data- 
block. This means that it can get its own name, its own 
preview image, and can be organized in Asset Catalogs. 


Creating a Pose Library 


A pose library file is typically a blend-file that is dedicated to 
poses. It can link in a character, props, etc., which can then 
not only be used to create the poses, but also for rendering 
previews. 


Example pose library of the Sprite Fright character 
Ellie. 


Pose Creation via Action Editor 


To create a pose in the library from the Action Editor, pose 
the character, select the relevant bones, and click the 
Create Pose Asset button. This will create the new pose 

Action, which will contain keys for the current value of each 
bone’s location, rotation, scale, and Bendy Bone properties. 


To create a new pose asset, use the Create Pose 
Asset button in the Action editor. 


The created Action is now assigned to the armature. 
This makes it possible to inspect which bones are included 
and to tweak anything. In that respect, it’s an Action like 
any other, and you can add or remove keys as uSual. Just 
make sure that the keys are all on the same frame, in order 
to keep this a “pose” instead of an “animation snippet”; the 
latter isn’t supported at the moment. 


True to its name, the Create Pose Asset button automatically 
marks the Action as Asset. Not only does this make it 
available in the pose library, it will also act as a fake user to 
ensure the Action isn’t lost after you unassign it from the 
armature. 


The Create Pose Asset button is also available in the 3D 
Viewport sidebar. This button acts almost the same as the 
one in the Action Editor, except for one thing: it will not 
assign the newly created Action. Doing so would be 
invisible, as the pose doesn’t change and the name of the 
current Action is not shown in the viewport. The pose asset 
can still be renamed in the Asset Browser. There you can 
also click the Assign Action button to explicitly assign the 
selected pose asset as the armature’s active Action. 


Note 


The Create Pose Asset button creates a new Action. To 
make sure that this is actually visible in the user interface, 
so that you know that something happened, it tries to 
make sure that the Asset Browser shows the newly created 
pose asset. Because of this, it requires that there is an 
Asset Browser visible, and that it’s set to show the 
Current File asset library. 


This is especially relevant to pose assets, compared to 
other assets. You cannot mark an object as asset multiple 
times, but you can create ten pose assets from the same 
character pose. 


Pose Creation from Existing Animation 


Animators eat and breathe time, so there is a fair chance 
that you already have some poses lined up on the timeline. 
Creating a pose asset from existing animation is pretty 
much the same as described above, with a few subtle 
differences: 


Go to the frame with the pose you want to turn into an 
asset. 

Select the relevant bones and click the Create Pose 
Asset button in the Action Editor. 

This creates an Action as before, but this time it also 
includes any bone property that was keyed on the 
current frame. In other words: any bone property 
(regular and custom) that’s displayed in yellow in the 
user interface will be included in the pose asset. This 
makes it possible to also include properties that control 
IK/FK switching, for example. As with the pose, the 
current value is copied into the pose asset, and not the 
keyed value. 

Blender saves which action was previously assigned to 
the armature. 

The new pose Action is assigned to the armature so you 
can give it a name and inspect/adjust its contents. 
Click the Restore Previous Action button (back arrow 
icon) that appeared next to the Create Pose Asset 
button. This reassigns the previous Action, so that 
you're back at the animation you had before. 


Pose Creation by Copying from Other File 


As described in Design Limitations, Blender only writes data 
to the currently open blend-file. To copy a pose from some 
other file into a pose library file, see the following steps: 


e Pose the character and select the relevant bones. 

Click the Copy Pose as Asset button, which is 

available in the Action Editor as well as the 3D Viewport 

Sidebar. This will create the pose asset (including its 

thumbnail) and store it in a temporary file somewhere. 

e Choose an existing pose asset, and open its context 
menu. Click the Open Blend File option. 

e Anew Blender process will start, and automatically open 
the asset library file that contains the chosen pose. By 
the way, this works for all assets, not just poses! 

e In the Asset Browser, click the Paste as New Asset 
button. This will load that temporary file, and load all 
the assets it can find in there. In our case, it will only 
find a single pose, but future versions of Blender may 
extend this for other asset types. This is why the button 
is named so generically - it is not pose-specific. 

e Give the pose a name, and click on the “refresh” button 

in the preview image panel to render a new preview if 

you want. 

Save the file and quit Blender. 

The original Blender is still running in the background 

and notices that the new Blender has quit. It 

automatically refreshes the Asset Browser to show 
the newly added pose. 


Automatically Assigned Catalog 


When you create a pose asset, Blender may automatically 
assign it to an asset catalog. This only works if there is an 


Asset Browser visible; Blender then assigns the pose asset 
to its active asset catalog. If there are multiple Asset 
Browsers open, it performs the following steps: 


e If the current window has one Asset Browser, it uses 
that one. 

e If the current window has multiple Asset Browsers, it 
uses the biggest one. 

e Otherwise Blender goes over the other windows (if there 
are any), and do a similar search. The first window it 
sees that has an Asset Browser wins. 


Controlling the Look of Preview Images 


The pose library preview images are rendered with the 
active Scene camera. This approach was preferred over 
rendering a specific 3D Viewport for two main reasons: 


e There is only one scene camera active at any time, 
making it predictable which camera is used. 

e The camera, as well as the rest of the scene, can be set 
up specifically for rendering the thumbnails. Pose library 
files are intended for that purpose: to contain the poses 
and render their preview images. 


The preview images are rendered using the Workbench 
Engine. Switch the scene to use that as render engine, and 
you'll see various options to influence the look. Select a 
pose asset and press the Generate Preview button to re- 
render the preview image with the current settings. 


You can also animate settings such as MatCap rendering, 
light positions, and intensities, etc. Use this to your 
advantage! 


Scene Animation for Preview Images 


Sometimes it’s handy to have a few different background 
colors or camera angles for your poses. Many facial poses 
are made with a specific camera angle in mind. 


e Background color can be animated by placing a plane 
behind the character and animating its material. In this 
case just for fun, but for more serious applications this 
could be used to indicate a certain character, or a 
mood, or anything else. 

e The active camera can be switched by using camera 
markers. 


Both make it possible to choose a specific frame to pick the 
background color and camera angle. Pose the character, 
click the Create Pose Asset button, and the pose action will 
be keyed on the current frame. This means it’s easy to edit 
the pose and refresh its preview image, because you know 
exactly which frame it was originally created on. 


Using the Pose Library 


The pose library can be used to pose a character in a few 
different ways. In short, you can fully apply a pose or blend 
it into the character’s current pose interactively. How 
exactly these operations work depends on where you use 
them. This section will explain the use from both the Asset 
Browser and the 3D Viewport. 


Use from the Asset Browser 


The pose library can be used directly from the Asset 
Browser. The Pose Library panels will appear when the 


active object is an armature and in Pose Mode. The catalog 
system and the filter bar at the top can be used to search 
for specific poses. 


Flip Pose 
Will mirror the pose from left to right and vice versa. This 
makes it possible, for example, to apply a left-hand pose 
to the right hand, reducing the number of poses you 
have to put into the library. This can of course also be 
applied for asymmetrical facial expressions that depend 
on the camera angle. 


The following operators can be accessed by RMB On a pose: 


Apply Pose 
Applies the pose to the character. If there are any bones 
selected, the pose will be applied only to those bones. 
This makes it possible to create a “finger guns” pose by 
applying a fist pose to the hand, and then an “open 
hand” pose for only the index finger and thumb. Double- 
clicking a pose will also apply it. 


Blend Pose 
Allows you to gradually blend a pose from the library into 
the character’s pose. Click the button, then move the 
mouse left/right to determine the desired blend. While 
blending, you can use the Tab key to toggle between the 
original and the blended pose. As usual in Blender, left- 
click or press Enter to confirm; right-click or press Escape 
to cancel the operator. 


Select/Deselect Pose Bones 
Select or deselect the bones that are used in the pose. 
This can be used to create a selection set, or simply show 
what was part of the pose and what wasn’t. 


Use from 3D Viewport 


The pose library as a side-panel of the 3D Viewport. 


The Sidebar of the 3D Viewport has a Pose Library panel in 
the Animations tab. Contrary to the Asset Browser, which 
can be used for different asset types and also for some 
asset management tasks, this panel is dedicated to applying 
poses. This means that it can allow faster interaction. 


Click on a pose to apply it. A single click is enough. You 
can also select and apply a pose via the cursor keys. This 
allows for fast exploration of the poses, to directly see the 
result on the active character. Of course the Flip Pose 
checkbox Is available here as well - it works the same as 
described in the previous section. 


Drag the pose thumbnail left to right to blend it into 
the character’s current pose. Just release the mouse button 
to confirm. 


To search for poses, hover your mouse over the poses, 
then press Ctri-F and type a search query. This will filter the 


poses to match what you typed. The scrollable area will 
automatically scroll the search field into view. 


Old Pose Library 


The Asset Browser based pose library, described above, 
replaces the old pose library. This section describes that old 
pose library, including how to convert poses to the new 
system. 


Warning 


The old pose library is deprecated in Blender 3.0, and will 
be mostly removed Blender 3.1. Only the Python interface 
will remain a bit longer, and be removed in Blender 3.2. 
The necessary functionality to convert old pose libraries to 
pose assets will remain in Blender for the foreseeable 
future. 


Reference 

Mode: Pose Mode 

Menu: Pose » Pose Library 
See also 


Pose Library Properties. 


Pose Library 
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The old Pose Library panel. 


Converting Old Pose Libraries 


Old-style pose libraries can be converted to pose assets in 
the following way: 


In the Armature properties Pose Library panel, select the 
pose library you want to convert. 

Make sure the scene camera is set up correctly for 
rendering preview images. 

Click the “Convert Old-Style Pose Library” button. 

Open the Asset Browser, and see the poses have been 
converted. 

If you’re happy with the result, remove the old pose 
library Action. 

Save the blend-file. 


As usual, the blend-file should be saved to a directory 
marked as asset library in order to use the pose assets from 
other blend-files. 


Note 


This conversion does not assign the poses to any catalog, 
and so they will appear in the “Unassigned” section of the 
“Current File” asset library. 


Browse Poses (Old Pose Library) 


Warning 


This section describes the deprecated pose library. For the 
new, Asset Browser based pose library, see Pose Library. 


Reference 

Mode: Edit Mode 

Menu: Pose » Pose Library » Browse Poses 
Shortcut: ALt-L 


Interactively browse poses in the 3D Viewport. After running 
the operator, cycle through poses using the Left and Right 
arrow keys. The name of the pose being previewed is 
displayed in the header region. After the desired pose is 
selected using Return or LMB to make it the active pose; to 
cancel browsing, uSé Esc Or RMB. 


Pose 


Index of the pose to apply (-2 for no change, -1 to use 
the active pose). 


Add Pose (Old Pose Library) 


Warning 


This section describes the deprecated pose library. For the 
new, Asset Browser based pose library, see Pose Library. 


Reference 

Mode: Edit Mode 

Menu: Pose » Pose Library » Add Pose 
Shortcut: Shift-L 


If a pose is added, a pose marker is created. The Whole 
Character keying _set is used to determine which bones to 
key. If any bones are selected, only keyframes for those 
bones are added, otherwise all bones in the keying set are 
keyed. Bones that are ignored by the Whole Character 
keying set are always ignored, regardless of their selection 
state. 


Add New 
Adds a new pose to the active pose library with the 
current pose of the armature. 


Add New (Current Frame). 
Will add a pose to the pose library based on the current 
frame selected in the Timeline. In contrast to Add New 
and Replace Existing which automatically allocate a pose 
to an action frame. 


Replace Existing 
Replace an existing pose in the active pose library with 
the current pose of the armature. 


Rename Pose (Old Pose Library) 


Warning 


This section describes the deprecated pose library. For the 
new, Asset Browser based pose library, see Pose Library. 


Reference 

Mode: Edit Mode 

Menu: Pose » Pose Library » Rename Pose 
Shortcut: Shift-Ctrl-L 


Changes the name of the specified pose from the active 
pose library. 


New Pose Name 
The new name for the pose. 


Pose 
The pose action to rename. 


Remove Pose (Old Pose Library) 


Warning 


This section describes the deprecated pose library. For the 
new, Asset Browser based pose library, see Pose Library. 


Reference 

Mode: Edit Mode 

Menu: Pose » Pose Library » Remove Pose 
Shortcut: Shift-Alt-L 


Deletes the specified pose from the active pose library. 


Flip Quats 


Reference 

Mode: Pose Mode 
Menu: Pose >» Flip Quats 
Shortcut: Alt-F 


Flip quaternion values to achieve desired rotations, while 
maintaining the same orientations. 


Show/Hide 


Reference 

Mode: All Modes 

Panel: Properties » Bone >» Viewport Display 
Menu: ... » Show/Hide 


You do not have to use bone layers to show/hide some 
bones. As with objects, vertices or control points, you can 
uSe H: 


e H will hide the selected bone(s). 
e Shift-H will hide all bones but the selected one(s). 
e Alt-H will Show all hidden bones. 


You can also use the Hide checkbox of the Bone tab > 
Viewport Display panel. 


Note that hidden bones are specific to a mode, i.e. you can 
hide some bones in Edit Mode, they will still be visible in 
Pose Mode, and vice versa. Hidden bones in Pose Mode are 
also invisible in Object Mode. And in Edit Mode, the bone to 
hide must be fully selected, not just its root or tip. 


Tool Settings 


Pose Options 


Auto IK 

Reference 

Mode: Pose Mode 

Panel: Sidebar > Tool » Pose Options » Auto IK 


Automatic IK is a tool for quick posing, when enabled, 
translating a bone will activate inverse kinematics and 
rotate the parent bone, and the parent’s parent, and so on, 
to follow the selected bone. The IK chain can only extend 
from a child to a parent bone if the child is connected to it. 


While moving bones, the length of the chain (the number of 
affected bones) can be increased or decreased using 
keyboard hotkeys. Pressing PageUp will increase in chain 
length by one and PageDown decreases the length by one. The 
chain length can also be controlled with wheelUp or WheelDown. 


The initial chain length is 0, which effectively means follow 
the connections to parent bones as far as possible, with no 
length limit. So pressing increasing the chain length the first 
time sets the length to 1 (move only the selected bone), and 
at this point, decreasing the length point sets it back to 0 
(unlimited) again. Thus, you have to increase the chain 
length more than once from the initial state to set a finite 
chain length greater than 1. 


This is a more limited feature than using an IK constraint, 
which can be configured, but it can be useful for quick 
posing. 


X-Axis Mirror 


Reference 
Mode: Edit and Pose Mode 
Panel: Sidebar > Tool » Options >» X-Axis Mirror 


This option enables automatic mirroring of editing actions 
along the X axis. You can enable this option in the Tool tab » 
Options panel, while the armature is selected in Edit Mode. 
When you have pairs of bones of the same name with just a 
different “side suffix” (e.g. “.R”’/”.L’, or “_right”/” left” ...), 
once this option is enabled, each time you transform (move, 
rotate, scale...) a bone, its “other side” counterpart will be 
transformed accordingly, through a symmetry along the 
armature local X axis. AS most rigs have at least one axis of 
symmetry (animals, humans, ...), it is an easy way to keep 
the model symmetrical. 


Relative Mirror 


Reference 
Mode: Edit and Pose Mode 
Panel: Sidebar > Tool » Options >» Relative Mirror 


Accounts for any relative transformations when using X-Axis 
Mirror. 


See also 


Naming_bones. 


Known Limitations 


Relative Mirror is not supported with Auto IK enabled. 


Bone Constraints 
e Introduction 
Inverse Kinematics 


e Introduction 
e Spline IK 


Introduction 


As bones behave like objects sy iM Armature — 4, Bone 
in Pose Mode, they can also Jy Add Bone Constraint 

be constrained. This is why of 

the Constraints tab is shown a= 

in both Object Mode and Edit Pole Target ‘i 
Mode. This panel contains the Iterations 
constraints of the active bone Mt 
(its name is displayed at the Sees 
top of the panel, in the To Reo Ration is 
Bone.:... static text field). Rotation 


Influence 


Constraining bones can be 
used to control their degree of 


freedom in their pose The Bone Constraints 
transformations, using e.g. Properties in Pose Mode, 
the Limit constraints. You can with an Inverse Kinematics 
also use constraints to make a constraint added to the 
bone track another active bone. 


object/bone (inside the same 

object, or in another 

armature), etc. And the inverse kinematics feature is also 
mainly available through the /K Solver constraint, which is 
specific to bones. 


For example, a human elbow cannot rotate backward 
(unless the character has broken their arm), nor to the 
sides, and its forward and roll rotations are limited in a given 
range. (E.g. depending on the rest position of your elbow, it 
may be from (0 to 160) or from (-45 to 135).) 


So you should apply a Limit Rotation constraint to the 
forearm bone (as the elbow movement is the result of 


rotating the forearm bone around its root). 


Using bones in constraints, either as owners or as targets, Is 
discussed in detail in the constraints pages. 


Introduction 


Inverse Kinematics (IK) simplifies the animation process, 
and makes it possible to make more advanced animations 
with lesser effort. 


Inverse Kinematics allow you to position the last bone ina 
bone chain and the other bones are positioned 
automatically. This is like how moving someone’s finger 
would cause their arm to follow it. By normal posing 
techniques, you would have to start from the root bone, and 
set bones sequentially until you reach the tip bone: When 
each parent bone is moved, its child bone would inherit its 
location and rotation. Thus making tiny precise changes in 
poses becomes harder farther down the chain, as you may 
have to adjust all the parent bones first. 


This effort is effectively avoided by use of IK. 


IK is mostly done with bone constraints although there is 
also a simple Auto IK feature in Pose Mode. They work by 
the same method but the constraints offer more options and 
control. Please refer to the following pages for details about 
these constraints: 


e IK Solver 
e Spline IK 


Armature IK Panel 


Reference 


Mode: Pose Mode 


Panel: Properties >» Armature > Inverse 
Kinematics 


This panel is used to select the IK Solver type for the 
armature: Standard or iTaSC. Most the time people will use 
the Standard IK solver. 


Standard 


TODO. 
iTaSC 


iTaSC stands for instantaneous Task Specification using 
Constraints. 


iTaSC uses a different method to compute the Jacobian, 
which makes it able to handle other constraints than just 
end effectors position and orientation: iTaSC is a generic 
multi-constraint IK solver. However, this capability is not yet 
fully exploited in the current implementation, only two other 
types of constraints can be handled: Distance in the 
Cartesian space, and Joint Rotation in the joint space. The 
first one allows maintaining an end effector inside, at, or 
outside a sphere centered on a target position, the second 
one is the capability to control directly the rotation of a bone 
relative to its parent. Those interested in the mathematics 
can find a short description of the method used to build the 
Jacobian here. 


iTaSC accepts a mix of constraints, and multiple constraints 
per bone: the solver computes the optimal pose according 
to the respective weights of each constraint. This is a major 
improvement from the current constraint system where 


constraints are solved one by one in order of definition so 
that conflicting constraints overwrite each other. 


Precision 


The maximum variation of the end effector between two 
successive iterations at which a pose is obtained that is 
stable enough and the solver should stop the iterations. 
Lower values means higher precision on the end effector 
position. 


Iterations 
The upper bound for the number of iterations. 


Solver 
Selects the inverse Jacobian solver that iTaSC will use. 


Computes the damping automatically by estimating 
the level of ‘cancellation’ in the armature kinematics. 
This method works well with the Copy Pose constraint 
but has the drawback of damping more than 
necessary around the singular pose, which means 
slower movements. Of course, this is only noticeable 
in Simulation mode. 


Computes the damping manually which can provide 
more reactivity and more precision. 


Damping Max 
Maximum amount of damping. Smaller values 
means less damping, hence more velocity and 
better precision but also more risk of oscillation at 
singular pose. O means no damping at all. 


Damping Epsilon 


Range of the damping zone around singular pose. 
Smaller values means a smaller zone of control and 
greater risk of passing over the singular pose, 
which means oscillation. 


Note 


Damping and Epsilon must be tuned for each 
armature. You should use the smallest values that 
preserve stability. 


Note 


e The SDLS solver does not work together with a 
Distance constraint. You must use the DLS solver if 
you are going to have a singular pose in your 
animation with the Distance constraint. 

e Both solvers perform well if you do not have a 
singular pose. 


Animation 


In Animation mode, iTaSC operates like an IK solver: it is 
stateless and uses the pose from F-Curves interpolation as 
the start pose before the IK convergence. The target 
velocity is ignored and the solver converges until the given 
precision is obtained. Still the new solver is usually faster 
than the old one and provides features that are inherent to 
iTaSC: multiple targets per bone and multiple types of 
constraints. 


Simulation 


The Simulation mode is the stateful mode of the solver: it 
estimates the target’s velocity, operates in a ‘true time’ 


context, ignores rotation from keyframes (except via a joint 
rotation constraint) and builds up a state cache 
automatically. 


Reiteration 
Never 
The solver starts from the rest pose and does not 
reiterate (converges) even for the first frame. This 
means that it will take a few frames to get to the 
target at the start of the animation. 


Initial 
The solver starts from the rest pose and re-iterates 
until the given precision is achieved, but only on the 
first frame (i.e. a frame which doesn’t have any 
previous frame in the cache). This option basically 
allows you to choose a different start pose than the 
rest pose and it is the default value. For the 
subsequent frames, the solver will track the target by 
integrating the joint velocity computed by the 
Jacobian solver over the time interval that the frame 
represents. The precision of the tracking depends on 
the feedback coefficient, number of substeps and 
velocity of the target. 


Always 
The solver re-iterates on each frame until the given 
precision is achieved. This option omits most of the 
tTaSC dynamic behavior: the maximum joint velocity 
and the continuity between frames is not guaranteed 
anymore in compensation of better precision on the 
end effector positions. It is an intermediate mode 
between Animation and real-time Simulation. 


Auto Step 


Use this option if you want to let the solver set how many 
substeps should be executed for each frame. A substep is 
a subdivision on the time between two frames for which 
the solver evaluates the IK equation and updates the 
joint position. More substeps means more processing but 
better precision on tracking the targets. The auto step 
algorithm estimates the optimal number of steps to get 
the best trade-off between processing and precision. It 
works by estimation of the nonlinearity of the pose and 
by limiting the amplitude of joint variation during a 
substep. It can be configured with next two parameters: 


Min 
Proposed minimum substep duration (in second). The 
auto step algorithm may reduce the substep further 
based on joint velocity. 


Max 
Maximum substep duration (in second). The auto step 
algorithm will not allow substep longer than this 
value. 


Steps 
If Auto Step is disabled, you can choose a fixed number 
of substeps with this parameter. Substep should not be 
longer than 10 ms, which means the number of steps is 4 
for a 25 fps animation. If the armature seems unstable 
(vibrates) between frames, you can improve the stability 
by increasing the number of steps. 


Feedback 
Coefficient on end effector position error to set corrective 
joint velocity. The time constant of the error correction is 
the inverse of this value. However, this parameter has 
little effect on the dynamic of the armature since the 
algorithm evaluates the target velocity in any case. 


Setting this parameter to 0 means ‘opening the loop’: the 
solver tracks the velocity but not the position; the error 
will accumulate rapidly. Setting this value too high means 
an excessive amount of correction and risk of instability. 
The value should be in the range 20-100. Default value is 
20, which means that tracking errors are corrected ina 
typical time of 100-200 ms. The feedback coefficient is 
the reason why the armature continues to move slightly 
in Simulation mode even if the target has stopped 
moving: the residual error is progressively suppressed 
frame after frame. 


Max Velocity 
Indicative maximum joint velocity in radian per second. 
This parameter has an important effect on the armature 
dynamic. Smaller value will cause the armature to move 
Slowly and lag behind if the targets are moving rapidly. 
You can simulate an inertia by setting this parameter to a 
low value. 


Bone IK Panel 


Reference 
Mode: Pose Mode 
Panel: Properties » Bone > Inverse Kinematics 


This panel is used to control how the Pose Bones work in the 
IK chain. 


IK Stretch 
Stretch influence to IK target. 


Lock 
Disallow movement around the axis. 


Stiffness 
Stiffness around the axis. Influence disabled if using 
Lock. 


Limit 
Limit movement around the axis. 


iTaSC Solver 


If the iTaSC IK Solver is used, the bone IK panel changes to 
add these additional parameters. 


Control Rotation 


Activates a joint rotation constraint on that bone. The 
pose rotation computed from Action or UI interaction will 
be converted into a joint value and passed to the solver 
as target for the joint. This will give you control over the 
joint while the solver still tracks the other IK targets. You 
can use this feature to give a preferred pose for joints 
(e.g. rest pose) or to animate a joint angle by playing an 
action on it. 


Weight 
The importance of the joint rotation constraint based 
on the constraints weight in case all constraints 
cannot be achieved at the same time. For example, if 
you want to enforce strongly the joint rotation, set a 
high weight on the joint rotation constraint and a low 
weight on the IK constraints. 


Arm Rig Example 


This arm uses two bones to overcome the twist problem for 
the forearm. IK locking is used to stop the forearm from 


bending, but the forearm can still be twisted manually by 
pressing R Y Y in Pose Mode, or by using other constraints. 


IK Arm Example. 


Note that, if a Pole Target is used, IK locking will not work on 
the root bone. 


Spline IK 


Spline IK is a constraint which aligns a chain of bones along 
a curve. By leveraging the ease and flexibility of achieving 
aesthetically pleasing shapes offered by curves and the 
predictability and well-integrated control offered by bones, 
Spline IK is an invaluable tool in the riggers’ toolbox. It is 
particularly well suited for rigging flexible body parts such 
as tails, tentacles, and spines, as well as inorganic items 
such as ropes. 


Full description of the settings for the spline IK can be found 
on the Spline IK page. 


Basic Setup 


The Spline IK Constraint is not strictly an Inverse Kinematics 
method (i.e. IK Constraint), but rather a Forward Kinematics 
method (i.e. normal bone posing). However, it still shares 
some characteristics of the IK Constraint, such as operating 
on multiple bones, not being usable for Objects, and being 
evaluated after all other constraints have been evaluated. It 
should be noted that if a Standard IK chain and a Spline IK 
chain both affect a bone at the same time the Standard IK 
chain takes priority. Such setups are best avoided though, 
since the results may be difficult to control. 


To setup Spline IK, it is necessary to have a chain of 
connected bones and a curve to constrain these bones to: 


1. With the last bone in the chain selected, add a Spline IK 
Constraint from the Bone Constraints tab in the 
Properties. 


2. Set the Chain Length setting to the number of bones in 
the chain (starting from and including the selected 
bone) that should be influenced by the curve. 

3. Finally, set the Target field to the curve that should 
control the curve. 


Congratulations, the bone chain is now controlled by the 
curve. 


Settings and Controls 


For the precise list of options, see Spline IK constraint. This 
section is intended to introduce the workflow. 


Roll Control 


To control the Roll of the Spline IK chain, the standard 
methods of rotating the bones in the chain along their local 
Y axes still apply. For example, start at the farthest bone 
and simply rotate the bones in the chain around their local Y 
axes to adjust the roll of the chain from that point onward. 


Applying Copy Rotation constraints on the bones also works. 


Note 
There are a couple of limitations to consider: 


e Bones do not inherit a curve’s tilt value to control their 
roll. 

e There is no way of automatically creating a twisting 
effect where a dampened rotation is inherited up the 
chain. Consider using Bendy Bones instead. 


Offset Controls 


The entire bone chain can be made to follow the shape of 
the curve while still being able to be placed at an arbitrary 
point in 3D space when the Chain Offset option is enabled. 
By default, this option is not enabled, and the bones will be 
made to follow the curve in its untransformed position. 


Length Control 


The Y Scale Mode setting can be used to choose the way 
bones are scaled length-wise. The available options allow 
stretching the bone chain to fit the curve, using the pre-IK 
scaling, or doing neither. In addition, the scale of the curve 
Object affects the result. 


Thickness Controls 


The thickness of the bones in the chain is controlled using 
the constraint’s XZ Scale Mode setting. This setting 
determines the method used for determining the scaling on 
the X and Z axes of each bone in the chain. 


The available modes are: 


None 
This option keeps the X and Z scaling factors as 1.0. 


Volume Preserve 
The X and Z scaling factors are taken as the inverse of 
the Y scaling factor (length of the bone), maintaining the 
‘volume’ of the bone. 


Bone Original 


This options just uses the X and Z scaling factors the 
bone would have after being evaluated in the standard 
way. 


In addition to these modes, there is an option, Use Curve 
Radius. When this option is enabled, the average radius of 
the radii of the points on the curve where the joints of each 
bone are placed, are used to derive X and Z scaling factors. 
This allows the scaling effects, determined using the modes 
above, to be tweaked as necessary for artistic control. 


Tips for Nice Setups 


e For optimal deformations, it is recommended that the 
bones are roughly the same length, and that they are 
not too long, to facilitate a better fit to the curve. Also, 
bones should ideally be created in a way that follows 
the shape of the curve in its ‘rest pose’ shape, to 
minimize the problems in areas where the curve has 
Sharp bends which may be especially noticeable when 
stretching is disabled. 

e For control of the curve, it is recommended that hooks 
(in particular, Bone Hooks) are used to control the 
control points of the curve, with one hook per control 
point. In general, only a few control points should be 
needed for the curve (e.g. one for every 3-5 bones 
offers decent control). 

e The type of curve used does not really matter, as long 
as a path can be extracted from it that could also be 
used by the Follow Path Constraint. This really depends 
on the level of control required from the hooks. 


Lattice 


Lattice - or commonly called deformation cage outside of 
Blender. A lattice consists of a three-dimensional non- 
renderable grid of vertices. Its main use is to apply a 
deformation to the object it controls with a Lattice Modifier. 
If the object is parented with Lattice Deform a Lattice 
Modifier is automatically applied. 


Editing 


Flip (Distortion Free) 
Mirrors the vertices displacement from their base 
position. 


U,V, W 


Make Regular 
Resets the whole lattice to a regular grid, where the cells 
are scaled to one cubic unit. 


Properties 


Lattice 
A Data-Block Menu. 


te ‘m@ | Lattice faa Lattice 


LY Wy Lattice 


¥ Lattice 


Resolution U 


VW 


InterpolationU BSpline 
BSpline 
BSpline 


Outside 
Vertex Group &s 


>» Vertex Groups 
» Shape Keys 


» Custom Properties 


Lattice properties. 


Lattice 


Points 
Rate of subdivision in the axes: 


U,V, W 


Interpolation Type 
Selector for each axis. See Different types of 
interpolation.. 


Linear, Cardinal, Catmull-Rom, B-Spline 


Outside 


Takes only the vertices on the surface of the lattice into 
account. 


Vertex Group 
The strength of the influence assigned as a weight to the 
individual vertices in the selected vertex group. 


Usage 


The lattice should be scaled and moved to fit around your 
object in Object Mode. Any scaling applied to the object in 
Edit Mode will result in the object deforming. This includes 
applying its scale with ctrl-A as this will achieve the same 
result as scaling the lattice in Edit Mode, and therefore the 
object. 


Lattice around the cube object in Object Mode. 


Constraints 


e Introduction 
) Tips 


Interface 


Adding/Removing_a Constraint 
Header 

Common 

Stack 


Motion Tracking 


e Camera Solver Constraint 
e Object Solver Constraint 
e Follow Track Constraint 


Transform 


Copy Location Constraint 
Copy Rotation Constraint 
Copy Scale Constraint 
Copy Transforms Constraint 
Limit Distance Constraint 
Limit Location Constraint 
Limit Rotation Constraint 
Limit Scale Constraint 
Maintain Volume Constraint 
Transformation Constraint 


Transform Cache Constraint 


Tracking 


Clamp To Constraint 

Damped Track Constraint 
Inverse Kinematics Constraint 
Locked Track Constraint 
Spline IK Constraint 

Stretch To Constraint 

Track To Constraint 


Relationship 


Action Constraint 
Armature Constraint 
Child Of Constraint 
Floor Constraint 
Follow Path Constraint 
Pivot Constraint 
Shrinkwrap Constraint 


Introduction 


Constraints are a way to control an object’s properties (e.g. 
its location, rotation, scale), using either plain static values 
(like the “limit” ones), or another object, called “target” (like 
e.g. the “copy” ones). 


Even though constraints are useful in static projects, their 
main usage is obviously in animation. 


e You can control an object’s animation through the 
targets used by its constraints (this is a form of indirect 
animation). Indeed, these targets can then control the 
constraint’s owner’s properties, and hence, animating 
the targets will indirectly animate the owner. 

e You can animate constraints’ settings. e.g. the Influence 
or when using an armature’s bone as target, animate 
where along this bone (between root and tip) lays the 
real target point. 


They can make the eyes of a tennis player track a tennis 
ball bouncing across the court, allow the wheels on a bus to 
all rotate together, help a dinosaur’s legs bend at the knee 
automatically, and make it easy for a hand to grip the hilt of 
a sword and the sword to swing with the hand. 


Constraints, in Blender, work with Objects and Bones. Read 
about using constraints in rigging in the Armature chapter. 


The Constraint Stack 


is evaluated from 


Object Bone top to bottom. 


Constraints work in combination with each other to form a 
Constraint Stack. 


Tips 


Constraints are a fantastic way to add sophistication and 
complexity to a rig. 


But be careful not to rush in too quickly, piling up constraint 
upon constraint until you lose all sense of how they interact 
with each other. 


Start simply. Get to know a single constraint inside and out. 
Copy Location Constraint is a good first constraint to explore 
it also has an animation example. Take the time to 
understand every fundamental concept behind it, and the 
other constraints will make far more sense. 


Adding/Removing a 
Constraint 


What is described on this page about Object Constraints can 
be also be applied on Bone Constraints. 


Tab 


Reference 
Mode: Object Mode 
Menu: Properties » Constraint tab 


To add a constraint click on the Add Object Constraint menu 
in the Constraints tab. 


Add Constraint 


Motion Tracking Transforn T Relationshit 
-o4 Camera Solver ti> Copy Location ( Clamp To > Action 
a Follow Track (Ss Copy Rotation FS * Damped Track oF Armature 
‘O Object Solver Copy Scale »--, Locked Track tq Child Of 

“) Copy Transforms 2 Stretch To ? _ Floor 

*! Limit Distance o Track To G> Follow Path 


Limit Location Pivot 


C Limit Rotation Shrinkwrap 


: Limit Scale 
ol) Maintain Volume 
(x) Transformation 


(x) Transform Cache 


To remove a constraint click on the “X” button in the header. 


Menu 


Add Constraint (with Targets) 


Reference 
Mode: Object Mode and Pose Mode 
Menu: Object » Constraint » Add Constraint 


(with Targets) 


Adds a constraint to the active object. The type of constraint 
must be chosen from a pop-up menu, though it can be 
changed later from the Add Constraint (with Targets) Adjust 
Last Operation panel. If there is an other object selected 
besides the active one, that object will be the constraint 
target (if the chosen constraint accepts targets). 


When using a bone from another armature as the target for 
a constraint, the tool will look inside the non-active 
armature and use its active bone, provided that armature is 
in Pose Mode. 


Copy Constraints to Selected Objects 


Reference 
Mode: Object Mode and Pose Mode 
Menu: Object » Constraint » Copy Constraints to 


Selected Objects 


Copies the active object Constraints to the rest of the 
selected objects. 


Clear Object Constraints 


Reference 
Mode: Object Mode and Pose Mode 
Panel: Object >» Constraint >» Clear Object 


Constraints 


Removes all Constraints of the selected object(s). 


Track 


Reference 
Mode: Object Mode 
Panel: Object > Track 


These tools add a tracking constraint to the selected 
objects; the target object of the constraint will be the active 
object, which won’t have a constraint added. 


e Damped Track Constraint 
e Track To Constraint 
e Lock Track Constraint 


Clear Track 
Removes all Damped Track, Track To and Lock Track 
Constraints from the selected objects. 


Clear and Keep Transformation (Clear Track) 
Removes all Track Constraint from the selected objects, 
while keeping the final transform caused by them. 


Header 


Every constraint has a header. The interface elements of the 
header are explained below using a Copy Location 
constraint as an example. 


Target 
YX 
Invert 


Offset 


Space 


Influence 


A Header sits at the top of every constraint. 


Expand (down/right arrow icon) 
Show or Hide the settings of the constraint. Tidy up the 
constraint stack by hiding constraints that do not 
currently need attention. Constraints will continue to 
affect the scene even when hidden. 


Icon 
The constraint type icon. 


Name 
Give the constraint a meaningful name in this text field, 
which describes its purpose. Meaningful names help you 
and your team members understand what each 
constraint is supposed to do. 


The red background is a warning that the constraint is 
not yet functional. The background will turn gray when 
the constraint is functioning. When this Copy Location 
constraint has a valid target in the target fie/d it will turn 
gray and begin to function. 


Mute (eye icon) 
Enable or Disable the constraint. Disabling a constraint 
will stop its affect on the scene. 


Disabling a constraint is useful for turning off a constraint 
without losing all of its settings. Disabling means you can 
enable the constraint at a later time with the settings 
intact. Disabling is similar to setting the Influence to 0.0. 


Extras 
Apply ctrt-A 
Makes the constraint “real” by applying any 
transformations caused by the constraint to make the 
original object to match the results of the constraint 
and deletes the constraint. 


Warning 

Applying a constraint that is not first in the stack will 
ignore the stack order (it will be applied as if it was 
the first one), and may produce undesired results. 


Duplicate Shift-D 
Creates a duplicate of the constraint just below 
current one in the stack. 


Copy to Selected 
Copies the constraint from the Active object to all 
selected objects. 


Move to First/Last 
Moves the constraint to the first or last position in the 
constraint stack. 


Delete xX X, Delete 
Delete the constraint from the stack. The settings will be 
lost. The constraint will no longer affect the final outcome 
of the stack. 


Move :::: 
Move a constraint up or down in the constraint stack. 
Since the stack is evaluated from top to bottom, moving 
a constraint in the stack can significantly affect the final 
outcome of the stack. 


e If there is only one constraint in the stack, the arrows 
will not be displayed. 

e If the constraint is at the top of the stack, only the 
down arrow will be displayed. 

e If the constraint is at the bottom of the stack, only 
the up arrow will be displayed. 


Common 


Target 


The Target Data ID field lets you link the constraint to a 
Target object of your choosing. This link provides data to the 
constraint so that it can begin to function. For example, the 
Copy Location Constraint needs location data to function. Fill 
in the Target field, and the Copy Location constraint will 
begin to use location data from the Target object. 


Target 
Vv XxX 
Invert 


Offset 


Space 


Influence 


The Target field must be filled in for the constraint to 
function. 


By default, the Target will use the Object Origin as the target 
point. 


If the Target field links to a Mesh or Lattice object, a Vertex 
Group field will appear. Enter the name of a vertex group 
and the constraint will target the median point of this vertex 
group instead of the object’s origin. 


Location 


Target @ Cube 


Vertex Group 


ma X m Y ¥ Z 
Invert Invert Invert 
Offset 

Space World Space 


Influence 


If the Target field links to an Armature, a Bone field will 
appear along with a Head/Tail slider. Enter the name of a 
bone and the constraint will target the bone instead of the 
entire armature object origin. 


tS Copy Location 


Target @ Armature 
Bone : Bone 
Head/Tail 
VY Xx 

Invert 

Offset 


Space World Space v World Space 


Influence: 1.000 


The slider moves the precise position of the target between 
the Head and Tail of the bone. Some constraints have a 
button next to the slider that enables using the curved 
shape of Bendy Bones. 


Space 


Constraints need a frame of reference in order to function. 
This frame of reference is called the “space” of the 
constraint. Choosing one space vs. another will change this 
frame of reference and substantially alter the behavior of a 
constraint. 


To understand how changing the space will change the 
behavior of the constraint, consider experimenting with two 
empties. Make sure they display as arrows so that you can 
see the local axes for each empty. Make sure to size one 
empty a little larger than the other so that they are both 
always visible even if directly on top of each other. Then add 
a constraint to one empty that targets the other and 
experiment thoroughly by moving, rotating and scaling the 
target in many different ways. 


th Copy Location 


Target: @ Cube 
Vertex Group: is 
VY Xx 
Invert 
Offset 
Space World Space 


Influence: 


This constraint is set to use World Space as the 
frame of reference for both its Target space and its 
Owner space. 


Target Space & Owner Space 


The space used to evaluate the target of the constraint is 
called the Target space. The space used to evaluate the 
constrained object (the object that owns the constraint) is 


called the Owner space. Hover over the space select 
menu(s) to learn whether it affects the space of the target 
or the space of the owner. 


When the constraints use a Target and/or/nor an Owner 
space there will be no, one or two selector(s). The Copy 


Location constraint in example use both Target and Owner 
space. 


When a constraint uses both Target and Owner space, the 
Target and Owner can be any combination of space types. 


Space Types 


World Space 


In this space type the world is the frame of reference for 
the object (or bone). Location is relative to the world 
origin. Rotation and Scale are oriented to the world axes. 
Transformations to the object, the object’s parent and 
any other constraints higher up in the constraint stack 
are all taken into account. 


Local Space 


This space excludes all effects of the parent objects or 
bones, as well as the rest position and orientation of the 
bone itself. Only transformations applied to the object or 
bone itself are taken into account. 


Warning 


For objects without a parent Local Space has a special 
meaning, different from the normal behavior of local 
space for bones or objects that have a parent. This 
behavior is kept for backwards compatibility, but may 
be removed in the future and shouldn’t be used. 


Local with Parent Bones Only 


The bone position and orientation is evaluated relative to 
its rest pose location and orientation, thus including both 
its own transformations and those caused by a possible 
parent relationship (i.e. the chain’s transformations 
above the bone). 


Pose Space Bones Only 


The bone position and orientation is evaluated in the 
armature object local space (i.e. independently from the 
armature transformations in Object Mode). Hence, if the 
armature object has null transformations, Pose Space will 
have the same effect as World Space. 


Custom Space 


The position and orientation is evaluated relative to the 
current position and orientation of an arbitrary object or 
bone that is specified via additional input fields that 
appear when this option is selected. This can be used to 
evaluate the constraint using an arbitrary coordinate 
system. 


Local Space (Owner Orientation) Bone Targets Only 
This space works like Local Space, with an additional 
coordinate space transformation that compensates for 
the difference in the rest pose orientations of the owner 
and target bones. If applied as the Local Space of the 
owner, this will produce the same global space 
movement as the target, provided parents are still at rest 
pose. 


This option replaces the following setup with two 
additional bones: 


1. An extra child bone of the target, rotated the same 
as the owner in rest pose. 


2. An extra sibling bone of the target, positioned same 
as the child in rest pose and using Copy Transforms 
in World Space from the child. 

3. The constraint uses Local Space of the sibling instead 
of the original target. 

This video demonstrates the difference from ordinary 
Local Space: 


Influence 


The influence slider determines how much the constraint 
will affect the constrained object (target). 


Target 


Vertex Group: &s 


vy xX 


Invert 
Offset 


Space 


Influence: 


An influence of 0.0 will have no effect. An influence of 1.0 
will have the full effect. 


Values between (0.0 and 1.0) will have a partial effect, but 
be careful. These partial effects can be difficult to control, 
especially as the constraint stack grows in complexity. 


The influence value is animatable, allowing constraints to be 
turned off, or partially on as needed. 


The x button after the influence slider can be used to disable 
the constraint while trying to preserve the current object 
position. This may not work perfectly if other constraints 
remain active. 


Stack 


The combination of all the constraints affecting an object is 
called the Constraints Stack. The Stack is in the Constraints 
panel, below the Add Constraint menu. 


Constraints in the stack are evaluated from top to bottom. 
The order of each constraint has a substantial impact on the 
final outcome of the stack. Changing the order of the 
constraints can change the behavior of the entire stack. 


Add Object Constraint 


- t Copy Location 


Copy Rotation 


Copy Scale 


Maintain Volume 


Damped Track 


The constraints in this example stack are evaluated 
from top to bottom starting with the “Copy Location” 
constraint and ending with the final “Damped Track” 
constraint. 


To change the order of a constraint use the up/down arrows 
in the header. 


Camera Solver Constraint 


The Camera Solver constraint gives the owner of this 
constraint, the location and rotation of the “solved camera 
motion”. 


The “solved camera motion” is where Blender reconstructs 
the position of the physical, real-world camera, when it 
filmed the video footage, relative to the thing being tracked. 


Note 


This constraint only works after you have set up a 
minimum of eight markers and pressed Solve Camera 
Motion (Movie Clip Editor >» Toolbar >» Solve » Solve Camera 
Motion). 


Options 


¥ -ca Camera Solver 


¥ Active Clip 


Constraint to F-Curve 


Influence 1.000 


Camera Solver Constraint panel. 


Active Clip 
Receive tracking data from the scene’s Active Clip. If 
unchecked, an option appears to choose from the other 
clips. 


Constraint to F-Curve 
Applies the constraint, creating Keyframes for the 
transforms. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Object Solver Constraint 


The Object Solver constraint gives the owner of this 
constraint, the location and rotation of the “solved object 
motion”. 


The “solved object motion” is where Blender thinks the 
physical, real-world (tracked) object was, relative to the 
camera that filmed it. 


Can be used to add a mesh to video for example. 


Note 


This constraint only works after you have set up a 
minimum of eight markers and pressed Solve object 
Motion. Located at Movie Clip Editor >» Toolbar > Solve » 
Solve Camera Motion. 


If it says Solve Camera Motion instead of Solve Object 
Motion then go into the Movie Clip Editor > Sidebar region 
>» Objects and switch it from the camera, to an object. 


Options 


YO: Object Solver 
¥ Active Clip 
Camera Fis 


Set Inverse Clear Inverse 


Constraint to F-Curve 


Influence 1.000 x) . 


Object Solver Constraint panel. 


Active Clip 
Receive tracking data from the scene’s Active Clip. If 
unchecked, an option appears to choose from the other 
clips. 


Object 
Select a tracked object to receive transform data from. 


Camera 
Select the camera to which the motion is parented to (if 
left empty the active scene camera is used). 


Set Inverse 
Moves the origin of the object to the origin of the 
camera. 


Clear Inverse 
Moves the origin of the object back to the spot set in the 
Movie Clip Editor Toolbar > Solve > Orientation > Set 
Origin. 


Constraint to F-Curve 
Applies the constraint, creating keyframes for the 
transforms. 


Influence 


Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Follow Track Constraint 


By default the Follow Track constraint is making objects 
have the same position at a frame as the track has. The 
motion of this object happens on a single plane defined by 
the camera and the original position of the object. 


Options 


olow ack 
¥ Active Clip 
3D Position 
Undistort 
Frame Method Stretch 


Camera @ 


Depth Object 


Constraint to F-Curve 


Influence 1.000 


Follow Track Constraint panel. 


Active Clip 
Receive tracking data from the scene’s Active Clip. If 
unchecked, an option appears to choose from the other 


Clips. 


3D Position 
Use the 3D position of the track to parent to. 


Undistorted 
Parent to the undistorted position of the 2D track. 


Frame Method 
Defines how the footage is fitted in the camera frame. 


Camera 
Select the camera to which the motion is parented to (if 
empty, the active scene camera is used). 


Depth Object 
If this object is set, constrained objects will be projected 
onto the surface of this depth object which can be used 
to create facial makeup visual effects. 


Constraint to F-Curve 
Creates F-Curves for the object that copies the 
movement caused by the constraint. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Follow Track Example Video 


Copy Location Constraint 


The Copy Location constraint forces its owner to have the 
same location as its target. 


Important 


Note that if you use such a constraint on a connected 
bone, it will have no effect, as it is the parent’s tip which 
controls the position of your owner bone’s root. 


Options 


Copy Location 


Target @ 


Influence 


Copy Location panel. 


Target 
Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Axis 


These buttons control which axes are constrained. 


Invert 
Invert their respective corresponding axis coordinates. 


Offset 
When enabled, this control allows the owner to be moved 


(using its current transform properties), relative to its 
target’s position. 


Target/Owner 
Standard conversion between spaces. See common 
constraint properties for more information. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Examples 


Animation 


Let us animate a solar system with the Copy Location 
constraint and its Offset option. You can make the owner, 
called “moon”, describe perfect circles centered on the 
world origin (using e.g. Location X/Y sine and cosine F- 
Curves, see Built-in Function Modifier). Then copy the 
location of a target “earth” with the Offset checkbox 
enabled to model a satellite in a (simplified) orbit around its 
planet. Repeat these steps for more planets circling around 
its center star “sun”. 


Following video is a small animation of a solar system 
created using (among a few others) the previously 
described technique: 


Note that, this ‘solar’ system is not realistic at all (the wrong 
scale, the earth is rotating in the wrong direction around the 
sun, ...). 


You can download the blend-file used to create this 
animation. 


Furthermore you can also animate a few properties of each 
constraint using animation curves: e.g. you can animate the 
Influence of a constraint. It is used to first let the camera 
follow the moon, then the earth, and finally using two Copy 
Location constraints with Offset set. 


Copy Rotation Constraint 


The Copy Rotation constraint forces its owner to match the 
rotation of its target. 


Options 


Target @ 


Order Default 


Target 


Owner 


Influence 


Copy Rotation panel. 


Target 
Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Order 
Allows specifying which Euler order to use during the 
copy operation. Defaults to the order of the owner. 


Axis 
These buttons control which axes are constrained. 


Invert 
Invert their respective corresponding axis coordinates. 


Mix 
Specifies how the new rotation is combined with the 
existing rotation. 


Replace 
The new axis values replace existing values. 


Add 
The new axis values are added to the existing values. 


Before Original 
The new rotation is added before the existing rotation, 
as if it was applied to a parent of the constraint owner. 


After Original 
The new rotation is added after the existing rotation, 
as if it was applied to a child of the constraint owner. 


Offset (Legacy) 
This replicates the behavior of the original Offset 
checkbox. It was intended to be similar to the Before 
Original behavior, but does not work correctly with 
multiple axis rotations, and is thus deprecated. 


Target/Owner 
Standard conversion between spaces. See common 
constraint properties for more information. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Copy Scale Constraint 


The Copy Scale constraint forces its owner to have the same 
scale as its target. 


Note 


Here we talk of scale, not of size! Indeed, you can have 
two objects, one much bigger than the other, and yet both 
of them have the same scale. This is also true with bones: 
in Pose Mode, they all have a unitary scale when they are 
in rest position, represented by their visible length. 


Options 


Copy Scale 


Target 


1.000 


Make Uniform 


Influence 


Copy Scale panel. 


Target 


Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Axis 
These buttons control which axes of the target scale are 
copied. 


Power 
Allows raising the copied scale to the specified arbitrary 
power. 


Make Uniform 
Instead of copying scale for individual axes, apply a 
uniform scaling factor to all axes of the owner that 
achieves the same overall change in volume. 


Offset 
When enabled, the constraint combines the copied scale 
with the owner’s scale, instead of overwriting it. 


Additive 
Uses addition instead of multiplication in the 
implementation of the Offset option. 


Target/Owner 
Standard conversion between spaces. See common 
constraint properties for more information. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Note 


Since scale is a multiplicative quantity, it should be 
combined using multiplication, and split into fractions or 
inverted via power. Thus the use of Power is more 
mathematically correct than /nfluence, which uses linear 
interpolation. The use of the Additive option is also not 
recommended. 


Tip 


To copy scale from one axis of the target to all axes of the 
owner, disable other axes, enable Make Uniform, and set 
Power to 3. 


Example 


Copy Transforms 
Constraint 


The Copy Transforms constraint forces its owner to have the 
Same transforms as its target. 


Options 


Copy Transforms 
Target 
Remove Target Shear 


Mix Replace 


Target World Space 


Owner World Space 


Influence 1.000 


Copy Transforms panel. 


Target 
Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Remove Target Shear 
Removes shearing from the target transformation after 
the target space conversion, ensuring it consists purely 
of translation, rotation and scale. Note that Copy Rotation 
always does this. 


Mix 


Specifies how the copied transformation is combined with 
the existing transformation. 


Replace 


The new transformation replaces the existing 
transformation. 


Before/After Original (Full) 


The new transformation is added before/after the 
existing transformation, as if it was applied to an 
imaginary parent/child of the constraint owner. Scale 
is handled like in the most basic Full Inherit Scale 
mode of bones, so combining non-uniform scale and 
rotation will create shear. 


Before/After Original (Aligned) 
The new transformation is added before/after the 
existing transformation, as if it was applied to an 
Imaginary parent/child of the constraint owner. Scale 
is handled like in the Aligned Inherit Scale mode of 
bones to avoid creating shear. 


This is equivalent to using the Split Channels option, 
but replacing the location component with the result 
of Full. |f only uniform scale is used, the result is 
identical to Full. 


Before/After Original (Split Channels) 


Combines location, rotation and scale components of 
the transformation separately, similar to a sequence 
of three Copy Location, Copy Rotation and Copy Scale 
(with Offset) constraints bundled together in one 
operation; the result may be slightly different in case 
of sheared inputs. 


Unlike Aligned, in this mode location channels are 
simply added together, so rotation and scale 
components of the input transformations cannot affect 
the resulting location. 


Target/Owner 
Standard conversion between spaces. See common 
constraint properties for more information. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


This video shows the difference between the mix modes. 
The right input is mixed after the left one: 


A general demonstration of the constraint: 


Limit Distance Constraint 


The Limit Distance constraint forces its owner to stay either 
further from, nearer to, or exactly at a given distance from 
its target. In other words, the owner’s location is constrained 
either outside, inside, or at the surface of a sohere centered 
on its target. 


When you specify a (new) target, the Distance value is 
automatically set to correspond to the distance between the 
owner and this target. 


Important 


Note that if you use such a constraint on a connected 
bone, it will have no effect, as it is the parent’s tip which 
controls the position of your owner bone’s root. 


Options 


Limit Distance 


Target 


Distance 


Clamp Region _ Inside 


Affect Transform 


Target World Space 


Owner World Space 


Influence 1.000 


Limit Distance panel. 


Target 
Data ID used to select the constraint’s target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Distance 
This number field sets the limit distance, i.e. the radius of 
the constraining sphere. 


Reset Distance x 
When clicked, this small button will reset the Distance 
value, so that it corresponds to the actual distance 
between the owner and its target (i.e. the distance 
before this constraint is applied). 


Clamp Region 
The Limit Mode select menu allows you to choose how to 
use the sphere defined by the Distance setting and 
target’s origin: 


Inside 
The owner is constrained inside the sphere. 


Outside 
The owner is constrained outside the sphere. 


Surface 
The owner is constrained on the surface of the sphere. 


Affect Transform 
Transform operators will take the constraint into account 
to immediately restrict the resulting transform property 
values. 


Target/Owner 


Standard conversion between spaces. See common 
constraint properties for more information. 


Influence 


Controls the percentage of affect the constraint has on 


the object. See common constraint properties for more 
information. 


Tip 


Evaluating both owner and target in a Custom Space using 
the root bone or any other suitable parent bone will 


automatically scale the effective distance with the relevant 
part of the rig. 


Example 


Limit Location Constraint 


An object or unconnected bone can be moved around the 
scene along the X, Y and Z axes. This constraint restricts the 
amount of allowed translations along each axis, through 
lower and upper bounds. 


The limits for an object are calculated from its origin, and 
the limits of a bone, from its root. 


It is interesting to note that even though the constraint 
limits the visual and rendered location of its owner, its 
owner's data-block still allows (by default) the object or 
bone to have coordinates outside the minimum and 
maximum ranges. This can be seen in its Transform panel. 


When an owner is selected and attempted to be moved 
outside the limit boundaries, it will be constrained to those 
boundaries visually and when rendered, but internally, its 
coordinates will still be changed beyond the limits. If the 
constraint is removed, its ex-owner will seem to jump to its 
internally specified location. 


Similarly, if its owner has an internal location that is beyond 
the limits, dragging it back into the limit area will appear to 
do nothing until the internal coordinates are back within the 
limit threshold (unless you enabled the Affect Transform 
option, see below). 


Setting equal the min and max values of an axis, locks the 
owner’s movement along that axis... Although this is 
possible, using the Transformation Properties axis locking 
feature is probably easier! 


Options 


* Lj Limit Location 


Minimum X 


Affect Transform 


wner Space World Space 


Influence 1.000 


Limit Location panel. 


Minimum X, Y, Z 
These buttons enable the lower boundary for the location 
of the owner’s origin along, respectively, the X, Y and Z 
axes of the chosen Space. The number field below them 
controls the value of their limit. Note that if a min value 
is higher than its corresponding max value, the 
constraint behaves as if it had the same value as the 
max one. 


Maximum X, Y, Z 
These buttons enable the upper boundary for the 
location of the owner’s origin along, respectively, the X, Y 
and Z axes of the chosen Space. Same options as above. 


Affect Transform 
As pointed out before by default, even though visually 
constrained, the owner can still have coordinates out of 
bounds (as shown by the Transform panel). Well, when 
you enable this checkbox, this is no longer possible - the 


owner’s transform properties are also limited by the 
constraint. However, note that, the constraint does not 
directly modify the coordinates: you have to select its 
owner one way or another for this to take effect... 


Owner 
This constraint allows you to choose in which space to 
evaluate its owner's transform properties. See common 
constraint properties for more information. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Limit Rotation Constraint 


An object or bone can be rotated around the X, Y and Z 
axes. This constraint restricts the amount of allowed 
rotations around each axis, through lower and upper 
bounds. 


It is interesting to note that even though the constraint 
limits the visual and rendered rotations of its owner, its 
owner's data-block still allows (by default) the object or 
bone to have rotation values outside the minimum and 
maximum ranges. This can be seen in the Transform panel. 
When an owner is rotated and attempted to be rotated 
outside the limit boundaries, it will be constrained to those 
boundaries visually and when rendered, but internally, its 
rotation values will still be changed beyond the limits. If the 
constraint is removed, its ex-owner will seem to jump to its 
internally specified rotation. 


Similarly, if its owner has an internal rotation that is beyond 
the limit, rotating it back into the limit area will appear to do 
nothing until the internal rotation values are back within the 
limit threshold (unless you enabled the Affect Transform 
option, see below). 


Setting equal the min and max values of an axis, locks the 
owner's rotation around that axis... Although this is possible, 
using the Transformation Properties axis locking feature is 
probably easier. 


This transform does not constrain the bone if it is 
manipulated by the IK solver. For constraining the rotation of 
a bone for IK purposes, see Inverse Kinematics. 


Options 


vy =} Limit Rotation 


Limit X 


Order Default 


Affect Transform 


Owner World Space 


Influence 1.000 


Limit Rotation panel. 


Limit X, Y, Z 
These buttons enable the rotation limit around 
respectively the X, Y and Z axes of the owner, in the 
chosen Owner space. The Min and Max number fields to 
their right control the value of their lower and upper 
boundaries, respectively. 


Note 

e If a min value is higher than its corresponding max 
value, the constraint behaves as if it had the same 
value as the max one. 

e Unlike the Limit Location constraint, you cannot 
separately enable lower or upper limits. 

e The constraint can be used to simply remove shear 
from the owner transformation by leaving all limits 
disabled. 


Order 
Allows specifying which Euler order to use when applying 
the limits. Defaults to the order of the owner. 


Affect Transform 
The constraint is taken into account when the object is 
manually rotated using transformation tools in the 
editors. This prevents assigning transformation property 
values (as shown in the Transform panel) that exceed the 
specified limits. 


Owner 
This constraint allows you to choose in which space 
evaluate its owner’s transform properties. See common 
constraint properties for more information. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Limit Scale Constraint 


An object or bone can be scaled along the X, Y and Z axes. 
This constraint restricts the amount of allowed scaling along 
each axis, through lower and upper bounds. 


Important 


This constraint does not tolerate negative scale values 
(those you might use to mirror an object...): when you add 
it to an object or bone, even if no axis limit is enabled, nor 
the Affect Transform option, aS soon as you scale your 
object, all negative scale values are instantaneously 
inverted to positive ones... And the boundary settings can 
only take strictly positive values. 


It is interesting to note that even though the constraint 
limits the visual and rendered scale of its owner, its owner’s 
data-block still allows (by default) the object or bone to have 
scale values outside the minimum and maximum ranges (as 
long as they remain positive!). This can be seen in its 
Transform panel. When an owner is scaled and attempted to 
be moved outside the limit boundaries, it will be constrained 
to those boundaries visually and when rendered, but 
internally, its coordinates will still be changed beyond the 
limits. If the constraint is removed, its ex-owner will seem to 
jump to its internally-specified scale. 


Similarly, if its owner has an internal scale that is beyond 
the limits, scaling it back into the limit area will appear to do 
nothing until the internal scale values are back within the 
limit threshold (unless you enabled the Affect Transform 


option, see below, or your owner has some negative scale 
values). 


Setting equal the min and max values of an axis locks the 
owner’s scaling along that axis. Although this is possible, 
using the Transformation Properties axis locking feature is 
probably easier. 


Options 


¥ BJ; Limit Scale 


Minimum X 


Maximum X 


Affect Transform 


Owner Space World Space 


Influence 1.000 


Limit Scale panel. 


Minimum/Maximum X, Y, Z 
These buttons enable the lower boundary for the scale of 
the owner along respectively the X, Y and Z axes of the 
chosen Space. The Min and Max number fields to their 
right control the value of their lower and upper 
boundaries, respectively. 


Note 


If a min value is higher than its corresponding max 
value, the constraint behaves as if it had the same 


value as the max one. 


Affect Transform 
As pointed out before by default, even though visually 
constrained, and except for the negative values, the 
owner can still have scales out of bounds (as shown by 
the Transform panel). When you enable this checkbox, 
this is no longer possible, the owner transform properties 
are also limited by the constraint. However, note that, 
the constraint does not directly modify the scale values: 
you have to scale its owner one way or another for this to 
take effect. 


Owner 
This constraint allows you to choose in which space to 
evaluate its owner’s transform properties. See common 
constraint properties for more information. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Maintain Volume 
Constraint 


The Maintain Volume constraint limits the volume of a mesh 
or a bone to a given ratio of its original volume. 


See also 


Harkyman on the development of the Maintain Volume 
constraint. 


Options 


v ol) Maintain 


Mode 
Free Axis 
Volume 


Owner Space 


Influence 


Maintain Volume Constraint. 


Mode 
Specifies how the constraint handles scaling of the non- 


free axes. 


Strict 
This mode overrides non-free axis scaling to strictly 


maintain the specified volume. Only the ratio between 


the scale of the non-free axes is passed through. 


Uniform 
This mode maintains the volume as specified only 
when the pre-constraint scaling is uniform. Deviations 
from uniform scaling on non-free axes are passed 
through. 


Single Axis 
This mode maintains the volume only when the object 
is scaled just on its free axis. Any additional non-free 
axis scaling is passed through. 


Free Axis 
The free-scaling axis of the object. 


Volume 
The bone’s rest volume. 


Owner 
This constraint allows you to choose in which space to 
evaluate its owner’s transform properties. See common 
constraint properties for more information. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Transformation Constraint 


This constraint is more complex and versatile than the other 
“transform” constraints. It allows you to map one type of 
transform properties (i.e. location, rotation or scale) of the 
target, to the same or another type of transform properties 
of the owner, within a given range of values (which might be 
different for each target and owner property). You can also 
switch between axes, and use the range values not as 
limits, but rather as “markers” to define a mapping between 
input (target) and output (owner) values. 


So, e.g. you can use the position of the target along the X 
axis to control the rotation of the owner around the Z axis, 
stating that 1 unit along the target X axis corresponds to 10 
units around the owner Z axis. Typical uses for this include 
gears (see note below), and rotation based on location 
setups. 


Options 


Transformation 


Target 


Extrapolate 


Target World Space 


Owner World Space 


Influence 1.000 


¥ Map From 


Location Rotation 


Location Rotation 
X Source Axis 
Min 
Max 
Y Source Axis 
Min 
Max 
Z Source Axis 


Min 


Transformation panel. 


Target 
Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Extrapolate 


By default, the Min and Max values bound the input and 
output values; all values outside these ranges are clipped 
to them. When you enable this button, the Min and Max 
values are no longer strict limits, but rather “markers” 
defining a proportional (linear) mapping between input 
and corresponding output values. Let us illustrate that 
with two graphs Fig. The Extrapolate principles... In these 
pictures, the input range (in abscissa) is set to (1.0 to 
4.0), and its corresponding output range (in ordinate), to 
(1.0 to 2.0). The yellow curve represents the mapping 
between input and output. 


The Extrapolate principles. 


Extrapolate 


Extrapolate enabled: the 
disabled: the output values are 
output values are “free” to 
bounded inside the proportionally 
(1.0 to 2.0) range. follow the input 
ones. 
Target/Owner 


Standard conversion between spaces. See common 
constraint properties for more information. 


Influence 


Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 


information. 


Map From 


It contains the input (from target) settings. 


Location, Rotation, Scale 


The radio buttons allow you to select which type of 
property to use. 


Mode (Rotation) 


Allows specifying the type of rotation input to use, 
including different Euler orders, Quaternion, and other 
Rotation Channel Modes. Defaults to using the Euler 
order of the constraint owner. 


In the Quaternion mode the channels are converted to 
weighted angles in the same way as the swing angles of 
the Swing_and X/Y/Z Twist modes. 


X/Y/Z Min, Max 


Independently for each axis (X, Y, and Z) the min and 
max number fields control the lower and upper bounds of 
the input value range. Note that if a min value is higher 
than its corresponding max value, the constraint behaves 
as if it had the same value as the max one. 


Map To 


It contains the output (to owner) settings. 


Location, Rotation, Scale 


The three radio buttons allow you to select which type of 
property to control. 


Order (Rotation) 
For rotation, allows specifying which Euler order to use 
during evaluation of the constraint. Defaults to using the 
order of the constraint owner. 


X/Y/Z Source Axis 
The three axis selectors allow you to select which input 
axis to map to, respectively (from top to bottom), the X, 
Y and Z output (owner) axes. 


Min, Max 
The Min and Max number fields control the lower and 
upper bounds of the output value range, independently 
for each mapped axis. Note that if a min value is higher 
than its corresponding max value, the constraint behaves 
as if it had the same value as the max one. 


Mix 
Specifies how the result of the constraint is combined 
with the existing transformation. The set of available 
choices varies based on the type of transformation. 


Replace 
The result of the constraint replaces the existing 
transformation. 


Multiply (Scale) 
The new values are multiplied with the existing axis 
values. 


Add (Location, Rotation) 
The new values are added to the existing axis values. 


Before Original (Rotation) 
The new rotation is added before the existing rotation, 
as if it was applied to a parent of the constraint owner. 


After Original (Rotation) 
The new rotation is added after the existing rotation, 
as if it was applied to a child of the constraint owner. 


Note 


e For historical reasons, the Mix mode defaults to Add for 
location and rotation, and Replace for scale. 


e When using the rotation transform properties of the 
target as input, whatever the real values are, the 
constraint will always “take them back” into the (-180 
to 180) range. E.g. if the target has a rotation of 420 
degrees around its X axis, the values used as X input 
by the constraint will be: 


\(((420 + 180) modulo 360) - 180 = 60 - ...\) 
This is why this constraint is not really suited for gears! 


Similarly, when using the scale transform properties of 
the target as input, whatever the real values are, the 
constraint will always take their absolute values (i.e. 
invert negative ones). 


When a min value is higher than its corresponding max 
one, both are considered equal to the max one. This 
implies you cannot create “reversed” mappings... 


Example 


Transform Cache 
Constraint 


The Transform Cache Constraint is used to stream 
animations from Alembic or USD made at the transformation 
matrix level (for example rigid bodies, or camera 
movements). 


When importing an Alembic or USD file, Transform Cache 
constraints are automatically added to objects with 
animated transforms. For time-varying meshes (so 
deforming animations), the Mesh Sequence Cache modifier 
is used. 


Options 


Transform Cache 


ol v CacheFile 


File Path 


Override Frame 
Frame Offset 


Manual Scale 


Velocity Attribute 


Velocity Unit 


Object Path 


Influence 


Transform Cache Constraint. 


Cache File 
Data-block menu to select the Alembic or USD file. 


File Path 
Path to the Alembic or USD file. 


Sequence 
Whether or not the cache is separated in a series of files. 


Override Frame 


Whether to use a custom frame for looking up data in the 
cache file, instead of using the current scene frame. 


The Frame value is the time to use for looking up the 
data in the cache file, or to determine which to use ina 
file sequence. 


Frame Offset 


Subtracted from the current frame to use for looking up 
the data in the cache file, or to determine which file to 
use in a file sequence. 


Manual Scale 


Value by which to enlarge or shrink the object with 
respect to the world’s origin. 


Velocity Attribute 
The name of the Alembic attribute used for generating 
motion blur data; by default, this is .velocities which is 
standard for most Alembic files. 


Note 


The Velocity Attribute option is currently for Alembic 
files only. 


Velocity Unit 
Defines how the velocity vectors are interpreted with 
regard to time. 
Frame 
The velocity unit was encoded in frames and does not 
need to be scaled by scene FPS. 
Second 


The velocity unit was encoded in seconds and needs 
to be scaled by the scene FPS (1 / FPS). 


Note 


The Velocity Unit option is currently for Alembic files 
only. 


Object Path 
The path to the Alembic or USD object inside the archive 
or stage. 

Influence 


Controls the percentage of affect the constraint has on 


the object. See common constraint properties for more 
information. 


Clamp To Constraint 


The Clamp To constraint clamps an object to a curve. The 
Clamp To constraint is very similar to the Follow Path 
constraint, but instead of using the evaluation time of the 
target curve, Clamp To will get the actual location properties 
of its owner (those shown in the Transform panel), and 
judge where to put it by “mapping” this location along the 
target curve. 


One benefit is that when you are working with Clamp To, it is 
easier to see what your owner will be doing; since you are 
working in the 3D Viewport, it will just be a lot more precise 
than sliding keys around on an F-Curve and playing the 
animation over and over. 


A downside is that unlike in the Follow Path constraint, 
Clamp To does not have any option to track your owner’s 
rotation (pitch, roll, yaw) to the banking of the targeted 
curve, but you do not always need rotation on, so in cases 
like this it’s usually a lot handier to fire up a Clamp To, and 
get the bits of rotation you do need some other way. 


The mapping from the object’s original position to its 
position on the curve is not perfect, but uses the following 
simplified algorithm: 


e A “main axis” is chosen, either by the user, or as the 
longest axis of the curve’s bounding box (the default). 

e The position of the object is compared to the bounding 
box of the curve in the direction of the main axis. So for 
example if X is the main axis, and the object is aligned 
with the curve bounding box’s left side, the result is 0; if 
it is aligned with the right side, the result is 1. 


e If the cyclic option is unchecked, this value is clamped in 
the range 0-1. 

e This number is used as the curve time, to find the final 
position along the curve that the object is clamped to. 


This algorithm does not produce exactly the desired result 
because curve time does not map exactly to the main axis 
position. For example an object directly in the center of a 
curve will be clamped to a curve time of 0.5 regardless of 
the shape of the curve, because it is halfway along the 
curve’s bounding box. However, the 0.5 curve time position 
can actually be anywhere within the bounding box! 


Options 


Clamp To 


Target 


Main Axis | Auto 


Influence 


Clamp To panel. 


Target 
The target Data ID indicates which curve object the 
Clamp To constraint will track along. The target must be a 
curve object type. See common constraint properties for 
more information. 


Main Axis 
This button group controls which global axis (X, Y or Z) is 
the main direction of the path. When clamping the object 
to the target curve, it will not be moved significantly on 


this axis. It may move a small amount on that axis 
because of the inexact way this constraint functions. 


For example if you are animating a rocket launch, it will 
be the Z axis because the main direction of the launch 
path is up. The default Auto option chooses the axis 
which the curve is longest in (or X if they are equal). This 
is usually the best option. 


Cyclic 
By default, once the object has reached one end of its 
target curve, it will be constrained there. When the Cyclic 
option is enabled, as soon as it reaches one end of the 
curve, it is instantaneously moved to its other end. This 
is of course primarily designed for closed curves (e.g. 
circles), as this allows your owner to go around it over 
and over. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Damped Track Constraint 


The Damped Track constraint constrains one local axis of 
the owner to always point towards Target. This constraint 
uses a pure Swing rotation, i.e. the shortest possible single 
axis rotation. In other 3D software you can find it with the 
name “Look at” constraint. 


Although usually associated with bones, Damped Track can 
align objects to point to (and follow) other objects or bones. 
It is important to note that the constraint aligns the origin’s 
axes to point to the target’s origin point. This is illustrated in 
the following figure. In each case the objects are set as 
Damped Track to +X. 


A: Object vertices aligned along axis origin. B: 
Object vertices aligned away from origin. 


Options 


Damped Track 


Target @ 


Track Axis X 


Influence 


Damped Track panel. 


Target 
Data ID used to select the constraint’s target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Track Axis 
Once the owner object has had a Damped Track 
constraint applied to it, you must then choose which axis 
of the object you want to point at the Target object. The 
negative axis direction cause the object to point away 
from the Target object along the selected axis direction. 


-X, -Y, -Z, X, Y, Z 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Inverse Kinematics 
Constraint 


The Inverse Kinematics constraint implements the inverse 
kinematics armature posing technique. Hence, it is only 
available for bones. To quickly create an IK constraint with a 
target, select a bone in Pose Mode, and press Shift-I. 


This constraint is fully documented in the Inverse 
Kinematics page, part of the rigging chapter. 


Note 


The IK constraints are special in that they modify multiple 
bones. For this reason, they ignore their position in the 
stack and always run after all other constraints on the 
affected bones. To apply constraints after IK, it is 
necessary to first copy the final transformation to a new 
bone chain, e.g. using Copy Transforms. 


Options 


Target @ 


Pole Target 


Iterations 
Chain Length 
¥ Use Tail 
¥ Stretch 
Weight Position 


Rotation 


Influence 


Inverse Kinematics panel. 


Target 
Data ID used to select the an armature. See common 
constraint properties for more information. 


Pole Target 
Object for pole rotation. 


Iterations 
Maximum number of solving iterations. 


Chain Length 
How many bones are included in the IK effect. Set to 0 to 
include all bones. 


Use Tail 
Include bone’s tail as last element in chain. 


Stretch 
Enable IK stretching. 


Weight Position 
For Tree-IK: Weight of position control for this target. 


Rotation 
Chain follows rotation of target. 


Target 
Disable for targetless IK. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


i1TaSC Solver 


If the iTaSC IK Solver is used, the IK Solver Constraint 
changes to add these addition parameters. 


IK Type 
Copy Pose 
Equivalent to the traditional end effector position and 
orientation constraint: the end effector is constrained 
to take the position, and optionally the orientation, of 
a given target, which is set in the target field. 


Position/Rotation Locking 
Allows to obtain various effect by not constraining 
the coordinates along certain axis. 


Axis Reference 
Specifies how to compute the axis coordinates. 


Bone 
The coordinates are the position and 
orientation of the target relative to the bone. 


Target 


The opposite of Bone, the coordinates are the 
position and orientation of the tip of the bone 


relative to the target. 


Distance 
Specify that the end effector will stay inside, at, or 


outside a sphere centered on the target object. 


Limit Mode 


Inside 
The end effector will stay inside of the distance 


from the target object. 


Outside 
The end effector will stay outside of the distance 


from the target object. 


On Surface 
The end effector will stay exactly at the distance 


from the target object. 


Distance 
The radius from the target object. 


Note 
The Influence parameter is not implemented if Pole Target 
is used. 


Example 


Locked Track Constraint 


The Locked Track constraint is a bit tricky to explain, both 
graphically and textual. Basically, it is a Track To constraint, 
but with a locked axis, i.e. an axis that cannot rotate 
(change its orientation). Hence, the owner can only track its 
target by rotating around this axis, and unless the target is 
in the plane perpendicular to the locked axis, and crossing 
the owner, this owner cannot really point at its target. 


Let us take the best real-world equivalent: a compass. It can 
rotate to point in the general direction of its target (the 
magnetic North, or a neighbor magnet), but it cannot point 
directly at it, because it spins like a wheel on an axle. Ifa 
compass is sitting on a table and there is a magnet directly 
above it, the compass cannot point to it. If we move the 
magnet more to one side of the compass, it still cannot 
point at the target, but it can point in the general direction 
of the target, and still obey its restrictions of the axle. 


When using a Locked Track constraint, you can think of the 
target as a magnet, and the owner as a compass. The Lock 
axis will function as the axle around which the owner spins, 
and the To axis will function as the compass’ needle. Which 
axis does what is up to you! 


If you have trouble understanding the buttons of this 
constraint, read the tooltips, they are pretty good. If you do 
not know where your object’s axes are, enable Axis in 
Properties » Armature > Viewport Display. Or, if you are 
working with bones, turn on the Axes in the armature’s 
Viewport Display panel. 


This constraint was designed to work cooperatively with the 
Track To constraint. If you set the axes buttons right for 
these two constraints, Track To can be used to point the axle 
at a primary target, and Locked Track can spin the owner 
around that axle to a secondary target. 


This constraint also works very well for 2D billboarding. 
Options 


Locked Track 


Target @ 


Track Axis x 


Locked Axis 


Influence 


Locked track panel. 


Target 
Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Track Axis 
The tracking local axis, i.e. the owner’s axis to point at 
the target. The negative options force the relevant axis 
to point away from the target. 


Locked Axis 
The locked local axis, i.e. the owner’s axis which cannot 
be re-oriented to track the target. 


Important 


If you choose the same axis for Tracking Axis and Locked 
Axis, the constraint will no longer be functional (red state). 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Spline IK Constraint 


The Spline IK constraint aligns a chain of bones along a 
curve. By leveraging the ease and flexibility of achieving 
aesthetically pleasing shapes offered by curves and the 
predictability and well-integrated control offered by bones, 
Spline IK is an invaluable tool in the riggers’ toolbox. It is 
particularly well suited for rigging flexible body parts such 
as tails, tentacles, and spines, as well as inorganic items 
such as ropes. 


To set up Spline IK, it is necessary to have a chain of 
connected bones and a curve to constrain these bones to: 


e With the last bone in the chain selected, add a Spline IK 
constraint from the Bone Constraints tab in the 
Properties. 

e Set the ‘Chain Length’ setting to the number of bones in 
the chain (starting from and including the selected 
bone) that should be influenced by the curve. 

e Finally, set Target to the curve that should control the 
curve. 


Note 


The IK constraints are special in that they modify multiple 
bones. For this reason, they ignore their position in the 
stack and always run after all other constraints on the 
affected bones. To apply constraints after IK, it is 
necessary to first copy the final transformation to a new 
bone chain, e.g. using Copy Transforms. 


Options 


Spline IK 
Target 
Influence 
¥ Fitting 


Chain Length 
Even Divisions 


Chain Offset 


¥ Chain Scaling 


¥ Use Curve Radius 
Y Scale Mode’ ‘Fit Curve 


XZ Scale Mode None 


Spline IK panel. 


Target 


Data ID used to select the target curve. See common 
constraint properties for more information. 


Influence 


Controls the percentage of affect the constraint has on 


the object. See common constraint properties for more 
information. 


Fitting 


Chain Length 
How many bones are included in the chain. 


Even Division 


Ignore the relative length of the bones when fitting to the 
curve. 


Chain Offset 
Retain the offset of the root joint from the start point of 
the curve. 


Chain Scaling 


Use Curve Radius 
Average radius of the endpoints is used to tweak the X 
and Z scaling of the bones, on top of the X and Z scale 
mode. 


Y Scale Mode 
Specifies how the length of a bone is scaled when it is 
fitted to the curve, in addition to the effects of target 
curve object scale and curvature. 


None 
The bone Is reset to its rest pose length. 


Fit Curve 
The bones are stretched to cover the entire length of 
the curve. 


Bone Original 
The original Y axis scale of the bone is used. 


XZ Scale Mode 


Scaling that a bone undergoes in the other two 
directions. 


None 
Do not scale the X and Z axes. 


Bone Original 
Use the original scaling of the bones. 


Inverse Scale 
Scale of the X and Z axes is the inverse of the Y scale. 


Volume Preservation 
Similar to the Stretch To constraint. 


Use Original Scale 
Specifies that Inverse Scale or Volume Preservation 
should be applied on top of the original scaling of the 
bones, like in the Stretch To constraint. 


See also 


This subject is seen in-depth in the Armature Posing 
section. 


Example 


Stretch To Constraint 


The Stretch To constraint causes its owner to rotate and 
scale its Y axis towards its target. So it has the same 
tracking behavior as the Track To constraint. However, it 
assumes that the Y axis will be the tracking and stretching 
axis, and does not give you the option of using a different 
one. 


It also optionally has some raw volumetric features, so the 
owner can squash down as the target moves closer, or thin 
out as the target moves farther away. Note however, that it 
is not the real volume of the owner which is thus preserved, 
but rather the virtual one defined by its scale values. Hence, 
this feature works even with non-volumetric objects, like 
empties, 2D meshes or surfaces, and curves. 


With bones, the “volumetric” variation scales them along 
their own local axes (remember that the local Y axis of a 
bone is aligned with it, from root to tip). 


Options 


Stretch To 


Target 


Original Length 


Volume Variation 
Volume Min 


Max 


Maintain Volume 


Rotation 


Influence 


Stretch To panel. 


Target 
Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Original Length 


This number field sets the rest distance between the 
owner and its target, i.e. the distance at which there is no 
deformation (stretching) of the owner. 


Reset Original Length x 
When clicked, this small button will recalculate the 
Rest Length value, so that it corresponds to the actual 
distance between the owner and its target (i.e. the 
distance before this constraint is applied). 


Volume Variation 


This number field controls the amount of “volume” 
variation exponentially to the stretching amount. Note 
that the 0.0 value is not allowed, if you want to disable 
the volume feature, use the None button (see below). 


Volume Min, Max 


Limits for the volume preservation to a minimum and 
maximum scaling each by a Bulge factor. 


Smooth 
Smoothness factor to make limits less visible. 


Maintain Volume 
These buttons control which of the X and/or Z axes 
should be affected (scaled up/down) to preserve the 
virtual volume while stretching along the Y axis. If you 
enable the none button, the volumetric features are 
disabled. 


Rotation 


Specifies how the owner should be rotated to track the 
target with its Y axis. 


XZ, ZX 
These buttons are equivalent to the Up ones of the 
Track To constraint: the owner is rotated around two 
local axes in the specified order. 


Swing 
The constraint uses a single Swing rotation, equivalent 
to the Damped Track constraint. 


Influence 


Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Track To Constraint 


The Track To constraint applies rotations to its owner, so 
that it always points a given “To” axis towards its target, 
with another “Up” axis permanently maintained as much 
aligned with the global Z axis (by default) as possible. This 
tracking is similar to the “billboard tracking” in 3D (see note 
below). 


This is the preferred tracking constraint, as it has a more 
easily controlled constraining mechanism. 


This constraint shares a close relationship to the Inverse 
Kinematics constraint in some ways. 


Tip 
Billboard Tracking 


The term “billboard” has a specific meaning in real-time 
CG programming (i.e. video games!), where it is used for 
plane objects always facing the camera (they are indeed 
“trackers”, the camera being their “target”). Their main 
usage is as support for tree or mist textures: if they were 
not permanently facing the camera, you would often see 
your trees squeezing to nothing, or your mist turning into a 
mille-feuille paste, which would be funny but not so 
credible. 


Options 


Track To 


Target 


Track Axis X 


Up 


Target 


Owner 


Influence 


Track To panel. 


Target 
Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Track Axis 
The tracking local axis, i.e. the owner’s axis to point at 
the target. The negative options force the relevant axis 
to point away from the target. 


Up 
The “upward-most” local axis, i.e. the owner’s axis to be 
aligned (as much as possible) with the global Z axis (or 
target Z axis, when the Target button is enabled). 


Target Z 
By default, the owner’s Up axis is (as much as possible) 
aligned with the global Z axis, during the tracking 
rotations. When this button is enabled, the Up axis will be 
(as much as possible) aligned with the target’s local Z 
axis? 


Target/Owner 


Standard conversion between spaces. See common 
constraint properties for more information. 


Influence 


Controls the percentage of affect the constraint has on 


the object. See common constraint properties for more 
information. 


Warning 


If you choose the same axis for Tracking Axis and Up, the 
constraint will not be functional anymore (red state). 


Example 


Action Constraint 


The Action constraint is powerful. It allows you control an 
Action using the transformations of another object. 


The underlying idea of the Action constraint is very similar 
to the one behind the Drivers, except that the former uses a 
whole action (i.e. multiple F-Curves of the same type), while 
the latter controls a single F-Curve of their “owner”... 


Note that even if the constraint accepts the Mesh action 
type, only the Object, Pose and Constraint types are really 
working, as constraints can only affect objects’ or bones’ 
transform properties, and not meshes’ shapes. Also note 
that only the object transformation (location, rotation, scale) 
is affected by the action, if the action contains keyframes 
for other properties they are ignored, as constraints do not 
influence those. 


As an example, let us assume you have defined an Object 
action (it can be assigned to any object, or even no object at 
all), and have mapped it on your owner through an Action 
constraint, so that moving the target in the (0.0 to 2.0) 
range along its X axis maps the action content on the owner 
in the (0 to 100) frame range. This will mean that when the 
target’s X property is 0.0 the owner will be as if in frame 0 
of the linked action; with the target’s X property at 1.0 the 
owner will be as if in frame 50 of the linked action, etc. 


Options 


Action 
Target 
Evaluation Time 


Mix Before Original (Split Cha.v « 


Influence 1.000 x] . 


¥ Target 
Channel X Location 
Target World Space 
Range Min 0.000 
Max 0.000 
Y Action 
Action *3° 
Object Action 
Frame Start 0 
End 0 


Action panel. 


Target 


Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Evaluation Time 


This property allows objects to be driven without a 
constraint target by interpolating between the Action 
Start and End frames. The relative position between the 
start and end frame can be controlled using the value 
Slider. 


This is very helpful for more complex rigging and 
mechanical rigs, as it means the Action constraint can be 
controlled directly with a Driver or Custom Property. 


Mix 
Specifies how the keyframed transformation from the 
action is combined with the existing transformation. 
These modes are the same as in the Copy Transforms 
constraint. 


Before/After Original (Full) 


The keyframed transformation is added before/after 
the existing transformation, as if it was applied to an 
imaginary parent/child of the constraint owner. Scale 
is handled like in the most basic Full Inherit Scale 
mode of bones, so combining non-uniform scale and 
rotation will create shear. 


Before/After Original (Aligned) 
The keyframed transformation is added before/after 
the existing transformation, as if it was applied to an 
imaginary parent/child of the constraint owner. Scale 
is handled like in the Aligned Inherit Scale mode of 
bones to avoid creating shear. 


This is equivalent to using the Split Channels option, 
but replacing the location component with the result 
of Full. |f only uniform scale is used, the result is 
identical to Full. 


Before/After Original (Split Channels) 
Combines location, rotation and scale components of 
the transformation separately, similar to a sequence 
of three Copy Location, Copy Rotation and Copy Scale 
(with Offset) constraints bundled together in one 
operation; the result may be slightly different in case 
of sheared inputs. 


Unlike Aligned, in this mode location channels are 
simply added together, so rotation and scale 


components of the input transformations cannot affect 
the resulting location. 


Warning 

For technical reasons modes other than After Original 
(Full) and After Original (Aligned) may not work as 
expected for constraints on objects (not bones) without 
a parent. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Target 


Channel 
This selector controls which transform property (location, 
rotation or scale along/around one of its axes) from the 
target to use as “action driver”. 


Target 
This constraint allows you to choose in which space to 
evaluate its target’s transform properties. 


Range Min, Max 
The lower and upper bounds of the driving transform 
property value. 


Warning 


Unfortunately, here again we find the constraint’s 
limitations: 


e When using a rotation property as “driver”, these 
values are “mapped back” to the (-180.0 to 180.0) 
range. 

e When using a scale property as “driver”, these 
values are limited to null or positive values. 


Action 


Action 
Select the name of the action you want to use. 


Warning 


Even though it might not be in red state (UI refresh 
problems...), this constraint is obviously not functional 
when this field does not contain a valid action. 


Object Action 
Bones only, when enabled, this option will make the 
constrained bone use the “object” part of the linked 
action, instead of the “same-named pose” part. This 
allows you to apply the action of an object to a bone. 


Frame Start, End 


The starting and ending frames of the action to be 
mapped. 


Note 


e These values must be strictly positive. 

e By default, both values are set to 0, which disables 
the mapping (i.e. the owner just gets the properties 
defined at frame O of the linked action...). 


Notes 


e When the object or bone already has Action constraints, 
the next constraint using a newly keyframed action 
Should be added before all others in order to get the 
same final combined transformation. This fact is not 
affected by the Mix mode. 

e Unlike usual, you can have a Start value higher than the 
End one, or a Min one higher than a Max one: this will 
reverse the mapping of the action (i.e. it will be 
“played” reversed...), unless you have both sets 
reversed, obviously! 

e When using a Constraint action, it is the constraint 

channel’s names that are used to determine to which 

constraints of the owner apply the action. E.g. if you 
have a constraint channel named “trackto_empt1”, its 
keyed Influence and/or Head/Tail values (the only ones 
you can key) will be mapped to the ones of the owner’s 
constraint named “trackto_emptl”. 

Similarly, when using a Pose action (which is obviously 

only meaningful and working when constraining a 

bone!), it is the bone’s name that is used to determine 

which bone channel’s names from the action to use (e.g. 

if the constrained bone is named “arm”, it will use and 

only use the action’s bone channel named “arm”...). 

Unfortunately, using a Pose action on a whole armature 

object (to affect all the keyed bones in the action at 

once) will not work... 

e Actions can also be marked as Asset, but with certain 
limitations. For more info, see Pose Library. 


Example 


Armature Constraint 


Armature is the constraint version of the Armature Modifier, 
exactly reproducing the weight-blended bone 
transformations and applying it to its owner orientation. It 
can be used like a variant of the Child Of constraint that can 


handle multiple parents at once, but requires all of them to 
be bones. 


Note 


Unlike the Armature modifier, the constraint does not take 


the Deform checkbox of bones into account, and can use 
any bone as target. 


Options 


eae 
vy AS Armature 


Add Target Bone 
@ Armature x “ Bone 


Blend Weight 


@ Armature x = Bone.002 


Blend Weight 0.600 
Normalize Weights 
Preserve Volume 
Use Envelopes 


Use Current Location 


1.000 & 


Influence: 


Armature constraint. 


Preserve Volume 
Like the matching option of the modifier, it enables the 
use of quaternions for preserving the volume of the 
object during deformation. 


Use Envelopes 
To approximate envelope-only behavior of the modifier, 
add all relevant bones with weight 1.0 and enable this 
option. 


Note 


Unlike the modifier, the constraint always requires 
explicitly listing all of its target bones with associated 
weights. This option merely enables envelopes for all 
bones, as if they had Envelope Multiply enabled. 


Use Current Location 
Only for constraints on bones: Instead of using the rest 
location, use the current location of the owner bone to 
compute envelope weights or binding to B-Bone 
segments. 


With envelope weights, this can be used to change the 
active “parent” bone of the owner bone dependent on its 
location. For non-bones this mode is always active, 
because they don’t have a rest location. 


Add Target Bone 
This button adds a new empty entry at the end of the 
target list. 


Normalize Weights 


This button normalizes all weight values in the target list 
so that they add up to 1.0. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Bones 


This specifies the list of bones used by the constraint to 
deform its owner. Each target bone has the following input 
fields and controls: 


Target 
Unlike the modifier, the constraint can use bones coming 
from different armatures at the same time. See common 
constraint properties for more information. 


Sub-target 
Name of the target bone. 


Remove Button x 
Removes the entry from the target list. 


Weight 
Weight associated with the bone, equivalent to vertex 
groups in the modifier. 


Child Of Constraint 


Child Of is the constraint version of the standard 
parent/children relationship between objects (the one 
established through the ctri-P shortcut, in the 3D Viewport). 


Parenting with a constraint has several advantages and 
enhancements, compared to the traditional method: 


e You can have several different parents for the same 
object (weighting their respective influence with the 
Influence slider). 


e As with any constraint, you can key (i.e. animate) its 
Influence setting. This allows the object which has a 
Child Of constraint upon it to change over time which 
target object will be considered the parent, and 
therefore have influence over it. 


Important 


Do not confuse this “basic” object parenting with the 
one that defines the chains of bones inside of an 
armature. This constraint is used to parent an object to 
a bone (the so-called object skinning), or even bones 
to bones. But do not try to use it to define chains of 
bones. 


Options 


Child Of 
Target 
Location 
Rotation 
Scale 


Set Inverse Clear Inverse 


Influence 1.000 x] . 


Child Of panel. 


Target 
The target object that this object will act as a child of. 
Data ID used to select the constraint’s target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Location 
Each of these buttons will make the parent affect or not 
affect the location along the corresponding axis. 


Rotation 
Each of these buttons will make the parent affect or not 
affect the rotation around the corresponding axis. 


Scale 
Each of these buttons will make the parent affect or not 
affect the scale along the corresponding axis. 


Set Inverse 
By default, when you parent your owner to your target, 
the target becomes the origin of the owner’s space. This 
means that the location, rotation and scale of the owner 
are offset by the same properties of the target. In other 
words, the owner is transformed when you parent it to 
your target. This might not be desired! So, if you want to 


restore your owner to its before-parenting state, click on 
the Set Inverse button. 


Clear Inverse 
This button reverses (cancels) the effects of the above 
one, restoring the owner/child to its default state 
regarding its target/parent. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Tips 


When creating a new parent relationship using this 
constraint, it is usually necessary to click on the Set Inverse 
button after assigning the parent. As noted above, this 
cancels out any unwanted transform from the parent, so 
that the owner returns to the location/rotation/scale it was in 
before the constraint was applied. Note that you should 
apply Set Inverse with all other constraints disabled (their 
Influence set to 0.0) for a particular Child Of constraint, and 
before transforming the target/parent (see example below). 


About the toggle buttons that control which target’s (i.e. 
parent’s) individual transform properties affect the owner, it 
is usually best to leave them all enabled, or to disable all 
three of the given Location, Rotation and Scale transforms. 


Technical Note 


If you use this constraint with all channels on, it will use a 
straight matrix multiplication for the parent relationship, not 


decomposing the parent matrix into loc/rot/size. This 
ensures any transformation correctly gets applied, also for 
combinations of rotated and non-uniform scaled parents. 


Examples 


No constraint. 


Note the position of 
Owner empty 1.0 
unit along the X and 
Y axes. 


Offset set. 


Set Inverse has been 
clicked, and Owner 


Child Of just added. 


Here you can see 
that Owner empty is 
now 1.0 unit away 
from Target_1 empty 
along X and Y axes. 


Target/parent 
transformed. 


Target_1 has been 
moved along the XY 


is back to its original 
position. 


Offset cleared. 


Clear Inverse has 
been clicked. Owner 
is fully again 
controlled by 
Target_1l. 


plane, rotated 
around the Z axis, 
and scaled along its 
local X axis. 


Offset set again. 


Set Offset has been 
clicked again. As you 
can see, it does not 
gives the same 
result as in 
(Target/parent 
transformed). As 
noted above, use 
Set Inverse only 
once, before 
transforming your 
target/parent. 


Floor Constraint 


The Floor constraint allows you to use its target position 
(and optionally rotation) to specify a plane with a “forbidden 
side”, where the owner cannot go. This plane can have any 
orientation you like. In other words, it creates a floor (ora 
ceiling, or a wall)! Note that it is only capable of simulating 
entirely flat planes, even if you use the Vertex Group option. 
It cannot be used for uneven floors or walls. 


Options 


Use Rotation 


Target World Space 


Owner World Space 


Influence 1.000 


Floor panel. 


Target 
Data ID used to select the constraints target, and is not 
functional (red state) when it has none. See common 
constraint properties for more information. 


Offset 


Allows you to offset the “floor” plane from the target’s 
origin, by the given number of units. Use it e.g. to 


account for the distance from a foot bone to the surface 
of the foot’s mesh. 


Max/Min 


Controls which plane will be the “floor”. The names of the 


buttons correspond, indeed, to the norma! to this plane 
(e.g. enabling Z means “XY plane”, etc.). By default, 
these normals are aligned with the global axes. However, 
if you enable Use Rotation (see above), they will be 
aligned with the local target’s axes. As the constraint 
does not only define an uncrossable plane, but also a 


side of it which is forbidden to the owner, you can choose 


which side by enabling either the positive or negative 
normal axis... e.g. by default Z, the owner is stuck in the 
positive Z coordinates. 


Use Rotation 
Forces the constraint to take the target’s rotation into 
account. This allows you to have a “floor” plane of any 
orientation you like, not just the global XY, XZ and YZ 
ones... 


Target/Owner 
Standard conversion between spaces. See common 
constraint properties for more information. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Follow Path Constraint 


The Follow Path constraint places its owner onto a curve 
target object, and makes it move along this curve (or path). 
It can also affect its owner’s rotation to follow the curve’s 
bends, when the Follow Curve option is enabled. 


It could be used for complex camera traveling, a train on its 
rails and most other vehicles can also use “invisible” tracks, 
the links of a bicycle chain, etc. 


The owner is always evaluated in the global (world) space: 


e Its location (as shown in the Transform panel) is used as 
an offset from its normal position on the path. E.g. if you 
have an owner with the (1.0, 1.0, 0.0) location, it will be 
one unit away from its normal position on the curve, 
along the X and Y axis. Hence, if you want your owner 
on its target path, clear its location Alt-c! 

e This location offset is also proportionally affected by the 
scale of the target curve. Taking the same (1.0, 1.0, 0.0) 
offset as above, if the curve has a scale of (2.0, 1.0, 
1.0), the owner will be offset two units along the X axis 
(and one along the Y one)... 

e When the Follow Curve option is enabled, its rotation is 
also offset to the one given by the curve. E.g. if you 
want the Y axis of your object to be aligned with the 
curve’s direction, it must be in rest, non-constrained 
state, aligned with the global Y axis. Here again, 
clearing your owner's rotation Alt-R might be useful... 


The movement of the owner along the target curve/path 
may be controlled in two different ways: 


e The most simple is to define the number of frames of 
the movement, in the Path Animation panel! of the Curve 
tab, via the Frames number field, and its start frame via 
the constraint’s Offset option (by default, start frame: 1 
[= offset of 0], duration: 100). 

e The second way, much more precise and powerful, is to 

define an Evaluation Time interpolation curve for the 

Target path (in the Graph Editor). See the Graph Editor 

chapter to learn more about F-Curves. 

If you do not want your owner to move along the path, 

you can give to the target curve a flat Soeed F-Curve 

(its value will control the position of the owner along the 

path). 


Follow Path is another constraint that works well with the 
Locked Track one. One example is a flying camera on a path. 
To control the camera’s roll angle, you can use a Locked 
Track and a target object to specify the up direction, as the 
camera flies along the path. 


Note 
Follow Path & Clamp To 


Do not confuse these two constraints. Both of them 
constraint the location of their owner along a curve, but 
Follow Path is an “animation-only” constraint, inasmuch as 
the position of the owner along the curve is determined by 
the time (i.e. current frame), whereas the Clamp To 
constraint determines the position of its owner along the 
curve using one of its location properties’ values. 


Note 


Note that you also need to keyframe Evaluation Time for 
the Path. Select the path, go to the Path Animation panel 

in the curve properties, set the overall frame to the first 
frame of the path (e.g. frame 1), set the value of 
Evaluation time to the first frame of the path (e.g. 1), right- 
click on Evaluation time, select create keyframe, set the 
overall frame to the last frame of the path (e.g. frame 
100), set the value of Evaluation time to the last frame of 
the path (e.g. 100), right-click on Evaluation time, select 
create keyframe. 


Options 


Follow Path 
Target @ 
Offset 
Forward Axis 
Up Axis 
Fixed Position 
Curve Radius 
Follow Curve 


Animate Path 


Influence 1.000 © - 


Follow Path panel. 


Target 
Data ID used to select the constraint’s target, which must 
be a curve object, and is not functional (red state) when 
it has none. See common constraint properties for more 
information. 


Offset 
The number of frames to offset from the “animation” 
defined by the path (by default, from frame 1). 


Forward Axis 
The axis of the object that has to be aligned with the 
forward direction of the path (i.e. tangent to the curve at 
the owner’s position). 


Up Axis 
The axis of the object that has to be aligned (as much as 
possible) with the world Z axis. In fact, with this option 
activated, the behavior of the owner shares some 
properties with the one caused by a Locked Track 
constraint, with the path as “axle”, and the world Z axis 
as “magnet”. 


Fixed Position 
Object will stay locked to a single point somewhere along 
the length of the curve regardless of time. 


Curve Radius 
Objects scaled by the curve radius. See Curve Editing. 


Follow Curve 
If this option is not activated, the owner’s rotation is not 
modified by the curve; otherwise, it is affected 
depending on the Forward and Up Axes. 


Animate Path 
Adds an F-Curve with options for the start and end frame. 
ToDo: from above. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Pivot Constraint 


The Pivot constraint allows the owner to rotate around a 
target object. It was originally intended for pivot joints found 
in humans e.g. fingers, feet, elbows, etc. 


Options 


Target 


¥ Use Relative Offset 


Pivot Point X Om 


Om 


Om 


Rotation Range X Rotation 


Influence 1.000 


Pivot panel. 


Target 


Data ID for the selection of the object to be used as a 


pivot point. See common constraint properties for more 
information. 


Use Relative Offset 


Offset will be an absolute point in space instead of 
relative to the target. 


Pivot Point X, Y, Z 
Offset of pivot from target. 


Rotation Range 
Rotation range on which pivoting should occur. 


Always 
Use the pivot point in every rotation. 


-X/-Y/-Z/X/Y/Z Rotation 
Use the pivot point in the corresponding direction 
around the corresponding axis. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Example 


Shrinkwrap Constraint 


The Shrinkwrap constraint is the “object counterpart” of the 
Shrinkwrap Modifier. It moves the owner origin and 
therefore the owner object’s location to the surface of its 
target. 


This implies that the target must have a surface. In fact, the 
constraint is even more selective, as it can only use meshes 
as targets. Hence, the Shrinkwrap option is only shown in 
the Add Constraint to Active Object menu, Ctrl-Alt-c, (or its 
bone’s equivalent), when the selected inactive object is a 
mesh. 


Options 


Shrinkwrap 
Target @ 
Distance Om 


Mode Nearest Surface Point 


Snap Mode On Surface 


Align to Normal 


Influence 


Shrinkwrap panel. 


Target 
Data ID used to select the constraint’s target, which must 
be a mesh object, and is not functional (red state) when 
it has none. See common constraint properties for more 
information. 


Distance 
This number field controls the offset of the owner from 
the shrunk computed position on the target’s surface. 


Influence 
Controls the percentage of affect the constraint has on 
the object. See common constraint properties for more 
information. 


Mode 


This selector allows you to select which method to use to 
compute the point on the target’s surface to which to move 
the owner’s origin. You have these options: 


Nearest Surface Point 


The chosen target’s surface’s point will be the nearest one 
to the original owner’s location. This is the default and most 
commonly useful option. 


Projection 


The target’s surface point is determined by projecting the 
owner’s origin along a given axis. 


Project Axis 
This axis is controlled by the radio buttons that show up 
when you select this type. This mean the projection axis 
can only be aligned with one of the three axes, or their 
opposites. When the projection of the owner’s origin 
along the selected direction does not hit the target’s 
surface, the owner’s location is left unchanged. 


PX, AY 42,222 


Space 
Coordinate space in which the axis direction is specified. 


Distance 
Distance cutoff after which projection is assumed to have 
failed, leaving the location unchanged. 


Project Opposite 
In addition to the selected projection axis, project in the 
opposite direction and choose the closest hit. 


Face Cull 
This radio button allows you to prevent any projection 
over the “front side” (respectively the “back side”) of the 
target’s faces. The “side” of a face is determined by its 
normal (front being the side “from where” the normal 
“originates”). 


Off, Front, Back 


Invert Cull 
When used with Project Opposite and Face Culling, it 
inverts the Front or Back cull choice for the opposite 
direction. 


Nearest Vertex 
This method is very similar to the Nearest Surface Point one, 
except that the owner’s possible shrink locations are limited 


to the target’s vertices. 


This method doesn’t support the Snap Mode setting 
described below. 


Target Normal Projection 


This method is similar to Nearest Surface Point, but 
produces a much smoother projection in return for being 
significantly slower. 


Instead of finding the closest point, it searches for the 
nearest point that has its interpolated smooth normal 
pointing towards or away from the original owner position. 
Non-manifold boundary edges are specially handled as 
infinitely thin cylinders that emit normals in all 
perpendicular directions. Ignores flat shading and auto 
smooth settings. 


Snap Mode 


Most Shrinkwrap types support an additional setting to 
control how the owner is moved to the target point selected 
by the methods described above. Some of the choices only 
differ if Distance is not zero. 


On Surface 
The owner location is always changed. The offset is 
applied along the projection line connecting the original 
owner location and selected target point towards the 
Original position. 


Outside Surface 
Like On Surface, but the offset is always applied towards 
the outside of the target. 


Above Surface 
Like On Surface, but the offset is applied along the 
smooth normal of the target. 


Inside 
The owner is not moved if it is already inside the target. 
Offset shrinks the allowed volume towards the inside 


along the projection line. 


Outside 
The owner is not moved if it is already outside the target. 
Offset expands the exclusion volume towards the outside 
along the projection line. 


The Inside and Outside options can be used for very crude 
collision detection. The inside vs outside determination is 

done based on the target normal and is not always stable 

near 90 degree and sharper angles in the target mesh. 


Align To Normal 


Whenever Snap Mode is available, it is also possible to align 
the specified local axis of the object to the smooth normal of 
the target at the selected point. The axis is selected via 
radio buttons. 


The alignment is performed via smallest rotation, like in 
Damped Track constraint. 


Example 


Actions 


When animating objects and properties in Blender, Actions 
record and contain the data. As everything else in Blender, 
Actions are data-blocks. 


Actions are added to the Scene or Object. 
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So when you animate an object by changing its location with 
keyframes, the animation is saved to the Action. 


Each property has a channel which it is recorded to, for 
example, Cube. location.x is recorded to Channel X Location. 
The X location and Y location properties can be shared 
across multiple objects, if all objects have X location and Y 
location properties beneath them. 


75 


Graph Editor. Each channel has an F-Curve 
represented by the lines between the keyframes. 


Actions 
Record and contain animation data. 


Groups 
Are groups of channels. 


Channels 
Record properties. 


F-Curves 
F-Curves are used to interpolate the difference between 
the keyframes. 


Keyframes 
Keyframes are used to set the values of properties bound 
to a point in time. 


Working with Actions 


When you first animate an Hime CameraAction 2 00x 
object by adding keyframes, CameraAction 

Blender creates an Action to CircleAction 

record the data. pects a 


Actions can be managed with 
the Action data-block menu 
in the Dope Sheet Action 
Editor header, or the Sidebar 
region of the NLA Editor. 


If you are making multiple 
actions for the same object, 


press the shield button for The Action data-block menu. 


each action. This will give the 
actions a Fake User and will 
make Blender save the unlinked actions. 


Objects can only use one Action at a time for editing. The 
NLA Editor is used to blend multiple actions together. 


Properties 


Action 


one 
© Action 


¥ Manual Frame Range 
Start 1 


¥ Cyclic Animation 


Actions with and without a Manual Frame Range in 
Dope Sheet. 


It is possible to manually specify the intended useful frame 
range of an action via a panel available in the Dope Sheet or 
the NLA Editor when a channel or NLA track is selected. 


Manual Frame Range 
Manually specify the intended playback frame range for 
the action (this range is used by some tools, but does not 
affect animation evaluation). The manual frame range 
feature can be toggled with the checkbox. 


When the range is set, it is used instead of the actual 
range occupied by key frames when adding a new track 
based on the action to NLA. It can also be used by 
exporters to determine the range of frames to export. 


The range is displayed in the background of the editor as 
diagonal hash fill, to distinguish it from the solid fill of the 
current playback range. 


The frame values are most commonly expected to be 
integers, but can be fractional. 


Cyclic Animation 


Specifies that the action is intended to be cyclic over the 
specified range. The first and last frames of the range 
should represent the same pose of the cycle one loop 


apart, i.e. the range should include the duplicated initial 
key of the loop. 


Note 


This option signifies intent and does not make the 
action cycle on its own. However, if Cycle-Aware Keying, 
is enabled, it will automatically enable cyclic 


extrapolation and set up the loop period for curves 
newly added to the action. 


Custom Properties 


Create and manage your own properties to store data in the 
action’s data block. See the Custom Properties page for 
more information. 
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Introduction 


Drivers are a way to control values of properties by means 
of a function, or a mathematical expression. 


Effectively, drivers consist of: 


¢ A driver configuration that specifies zero, one, or 
more input values using other properties or object 
transformation channels, and combines them using a 
predefined mathematical function or a custom Python 
expression. 

e An animation F-Curve that maps the output of the 
driver configuration to the final value to apply to the 
driven property. 


As an example, the rotation of Object 1 can be controlled by 
the scale of Object 2. It is then said that the scale of Object 
2 drives the rotation of Object 1. 


Not only can drivers directly set the value of a property to 
the value of a different one, they can also combine multiple 
values using a fixed function or a Python expression and 
further modulate it with a manually defined curve and/or a 
modifier stack. 


Drivers are an extremely powerful tool for building rigs and 
are typically used to drive bone transforms and the 
influence of shape keys, action constraints and modifiers, 
often using custom properties as inputs. 


Graph View 


The main area of the 
Drivers editor shows an 
F-Curve that represents 
the driver function. 


The X axis maps to the 
output value of the 
driver configuration. The 


ates depend on the Driver curve in the Drivers editor. 
setup. 


The Y axis shows the 
value applied to the target property. The units depend on 
the property. 


In the example image, if the driver value is 2.0 the property 
value will be 0.5. 


The default F-Curve is an identity map, i.e. the value 
produced by the driver configuration is applied to the driven 
property unchanged. If the driver output value is 2.0, the 
property will be 2.0. 


The driver function can be defined artistically with Bézier 
curve handles or mathematically with trigonometric 
functions or polynomial expressions such as \(y = a + bx\). 
Furthermore, the function can also be procedurally 
modulated with noise or cyclic repetitions. See Modifiers for 
more details. 


Driver Configuration 


The Drivers panel shows the setup for a driver. 


A driver can have zero, one, or more variables. Variables 
specify which properties, object transformation channels, or 


relative distances between objects, are used as inputs by 
the driver. 


The driver type determines how the variables are used. The 
type can be: 


e a built-in function: for example, the sum of the 
variables’ values, or 

e a scripted expression: an arbitrary Python expression 
that refers to the variables by their names. 


This driver configuration outputs a single value which 
changes when the variables change. This value is then 
evaluated through the driver function curve to produce the 
result to be applied to the driven property. 


Notes on Scripted Expressions 


When a driver uses a Scripted Expression, Blender can 
evaluate it without using the fully featured Python 
interpreter if it is simple enough. This means that drivers 
are fast to evaluate with simple divisions, additions and 
other “simple” expressions. The built-in functions are always 
evaluated natively. 


See Simple Expressions for a comprehensive list of 
expressions that can be evaluated natively. 


When the expression is not simple, it will be evaluated using 
Python. As a consequence, the driver will be slower and 
there is a security risk if the author of the Python code is 
unknown. This is an important thing to take into 
consideration for heavy scenes and when sharing files with 
other people. See also: Auto run. 


Usage 


Drivers can be added to properties via their context menu, a 
Shortcut, copy-pasted, or by typing an expression directly 
into the property’s value. 


After adding drivers, they are usually modified in the Drivers 


editor, or via a simplified Edit Driver popover invoked from 
the property context menu. 


Add Driver 


Reference 
Menu: Context menu » Add Driver 
Shortcut: Ctrl-D 


The usual way to add a driver to a property is to RMB click a 
property, then choose Add Driver in the context menu. 
Drivers can also be added by pressing Ctrl-D with the mouse 
over the property. 


This operation adds a driver with a single variable (which 
needs to be filled in), and displays the Edit Driver popover. 


Edit Driver 


Reference 


Menu: Context menu » Edit Driver 


Displays a popover window that allows editing the custom 
expression and input variables of the driver without opening 
the full Drivers Editor. 


Many drivers don’t use their F-Curve component, so this 
reduced interface is sufficient. 


Open Drivers Editor 


Reference 


Menu: Context menu » Open Drivers Editor 


Opens a new window with the Drivers Editor and selects the 
driver associated with the property. 


Copy & Paste 


Reference 
Menu: Context menu » Copy Driver 
Menu: Context menu >» Paste Driver 


Drivers can be copied and pasted via the context menu. 
When adding drivers with the same settings, this can save 
time modifying settings. 


Copy As New Driver 


Reference 


Menu: Context menu > Copy As New Driver 


A driver that sets the property value to the value of a 
different property can be quickly created by using the Copy 
As New Driver context menu option of the input property, 
and then pasting the result onto the output property via 
Paste Driver. 


It is also possible to add the new driver variable to an 
existing driver using the Paste Driver Variables button in the 
editor panel. 


Expression 


This is a quick way to add drivers with a scripted expression. 
First click the property you want to add a driver to, then 
type a hash # and a scripted expression. 


Some examples: 


e #frame 

e #frame / 20.0 
e #sin(frame) 

e #cos(frame) 


Removing Drivers 


Reference 

Menu: Context menu > Delete Driver(s) 
Menu: Context menu » Delete Single Driver 
Shortcut: Ctrl-Alt-D 


Removes driver(s) associated with the property, either for 
the single selected property or sub-channel, or all 
components of a vector. 


Drivers Panel 


Reference Driven Pronerts 
Editor: 
Driver Settings 
Sum Values 
+ Add Input Variable g AK 
(x)¥ var 
Object:  Camer 
Type X Location 
Space: World Space 
Value 5.000 
Update Dependencies 
Show in Drivers Editor 
Edit Driver popover. 
Graph editor 
Mode: Drivers 
Panel: Sidebar region >» Drivers 
Shortcut: N 
Reference 
Menu: Context menu » Edit Driver 


Shortcut: Ctrl-D 


This panel is visible in Sidebar of the Drivers Editor or asa 
popover when adding a driver to a property. 


It shows the property that is being driven, followed by a 
series of settings that determine how the driver works. 


Driver Settings 


Type 
There are two categories of drivers: 
e Built-in functions (Average, Sum, Min and Max) 


The driven property will have the value of the average, 
sum, lowest or highest (respectively) of the values of 
the referenced Driver Variables. If there is only one 
driver variable, these functions will yield the same 
result. 


Custom (Scripted Expression). 


An arbitrary Python expression that can refer to the 
Driver Variables by name. See Expressions. 


Driver Value 


The current result of the driver setup. Useful for debug 
purposes. 


Variables 


See Driver Variables. 


Update Dependencies 


Forces an update for the Driver Value dependencies. 


Show tn Drivers Editor 


Opens the fully featured Drivers Editor. This button only 
appears in the popover version of the Drivers panel. 


Driver Variables 


Variables are references to properties, transformation 
channels, or the result of a comparison between 
transformations of two objects. 


Drivers should access object data via Driver Variables, 
rather than direct references in the Python expression, in 
order for dependencies to be correctly tracked. 


Add Input Variable 


Adds a new Driver Variable. 


Add, Copy, Paste buttons. 
Copy/Paste Variables py U 


Copies the current variable 
list so it can be pasted into 
another driver’s variable list. 


Single Transform 
property. channel. Distance. 


Name 
Name for use in scripted expressions. The name must 
start with a letter, and only contain letters, digits, or 
underscores. 


Variable Type 
The type of variable to use. 


Single Property 
Retrieves the value of an RNA property, specified by a 
data-block reference and a path String. 


In case of transform properties, this will return the 
exact value of the UI property, while Transform 
Channel will take parenting and/or constraints into 
account as needed. 


See also Custom Properties. 


ID Type 
The ID-block type. For example: Key, Image, 
Object, Material. 


ID 
The ID of the ID-block type. For example: 
“Material.0O1”. 


RNA Path 
The RNA name of the property, based on a subset 
of Python attribute access syntax. For example: 
location.x Or location[0] for the raw X location 
value, Or ["prop_name"] for a custom property. 


Tip 


The easiest way to create a variable of this type is to 
use the Copy As New Driver context menu option of 
the input property, and paste the result into the 
driver via Paste Driver Variables. 


Transform Channel 
Retrieves the value of a Transform channel from an 
object or bone. 


ID 
ID of the object. For example: Cube, Armature, 
Camera. 
Bone 
ID of the Armature bone. For example: “Bone”, 
“Bone.002”, “Arm.r”. This option is for armatures. 
Type 


For example, X Location, X Rotation, X Scale. 


The Average Scale option retrieves the combined 
scale value, computed as the cubic root of the total 
change in volume. Unlike X/Y/Z Scale, this value 
can be negative if the object is flipped by negative 
scaling. 


Mode (Rotation) 
For rotation channels, specifies the type of rotation 
data to use, including different explicit Euler 
orders. Defaults to using the Euler order of the 
target. See Rotation Channel Modes. 


Space 
World Space, Transform Space, Local Space. 


Rotational Difference 
Provides the value of the rotational difference 
between two objects or bones, in radians. 


Distance 
Provides the value of the distance between two 
objects or bones. 


Value 
Shows the value of the variable. 


Rotation Channel Modes 


Rotation Transform Channels support a number of operation 
modes, including: 


Auto Euler 
Uses the Euler order of the target to decompose rotation 
into channels. 


XYZ Euler, ... 
Explicitly specifies the Euler rotation order to use. 


Quaternion 
Provides the Quaternion representation of the rotation. 


Swing and X/Y/Z Twist 
Decomposes the rotation into two parts: a Swing rotation 
that aims the specified axis in its final direction, followed 
by a Iwist rotation around that axis. This is often 
necessary for driving corrective Shape Keys and bones 
for organic joint rotation. 


This decomposition is often produced in rigs by using a 
helper bone with a Damped Track Constraint to extract 


the swing part, and its child with Copy Transforms to 
extract the twist component. 


The channels values for Swing and Y Twist are: 


Y Rotation oe 
True angle of the KK 
twist rotation. 4 


W Rotation { 
True angle of the - 
swing rotation, 
independent of its ‘ 
direction. xe 


X Rotation, Z 
Rotation Falloff curves for weighted angles. 
Weighted angles 
that represent the 
amount of swing around the X/Z axis. 


The magnitude of the angle equals W Rotation when 
the rotation is purely around that axis, and fades out 
to zero as the direction changes toward the other axis, 
following the falloff curves from the graph on the 
right. 


Mathematically, the swing angles are computed from 
quaternion components, using \(2 \arccos(w)\) for W and \ 
(2 \arcsin(x)\) etc. for the others. The component of the 
swing rotation that corresponds to the twist axis is 
always O, and is replaced by the twist angle. 


Expressions 


Expression 
A text field where you can enter an arbitrary Python 
expression that refers to Driver Variables by their names. 


The expression has access to a set of standard constants 
and math functions from math, bl_math and other modules, 
provided in the Driver Namespace. For an example of 
adding a custom function to the namespace, see the 
driver namespace example. 


For performance reasons it is best to use the Simple 
Expressions subset as much as possible. 


Use Self 
If this option is enabled, the variable self can be used for 
drivers to reference their own data. Useful for objects 
and bones to avoid having creating a Driver Variable 
pointing to itself. 


Example: self.location.x applied to the Y rotation 
property of the same object will make the object tumble 
when moving. 


Note that dependencies for properties accessed via self 
may not be fully tracked. 


Simple Expressions 


Blender can evaluate a useful subset of Python driver 
expressions directly, which significantly improves 
performance, especially on multi-core systems. To take 
advantage of this, the driver expression must only use the 
following features: 


Variable Names 
Use only ASCII characters. 


Literals 
Floating-point and decimal integer. 


Globals 


frame 


Constants 
pi, True, False 


Operators 
+, -, *, /, ==, !=, <, <=, >, >=, and, or, not, Conditional 
operator/ ternary if 


Standard Functions 
min, max, radians, degrees, abs, fabs, floor, ceil, trunc, round, 
int, sin, cos, tan, asin, acos, atan, atan2, exp, log, sqrt, pow, 
fmod 


Blender Provided Functions 
lerp, clamp, smoothstep 


Simple expressions are evaluated even when Python script 
execution is disabled. 


When an expression outside of this subset is used, Blender 
displays a “Slow Python expression” warning. However, as 
long as the majority of drivers use simple expressions, using 
a complex expression in select few is OK. 


See also 


e Extending Blender with Python. 
e Python and its documentation. 


e functions.wolfram.com. 


Workflow & Examples 


Simple Drivers can be configured from the pop-over that 
appears when adding a new Driver. When adding multiple 
Drivers or for more advanced configurations, it is useful to 
have open the Drivers Editor. 


Transform Driver 


Control a property with an object’s transform. In this 
example, the Y rotation of Object 2 will be driven by the X 
position of Object 1. Starting from a simple setup with two 
objects: 


1. Add a Driver to the Rotation Y property of the second 
object via the context menu or with ctr1-D. 


2. Open the Drivers Editor and select the Y Euler Rotation 
property in the channels region. 


3. Open the Sidebar region and select the Drivers tab. 


4. Configure the driver to be the Averaged Value of a 
Transform Channel of the first object. 


5. Experiment with moving the first object and notice how 
it affects the Y rotation of the second object. 


Scripted Expression - Orbit a 
Point 


Orbit an object’s position around a point with a custom 
Scripted Expression. The object’s position will change when 
scrubbing the timeline. Using trigonometry, circular motion 
can be defined in 2D using the sine and cosine functions. 
(See Unit Circle.) In this example, the current frame is used 
as the variable that induces the motion. frame is a Simple 
Expression that corresponds to 
bpy.context.scene.frame current. 
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0 + (sin(frame / 8) * 4) 
Use Self 


Add Input Variable AK 
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. Add a driver to the X Location property. 
1. Set the Driver Type to Scripted Expression. 
2. Add the expression 0 + (sin(frame / 8) * 4), where: 
= frame/8 : is the current frame of the animation, 
divided by 8 to slow the orbit down. 
= (sin( )*4) : multiplies the result of sin(frame/s) 
by 4 for a bigger circle. 
=» 9 +: iS used to control the offset to the orbit 
center point. 
2. Add a driver to the Y Location property with the 
expression 0 + (cos(frame / 8) * 4). 
3. Scrub the timeline to see the effect. Experiment with 
the variables to control the size and center of the orbit. 


Custom Function - Square Value 


Create a custom function to get the square of a value (i.e. 
value2). Adding the function to the Driver Namespace allows 
it to be used from driver expressions. The Driver Namespace 
has a list of built-in functions for use in driver expressions, 
as well as constants such as m1 and e. These can be 
inspected via the Python Console: 


>>> bpy.app.driver namespace[' <tab> 
acos'] 
acosh' ] 
asin'] 
asinh' ] 
atan' ] 


To add a new function to the Driver Namespace, the function 
itself needs to be implemented and then added to the 
bpy.app.driver_ namespace. 


1. Add the following to the Text Editor inside Blender and 
press Run Script. 


import bpy 
def square(val): 
"""Returns the square of the given value""" 


return val * val 


# Add function to driver namespace. 
bpy.app.driver_ namespace['square'] = square 


2. Add a driver with a Scripted Expression such as 
square(frame). 


3. Observe the effect when scrubbing the timeline. 


There are more custom function examples available in 
Blender’s Text Editor Templates >» Python » Driver Functions. 
Since Simple Expressions cannot access custom functions, 
using them only makes sense for complex computations. 


Shape Key Drivers 


Improved Mesh Deformation 


Fix intersection problems that happen when using armatures 
and weight painting, especially at joints. Shape keys can 
also be used to tweak and refine a rig, for example to 
suggest muscle formations. In this example, a shape key is 
used to improve the deformation at the elbow of a 
rudimentary arm. 


Left: Skeletal mesh deformation without correction. 
Right: Corrective shape key applied 


Setup 

1. Add a mesh (in this example, a cylinder with loop 

cuts). 

2. Add an armature with a chain of bones. 

3. Skin the mesh to the armature using weight painting. 
(Note: to parent the mesh to the armature: select the 
mesh first, then the armature and use ctri-P to parent 
with auto weights.) 


Experiment with posing the armature and observe the 
deformation at the joint. To fix intersection problems or 
angles that look unsatisfactory, you can associate a Shape 
Key with a pose. 


Shape Key 
1. Pose the armature such that the problems are visible. 
Be sure to cover the extreme poses that you want to 
support for the rig. 


2. With the mesh selected, add a new Shape Key in 
addition to the Basis key. Properties » Mesh tab » 
Shape Keys 

3. In order to author the shape key on top of the 
armature deformation, enable both Edit Mode Display 
and Cage Editing in the Armature modifier. Properties 
>» Modifiers tab » Armature Modifier » Header 

4. Enter Edit Mode and select the new shape key in the 
properties panel. Adjust the vertices as desired. 
Select the Basis key to toggle between the original 
mesh and your edits. (Note: be careful to apply edits 
only to your shape and not to the original mesh or 
other existing keys.) 


Once you are satisfied with how the deformation looks for 
the problematic pose, you’ll need to configure a driver to 
activate the shape smoothly when entering that position. 


Driver 
1. Add a driver to the Value of the shape key you’ve 
created. 
2. Open the Drivers Editor and select the driver. 
Method 1 - Direct mapping to a bone rotation value 

A simple way to configure the driver is with a direct 
correspondence of the value of a bone’s rotation 
channel to the shape key activation Value. This 
method has the disadvantage of relying on a single 
channel of a bone’s rotation which might be 
insufficient to precisely express the condition under 
which the shape key should be activated. 


1. In the Drivers tab, select the Averaged Value of 
the rotation of the bone you are posing. 


Understand the rotation axis that you are 
interested in by enabling axes display in the 


armature or by observing the bone’s transform 
values in the Properties. 


Select the rotation channel and set it to local, 
meaning, the bone’s rotation value relative to its 
parent bone. 


2. Manually set points in the driver curve by 
selecting a handle and dragging it or inserting 
values in the F-Curve tab. The Y axis represents 
the shape key Value, which should go from 0.0 to 
1.0. The X axis is usually the frame, but for this 
driver it represents the rotation value in radians. 
You can have more than two points in the curve 
and tweak the transitions with the handles in the 
curve view (G to move). 


3. To verify that the driver behaves correctly, 
deselect the option to only show drivers for 
selected objects. This way, you can pose the 
armature and keep an eye on the driver. 


Method 2 - Rotational difference to a target bone 
This method requires an additional target or corrective 
bone, but it better expresses the spatial condition in 
3D space of the bone that is causing the problem. 


1. In armature Edit Mode, add a new bone extruded 
from Bone 1, in the position at which Bone 2 
should have the shape key active. This type of 
bones usually follow a naming convention such as 
“TAR-” (target) or “COR-” (corrective). 


2. In the Drivers tab, select the Averaged Value of 
the rotational difference between the bone you 
are rotating and the target bone. A rotational 
difference is the minimum angle between two 
objects in World Space. It is therefore important 
that the bones have the same root, so that the 
only thing affecting the angle between the bones 
is the rotation of one of them. When the 
deformation bone (Bone 2) reaches the target 
rotation (TAR-Bone 2) the rotational difference will 
be 0°. 


A ype: Averaged Value 
driver Value 1.719 
Bone 1 P 
~ i Add Input Variable 
ey 
S , 
‘ 
> 


Object 1: Mj Armature 
~. Bone 2 

Object 2: | Armature 
x. TAR-Bone 2 


Value: 1.719 (98.5°) 


3. Manually adjust the driver curve handles so that 
the shape key Value (Y axis) is 1.0 when the 
rotational difference (X axis) is 0°. The Value 
should be 0.0 when the arm is extended, at which 
point the rotational difference should be around 
90° or more (in radians). 


4. See the steps in Method 1 on how to adjust the 
curve handles and confirm that the functionality is 


working. Pose the armature to verify that the 
ranges are correct. 


Chained Relative Shape Keys 


Activate different shape keys in succession. In this example, 
moving a single bone will activate first Key 1 and then Key 
2. See also relative shape keys mix additively. 


Shape Keys 
Add two shape keys to a mesh, besides the Basis. 


ie 
Key 1: top Key 2: 
faces inner top 
moved up moved up 
by 1m. by 1m. 


Drivers 
Add an armature with a single bone to control the shape 
keys. The goal is to activate the keys in succession as 
this bone moves up. 


As shown in the picture above, when the bone is halfway 
up, both Key 1 and Key 2 have an influence. It is a matter 
of preference if Key 1 should be at its maximum Value 
before Key 2 starts to become active, or how much they 
should overlap. This example shows a seamless blend. 


For a seamless blend where there is overlap, Key 1 
Should have a Value of 0.0 when the bone is at the 
bottom and increase linearly to 1.0 until the bone is past 
the midpoint height. Key 2 should have a value of 0.0 
before the midpoint height and then increase at the 
same rate than Key 1 until reaching Va/ue 1.0 when the 
bone is at maximum height. 


1. Add a driver to the Value of Key 1 and Key 2. In the 
Drivers tab, configure both drivers to be the 
Averaged Value of a variable with the bone’s Z 
location. 


2. Determine the range of the bone’s motion in the 
World Z axis by moving it up so that it is aligned with 
the top of the mesh when both keys are active. Here 
we will use [0.0, 2.5]. 


3. Configure the driver functions so that the Value of 
the shape keys (Y axis) is as desired for the bone’s 
height (X axis). 


The driver functions should be linear, therefore, they 
can be defined analytically with a function of type \(y 
= a+ bx\), where \(a\) is an offset in \(y\) and \(b\) is 
the slope. 


1. In the Modifiers tab, add a Generator of type 
Extended Polynomial for both drivers. 


2. Play with the values of \(a\) and \(b\) so that the 
curves go from [0.0, 1.0] in the Y axis and from 
[0.0, 2.5] in the X axis. The curves should overlap 
in the mid area of the X axis and they should 
have the same slope (\(b\)). 


Possible values are Key 1: \(y = 0.0 + 0.6x\) and 
Key 2: \(y = -0.5 + 0.6x\). 


Note that the functions go outside the range [0.0, 
1.0] for the shape keys’ Value, but that has no 
effect because Value is clamped in a Range in 
the Shape Keys panel. 


Troubleshooting 


Some common problems people may run into when using 
drivers. 


Scripted Expression 


Type Scripted Expression 


Driver Value 0.000 


Expression 
[O}[0} 
Use Self 


A Python restricted for security 


A security warning in the Drivers panel. 


1 scripts in this fil 


Permanent! llov 


Allow Execution Ignore 


An Auto-run warning in the Info editor’s header. 
By default Blender will restrict execution of Python scripts. 


If using a Scripted Expression Driver Type that doesn’t follow 
the Simple Expressions subset, you will have to open the file 


as Trusted Source, or set Auto Run Python Scripts in 
Preferences > Save & Load > Blender Files. 


Y Open Blender File 
Auto Run Python Scripts 


¥ Load UI 


Trusted Source 


The Trusted 


Source 

checkbox in The Auto Run Python 
the File Scripts checkbox in the 
Browser. Preferences. 


Rotational Properties are 
Radians 
Parts of the User Interface may use different units of 


measurements for angles, rotation. In the Graph Editor, 
while working with Drivers, all angles are Radians. 


Markers 


Markers are used to denote frames with key points or 
significant events within an animation. E.g. it could be that a 
character’s animation starts, the camera changes position, 
or a door opens. Markers can be given names to make them 
more meaningful at a quick glance. They are available in 
many of Blender’s editors. 


Note 


Unlike keyframes, markers are always placed at a whole 
frame number, you cannot set a marker at frame 2.5. 


Markers can be created and edited in the following editors: 


Graph Editor 

Dope Sheet 

NLA Editor 

Video Sequence Editor 
Timeline 


Note 


A marker created in one of these editors will also appear in 
all others that support them. 


Types 


Besides standard markers, pose markers are another type of 
markers, which are specific to armatures and shape keys. 


They are used to denote poses in the Action Editor mode 
and Shape Keys Editor of Dope Sheet. 


Visualization 


In the supported editors, if at least one is created, markers 
are visualized in a separate row at their bottom. This area 
can be disabled per editor via the View » Show Markers 
menu option. 


Note 


While the markers area is disabled, markers operators are 
not available in that editor, and in the header the Marker 
menu is hidden. 


Standard 


Regular markers are shown as small 
white triangles, empty if unselected or 
filled if selected, and with a dashed line 
that covers the editor height at the 
corresponding frame. If they have a 
name, this is shown to their right in 
white. 


3D Viewport 


The 3D Viewport does not allow you 22 |W Object Mode v View 
to create, edit or remove markers, but (se? FOrspactiv 
it shows their name in the Object Info (15) Collection | Cube <Mark1> 


in the upper left corner, when on their 
frame. 


Pose Markers 


Pose markers show a diamond-shaped icon 
in the Dope Sheet. In the NLA editor pose 
markers are shown as a red dashed line 
inside the relative action strip. 


Add Marker 


Reference 

Mode: All modes 

Menu: Marker >» Add Marker 
Shortcut: M 


The simplest way to add a marker is to move to the frame 
where you would like it to appear, and press M. 


Hint 


Markers can also be added during playback. 


Pose Markers 


If Show Pose Markers is checked, a pose marker and a new 
pose in the Old Pose Library are added. 


Selecting 


Reference 


Mode: All modes 
Shortcut: LMB 


Click LMB on the marker’s triangle to select it. Use Shift-LMB 
to select multiple markers. 


In the Graph Editor, Dope Sheet, NLA Editor, Timeline, and 
Video Sequence Editor, you can also select all markers with 
A while hovering the mouse over the marker row, and apply 
selection tools on them like Box Select, etc. (as usual, LMB to 
select, RMB to deselect). The corresponding options are found 
in the Select menu of these editors. 


Editing 


Duplicate Marker 


Reference 

Mode: All modes 

Menu: Marker > Duplicate Marker 
Shortcut: Shift-D 


You can duplicate the selected markers by pressing Shift-D. 
Once duplicated, the new ones are automatically placed in 
select mode, so you can move them to the desired location. 


Note 


Note that unlike most other duplications in Blender, the 
names of the duplicated markers are not altered at all (no 
.001 NUMeric Counter append). 


Duplicate Marker to Scene 


Reference 
Mode: All modes 
Menu: Marker >» Duplicate Marker to Scene... 


Duplicates the selected markers into another scene. 


Delete Marker 


Reference 

Mode: All modes 

Menu: Marker >» Delete Marker 
Shortcut: X 


To delete the selected markers simply press x, and confirm 
the pop-up message with Le. 


Rename Marker 


Reference 

Mode: All modes 

Menu: Marker >» Rename Marker 
Shortcut: F2 


Having dozens of markers scattered throughout your 
scene’s time will not help you much unless you know what 
they stand for. You can name a marker by selecting it, 
pressing F2, typing the name, and press Return 


Move Marker 


Reference 

Mode: All modes 

Menu: Marker >» Move Marker 
Shortcut: G 


Once you have one or more markers selected, press G, while 
hovering with the mouse over the marker bar, to move 
them, and confirm the move with LB or Return (as usual, 
cancel the move with RMB, or Esc). Or drag them with the LB. 


By default, you move the markers in one-frame steps, but if 
you hold ctri, the markers will move in steps corresponding 
to 1 second (according to the scene’s FPS). 


Select 

Reference 

Mode: All modes 
Menu: Marker » Select 


Convenient operators for selecting Marks; see Selecting for 
more information on selecting Markers. 


All A 
Selects all Markers. 


None Ctrl-A 
Un-selects any already selected Markers. 


Invert Ctrl-I 


Select all un-selected Markers and unselects all selected 
Markers. 


Before Current Frame 
Selects all Markers to the left of the current frame and 
the Marker on the current frame if it exists. 


After Current Frame 
Selects all Markers to the Right of the current frame and 
the Marker on the current frame if it exists. 


Show Pose Markers 


Reference 

Editor: Dope Sheet 

Mode: Action Editor or Shape Keys Editor mode 
Menu: Marker >» Show Pose Markers 


Shows markers belonging to the active action instead of 
scene markers. 


Make Markers Local 


Reference 
Mode: All modes 
Menu: Marker » Make Markers Local 


It is possible to convert standard markers into pose markers 
with Marker » Make Markers Local. Note that the original 
marker will be gone. If you want to keep it, make a duplicate 
before you convert. 


Jump to Next/Previous Marker 


Reference 
Mode: All modes 
Menu: Marker >» Jump to Next/Previous Marker 


Moves the Playhead to the next/previous marker relative to 
the current frame. 


Bind Camera to Markers 


Reference 

Editor: Timeline 

Menu: Marker >» Bind Camera to Markers 
Shortcut: Ctrl-B 


Bind Camera to Markers is a special operator only available 
in the Timeline. The operator allows markers to be used to 
set the active object as the active camera. 


To use this operator, select the object to become the active 
camera and select a marker to bind the active camera to. If 
no marker is selected when the operator is applied, a 
marker will be added. When an object is bound to a marker, 
the marker will be renamed to the name of the active 
object. These markers also have a camera icon next to the 
left of the name to easily distinguish them from other 
informative markers. 


These markers can be moved to change the frame at which 
the active camera is changed to the object the marker is 
bound to. 


Shape Keys 


e Introduction 
o Workflow 
o Relative or Absolute Shape Keys 
Shape Keys Panel 
o Relative Shape Keys 
o Absolute Shape Keys 
e Workflow 
o Relative Shape Keys 
o Absolute Shape Keys 


Introduction 


Shape keys are used to deform objects into new shapes for 
animation. In other terminology, shape keys may be called 
“morph targets” or “blend shapes”. 


The most popular use cases for shape keys are in character 
facial animation and in tweaking and refining a skeletal rig. 
They are particularly useful for modeling organic soft parts 
and muscles where there is a need for more control over the 
resulting shape than what can be achieved with 
combination of rotation and scale. 


Shape keys can be applied on object types with vertices like 
mesh, curve, surface and lattice. 


> >_> 


Example of a mesh with different shape keys 
applied. 


Workflow 


Shape keys are authored in the Shape Keys panel which is 
accessed in the Object Data tab of the Properties (e.g. the 


Mesh tab for mesh objects). 


A shape key is modified by first selecting a shape key in the 
panel, and then moving the object’s vertices to a new 
position in the 3D Viewport. 


The panel has controls for affecting the current Value 
(influence, weight) of a shape. It is possible to see a shape 
in isolation or how it combines with others. 


Adding and Removing Vertices 


It is not possible to add or remove vertices in a shape key. 
The number of vertices and how they connect is specified 
by the mesh, curve, surface or lattice. A shape key merely 
records a position for each vertex and therefore shapes 
always contain all the object’s vertices. 


When adding a vertex, all shape keys will record it with the 
position in which it is created. Workflow-wise, adding and 
deleting vertices after creating shape keys is possible, but it 
is best to leave the creation of shape keys for when the 
mesh is finished or its topology is stable. 


Adding Shape Keys 


When adding a new shape key with the + button next to the 
list, the new shape will be a copy of the Basis shape, 
independently of the current result visible in the 3D 
Viewport. 


When adding a new shape key from Specials » New Shape 
from Mix, the shape will start of with the vertex 
configuration that is visible at that moment. 


When doing facial animation with relative shape keys, it can 
be useful to first create a shape key with a complex extreme 
pose (e.g. anger or surprise), and then break this complex 
shape into components by applying a temporary vertex 
group to the complex shape and creating a copy with New 
Shape from Mix. This technique helps reducing conflicts 
between different shape keys that would otherwise produce 
a double effect. 


Relative or Absolute Shape 
Keys 


A mesh (curve, surface or lattice) has a stack of shape keys. 
The stack may be of Relative or Absolute type. 


Relative 
Mainly used for muscles, limb joints, and facial 
animation. 


Each shape is defined relative to the Basis or to another 
specified shape key. 


The resulting effect visible in the 3D Viewport, also called 
Mix, is the cumulative effect of each shape with its 
current value. Starting with the Basis shape, the result is 
obtained by adding each shape’s weighted relative 
offset to its reference key. 


Value 
Represents the weight of the blend between a shape 
key and its reference key. 


A value of 0.0 denotes 100% influence of the 
reference key and 1.0 of the shape key. Blender can 


extrapolate the blend between the two shapes above 
1.0 and below 0.0. 


Basis 
Basis is the name given to the first (top-most) key in 
the stack. 


The Basis shape represents the state of the object’s 
vertices in their original position. It has no weight 
value and it is not keyable. This is the default 
Reference Key when creating other shapes. 


Absolute 
Mainly used to deform the objects into different shapes 
over time. 


Each shape defines how the object’s shape will be at 
Evaluation Time specified in its Value. 


The resulting shape, or Mix, is the interpolation of the 
previous and next shape given the current Evaluation 
Time. 


Value 
Represents the Evaluation Time at which that shape 
key will be active. 


Basis 
Basis is the name given to the first (topmost) key in 
the stack. 


The Basis shape represents the state of the object’s 
vertices in their original position. 


Shape Keys Panel 


Reference 

Editor: Properties 

Mode: All modes 

Panel: Object Data >» Shape Keys 

The Shape Keys panel is ees 

used for authoring shape (@ Basis 

keys. ® Keyl 0.000 


(@ Key2 0.000 


Active Shape Key Index 
A List View. 


¥Y Relative 


Value/Frame (number) 
In Relative mode: 
Value is the current 
influence of the shape 
key used for blending 
between the shape (value=1.0) and its reference key 
(value=0.0). The reference key is usually the Basis 
shape. The weight of the blend can be extrapolated 
above 1.0 and below 0.0. 


Shape Keys panel. 


In Absolute mode: Value is the Evaluation Time at 
which the shape will have maximum influence. 


Mute (check mark) 
If unchecked, the shape key will not be taken into 
consideration when mixing the shape key stack into 
the result visible in the 3D Viewport. 


Shape Key Specials 


New Shape from Mix 
Add a new shape key with the current deformed shape 
of the object. This differs from the + button of the list, 
as that one always copies the Basis shape 
independently of the current mix. 


Mirror Shape Key 
If your mesh is symmetrical, in Object Mode, you can 
mirror the shape keys on the X axis. This will not work 
unless the mesh vertices are perfectly symmetrical. 
Use the Mesh >» Symmetrize tool in Edit Mode. 


Mirror Shape Key (Topology) 
Same as Mirror Shape Key though it detects the 
mirrored vertices based on the topology of the mesh. 
The mesh vertices do not have to be perfectly 
symmetrical for this action to work. 


Join as Shapes (Transfer Mix) 


Transfer the current resulting shape from a different 
object. 


Select the object to copy, then the object to copy into. 
Use this action and a new shape key will be added to 
the active object with the current mix of the first 
object. 


Transfer Shape Key 
Transfer the active shape key from a different object 
regardless of its current influence. 


Select the object to copy, then the object to copy into. 
Use this action and a new shape key will be added to 
the active object with the active shape of the first 
object. 


Delete All Shape Keys 
Removes all Shape Keys and any effect that they had 
on the mesh. 


Apply All Shape Keys 
Saves the current visible shape to the mesh data and 
deletes all Shape Keys. 


Relative 
Set the shape keys to Relative or Absolute. See Relative 
or Absolute Shape Keys. 


Shape Key Lock (pin icon) 
Show the active shape in the 3D Viewport without 
blending. Shape Key Lock gets automatically enabled 
while the object is in Edit Mode. 


Shape Key Edit Mode (edit mode icon) 
If enabled, when entering Edit Mode the active shape key 
will not take maximum influence as is default. Instead, 
the current blend of shape keys will be visible and can be 
edited from that state. 


Relative Shape Keys 


See Relative or Absolute Shape Keys. 


With absolute shape keys, the value shown for each shape 
in the list represents the current weight or influence of that 
Shape in the current Mix. 


Clear Shape Keys x 
Set all influence values, or weights, to zero. Useful to 
quickly guarantee that the result shown in the 3D 
Viewport is not affected by shapes. 


Value ¥ Shape Keys 


The weight of the blend = aa 

between the shape key ® Keyl 0.000 
and its reference key (@ key2 0.000 
(usually the Basis 

shape). 


¥Y Relative 


A value of 0.0 denotes 
100% influence of the 
reference key and 1.0 of rie 

the shape key. Vertex Group &8 


Relative To 


Value 


Range Min 


Range 
Minimum and maximum 
range for the influence 
value of the active shape 
key. Blender can 
extrapolate results when the Value goes lower than 0.0 
or above 1.0. 


Relative Shape Keys options. 


Vertex Group 
Limit the active shape key deformation to a vertex group. 
Useful to break down a complex shape into components 
by assigning temporary vertex groups to the complex 
Shape and copying the result into new simpler shapes. 


Relative To 
Select the shape key to deform from. This is called the 
Reference Key for that shape. 


Absolute Shape Keys 


See Relative or Absolute Shape Keys. 


With absolute shape keys, Y Shape Keys 
the value shown for each (3) basis 
Shape in the list represents @ key 
the Evaluation Time at ® key2 
which that shape key will 
be active. 


Re-Time Shape Keys (clock Relative 

icon) Interpolati.. Linear 
Absolute shape keys are Evaluation Time: 
timed, by order in the 


list, at a constant Absolute Shape Keys options. 
interval. This button 


resets the timing for the 
keys. Useful if keys were removed or re-ordered. 


Interpolation 
Controls the interpolation between shape keys. 


Linear, Cardinal, Catmull-Rom, B-Spline 


/\ [\ [\ 1X 


Linear Cardinal Catmull-Rom BSpline 


Different types of interpolation. 


The red line represents interpolated values 
between keys (black dots). 


Evaluation Time 


Controls the shape key influence. Scrub to see the effect 
of the current configuration. Typically, this property is 
keyed for animation or rigged with a driver. 


Workflow 
Relative Shape Keys 


1. In Object Mode, add a new shape key via the Shape Key 
panel with the + button. 

2. “Basis” is the rest shape. “Key 1”, “Key 2”, etc. will be 
the new shapes. 

3. Switch to Edit Mode, select “Key 1” in the Shape Key 


panel. 

4. Deform mesh as you want (do not remove or add 
vertices). 

5. Select “Key 2”, the mesh will be changed to the rest 
shape. 


. Transform “Key 2” and keep going for other shape keys. 

. Switch back to Object Mode. 

. Set the Value for “Key 1”, “Key 2”, etc. to see the 
transformation between the shape keys. 


CON) O) 


In the figure below, from left to right shows: “Basis”, “Key 
1”, “Key 2” and mix (“Key 1” 1.0 and “Key 2” 0.8) shape keys 
in Object Mode. 


Relative shape keys example. 


For more practical examples, see how to combine shape 
keys and drivers. 


Absolute Shape Keys 


1. Add sequence of shape keys as described above for 
relative shape keys. 

. Uncheck the Relative checkbox. 

. Click the Reset Timing button. 

. Switch to Object Mode. 

. Drag Evaluation Time to see how the shapes succeed 
one to the next. 


uBWN 


¥ Shape Keys 
iL) Basis 


® Keyl 
® Key2 


Relative 


Interpolati.. Linear 


Evaluation Time: 


Absolute shape keys workflow. 


By adding a driver or setting keyframes to Evaluation Time 
you can create an animation. 


See also 


Shape Key Operators 


There are two modeling tools used to control shape keys 
and are found in Edit Mode. 


Motion Paths 


Reference 


Editor: 
Mode: 
Panel: 


Reference 


Editor: 
Mode: 
Panel: 
Menu: 


3D Viewport, Properties 

Object Mode 

Properties >» Object Properties >» Motion 
Paths 


3D Viewport, Properties 

Pose Mode 

Properties » Armature >» Motion Paths 
Pose » Motion Paths 


An animated cube with its motion path displayed. 


The Motion Paths tool allows you to visualize the motion of 
points as paths over a series of frames. These points can be 
object origins and bone joints. 


To create or remove motion paths, it is necessary to first 
select the bones. Then: 


1. To show the paths (or update them, if needed), click on 
the Calculate Path button. 
2. To hide the paths, click on the Clear Paths button. 


Note 


Remember that only selected bones and their paths are 
affected by these actions! 


The paths are shown in a light shade of gray for unselected 
points, and a slightly bluish gray for selected ones. Around 
the current frame a glow indicate the direction of 
movement: blue towards future frames and green towards 
the past. Each frame is displayed by a small white dot on 
the paths. 


The paths are automatically updated when you edit your 
poses/keyframes, and they are also active during animation 
playback. Playing the animation affects the paths only when 
the Around Current Frame option is enabled. 


Options 


¥ Motion Paths 
Paths Type In Range 


Frame Range Start 
End 
Step 


= Update Paths 


¥ Display 


Frame Numbers 
Keyframes 
+ Non-Grouped Keyframes 
Keyframe Numbers 
Lines 
Thickness 
Custom Color 


The Motion Paths panel in the Armature tab. 


Paths Type 
Type of range to show for Motion Paths. 


Around Frame: Display paths of points within a fixed 
number of frames around the current 
frame. When you enable this button, 
you get paths for a given number of 
frames before and after the current one 
(again, as with ghosts). 


In Range: Display paths of points within specified 
range. 
Update Range from Scene (Clock Icon) 
Updates the display frame range 
from the scene frame range. 


Frame Range Start, End 


Starting and Ending frame of range of paths to 
display/calculate (not for Around Current Frame onion 
skinning method). 


Frame Range Before, After 
Number of frames to show before and after the current 
frame (only for Around Current Frame onion skinning 
method). 


Step 
Allows displaying one point for every n frames on the 
path. Mostly useful when you enable the frame number 
display (see below), to avoid cluttering the 3D Viewport. 


Calculation Range 
The method to choose the upper and lower bounds of 
Motion Paths. 


Scene Frame Range: 
Calculates Motion Paths for the entire 
Scene or Preview frame duration. 

Selected Keys: Calculates Motion Paths for the range 
of the first selected keyframe to the 
last keyframe. 

All Keys: Calculates Motion Paths from the first 
keyframe to the last keyframe. 


Cache/Bone Cache From, To 
These are the start/end frames of the range in which 
motion paths are shown. You cannot modify this range 
without deleting the motion path first. 


Calculate 
If no paths have been calculated, Calculate Paths will 
create a new motion path in cache based on the options 
specified in the pop-up menu or the Adjust Last 


Operation panel. Note, if the current context is an 
Armature calculating the objects motion paths, and not 
the bones, this operator will calculate the motion paths 
for all the bones within the armature as well. 


Start, End 
These are the start/end frames of the range in which 
motion paths are shown. The start frame is inclusive, 
so if you set Start to 1, you will really see the frame 1 
as Starting point of the paths... 


Bake Location 
Which point on the bones is used when calculating 
paths. Only available for bones while in Pose Mode. 


Heads: Calculates the path position of the 
bone’s heads. 
Tails: Calculates the path position of the 


bone’s heads. 


Update Paths 
In the case a path has already been calculated, this 
operator will update the path shape to the current 
animation. To change the frame range of the calculated 
path, you need to delete the path and calculate it again. 


Clear Paths x 


Clears paths on all objects/bones or just the selected 
ones when holding Shift. 


Update All Paths 


Recalculates the motion paths for all visible objects and 
poses. 


Display 


Frame Numbers 
When enabled, a small number appears next to each 
frame dot on the path, which is of course the number of 
the corresponding frame. 


Keyframes 
When enabled, big yellow square dots are displayed on 
motion paths, showing the keyframes of their bones (i.e. 
only the paths of keyed bones at a given frame get a 
yellow dot at this frame). 


+ Non-Grouped Keyframes 
For bone motion paths, it searches the whole Action for 
keyframes instead of in groups with matching name only 
(this is slower). 


Keyframe Numbers 
When enabled, you will see the numbers of the displayed 
keyframes, so this option is obviously only valid when 
Show Keys is enabled. 


Lines 
Toggles whether the lines between the points are shown. 


Thickness 
Line thickness for motion path. 


Custom Color 
Use custom color for this motion path. 


Example 


An example of a motion path of an armature. 
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Introduction 


Blender’s physics system allows you to simulate a number 
of different real-world physical phenomena. You can use 
these systems to create a variety of static and dynamic 
effects such as: 


e Hair, grass, and flocks 
Rain 

Smoke and dust 
Water 

Cloth 

Jello 

etc. 


Quick Effects 


Reference 

Editor: 3D Viewport 

Mode: Object Mode 

Menu: Object >» Quick Effects 


Sets up a basic simulation scene or effect including the 
selected objects. The tool will add essential objects like 
domains or particle systems both with predefined settings, 
so that there will be instant viewable result. 


Rigid Body 
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Introduction 


The rigid body simulation can be used to simulate the 
motion of solid objects. It affects the position and 
orientation of objects and does not deform them. 


Unlike the other simulations in Blender, the rigid body 
simulation works closer with the animation system. This 
means that rigid bodies can be used like regular objects and 
be part of parent-child relationships, animation constraints 
and drivers. 


Creating a Rigid Body 


Reference 

Mode: All Modes 

Panel: Properties » Physics » Rigid Body 
Menu: Object > Rigid Body 


Only mesh objects can be part of a rigid body simulation. To 
create rigid bodies, either click on the Rigid Body button in 
the Physics tab of the Properties or use Add Active/Add 
Passive in the Object » Rigid Body menu. 


There are two types of rigid bodies: active and passive. 
Active bodies are dynamically simulated, while passive 
bodies remain static. Both types can be driven by the 
animation system when using the Animated option. 


During the simulation, the rigid body system will override 
the position and orientation of dynamic rigid body objects. 
Note however, that the location and rotation of the objects 


are not changed, so the rigid body simulation acts similar to 
a constraint. To apply the rigid body transformations you 
can use the Apply Object Transform operator. 


The scale of the rigid body object also influences the 
simulation, but is always controlled by the animation 
system. 


Rigid body physics on the object can be removed with the 
Rigid Body button in the Physics tab in the Properties or in 
the Object >» Rigid Body menu. 


Working with Rigid Bodies 


Several object operators exist for working with rigid bodies, 
these operators can be found in the Rigid Body object 
menu. These operators include functions to add/remove 
rigid bodies, modify their properties, and add Rigid Body 
Constraints. 


Properties 


Reference 


Panel: Physics >» Rigid Body 


Type 
Role of the rigid body in the simulation. 


Active 
The object is dynamic and is directly controlled by 
simulation results. 


Passive 
The object remains static and is directly controlled by 
animation system, thus does not have Dynamics 
properties. 


e Settings 
e Collisions 
o Surface Response 
o Sensitivity 
o Collections 
e Dynamics 
o Deactivation 


Settings 


Reference 


Panel: Physics » Rigid Body » Settings 


Mass 


Specifies how heavy the object is and “weights” 
irrespective of gravity. 


Tip 


There are predefined mass presets available with the 
Calculate Mass operator. 


Dynamic 


Enables/disables rigid body simulation for the object. 
Animated 


Allows the rigid body to additionally be controlled by the 
animation system. 


Collisions 


Reference 


Panel: Physics » Rigid Body » Collisions 


Shape 
Determines the collision shape of the object; these can 
be broken into two categories: primitive shapes and 
mesh based shapes. 


Primitive shapes (Box, Sphere, Capsule, Cylinder, and 
Cone) are best in terms of memory and performance but 
do not necessarily reflect the actual shape of the object. 
They are calculated based on the object’s bounding box. 
The center of gravity is always in the geometric center of 
the shape. Primitive shapes can be shown in the 3D 
Viewport by enabling Bounds. 


Mesh based shapes (Convex Hull and Mesh) are 
calculated based on the geometry of the object so they 
are a better representation of the object. The center of 
gravity for these shapes is the object origin. 


Box 
Box-like shapes (e.g. cubes), including planes (e.g. 
ground planes). The size per axis is calculated from 
the bounding box. 


Sphere 
Sphere-like shapes. The radius is the largest axis of 
the bounding box. 


Capsule 


This points up the Z axis. 


Cylinder 
This points up the Z axis. The height is taken from the 
Z axis, while the radius is the larger of the X or Y axes. 


Cone 
This points up the Z axis. The height is taken from the 
Z axis, while the radius is the larger of the X or Y axes. 


Convex Hull 
A mesh-like surface encompassing (e.g. shrink- 
wrapped over) all vertices (best results with fewer 
vertices). A convex approximation of the object, which 
has good performance and stability. 


Mesh 
Mesh consisting of triangles only, allowing for more 
detailed interactions than convex hulls. Allows 
simulating concave objects, but is rather slow and 
unstable. 


Compound Parent 
Takes the collision shapes from the object’s children 
and combines them. This makes it possible to create 
concave shapes from primitive shapes. This usually 
results in a faster simulation than the Mesh collision 
shape while also being generally more stable. 


Source 
Source of the mesh used to create the collision shape. 


Base 
The base mesh of the object. 


Deform 


Includes any deformations added to the mesh (shape 
keys, deform modifiers). 


Deforming 
Mesh shapes can deform during simulation. 


Final 
Includes all deformations and modifiers. 


Surface Response 


Friction 
Resistance of object to movement. Specifies how much 
velocity is lost when objects collide with each other. 


Bounciness 
Tendency of object to bounce after colliding with another 
(0 to 1) (rigid to perfectly elastic). Specifies how much 
objects can bounce after collisions. 


Sensitivity 


The collision margin is used to improve the performance and 
Stability of rigid bodies. Depending on the shape, it behaves 
differently: some shapes embed it, while others have a 
visible gap around them. 


The margin is embedded for these shapes: 


e Sphere 
e Box 

e Capsule 
e Cylinder 


e Convex Hull: Only allows for uniform scale when 
embedded. 


The margin is not embedded for these shapes: 


e Cone 
e Active Triangle Mesh 
e Passive Triangle Mesh: Can be set to 0 most of the time. 


Margin 


Threshold of distance near the surface where collisions 
are still considered (best results when nonzero). 


Collections 


Allows rigid body collisions allocate on different groups 
(maximum 20). 


Dynamics 


Reference 


Panel: Physics » Rigid Body » Dynamics 


Used to control the physics of the rigid body simulation. This 
panel is available only for Active type of rigid bodies. 


Damping Translation 
Amount of linear velocity that is lost over time. 


Rotation 
Amount of angular velocity that is lost over time. 


Deactivation 


Enable deactivation of resting rigid bodies. Allows the object 
to be deactivated during the simulation (improves the 
performance and stability, but can cause glitches). 


Start Deactivated 
The rigid body starts deactivated. It will be activated 
when in proximity of moving active rigid body objects. 
The proximity check uses the object’s bounding box to 
determine if a moving object is close enough to activate 
it. 


Linear Velocity 
Specifies the linear deactivation velocity below which the 
rigid body is deactivated and the simulation stops 
simulating the object. 


Angular Velocity 
Specifies the angular deactivation velocity below which 
the rigid body is deactivated and the simulation stops 
simulating the object. 


Rigid Body World 


Reference 


Panel: Scene » Rigid Body World 


The Rigid Body World is a group of rigid body objects, which 
holds settings that apply to all rigid bodies in this 
simulation. 


When you add rigid body physics to an object, primary there 
is created a group of objects with default “RigidBodyWorld” 
name. Rigid body objects automatically are added to this 
group when you add rigid body physics for them. You can 
create several Rigid Body World Collections and allocate the 
rigid body objects with the Collections panel. 


Rigid body objects and constraints are only taken into 
account by the simulation if they are in the collection 
specified in the Collection field of the Rigid Body World 
panel in the Scene tab. 


Settings 


Rigid Body World 
Enable/disable evaluation of the rigid body simulation 
based on the rigid body objects participating in the 
specified group of Rigid Body World. 


Remove Rigid Body World 
Remove rigid body simulation from the current scene. 


Collection 


Containing rigid body objects participating in this 
Simulation. 


Constraints 


Containing rigid body object constraints participating in 


the simulation. 
Simulation quality and timing settings: 


Speed 
Can be used to speed up/slow down the simulation. 


Split Impulse 


Enable/disable reducing extra velocity that can build up 


when objects collide (lowers the simulation stability a 
little so use only when necessary). Limits the force with 
which objects are separated on collision, generally 
produces nicer results, but makes the simulation less 
stable (especially when stacking many objects). 


Steps per Second 
Number of simulation steps made per second (higher 
values are more accurate but slower). This only 
influences the accuracy and not the speed of the 
simulation. 


Solver Iterations 
Amount of constraint solver iterations made per 
simulation step (higher values are more accurate but 
slower). Increasing this makes constraints and object 
stacking more stable. 


Rigid Body Cache 


Reference 


Panel: Scene » Rigid Body World » Cache 


The Cache subpanel specifies the frame range in which the 
simulation is active. Can be used to bake the simulation. 


Start/End 
First and last frame of the simulation. 


Bake 


Calculates the simulation and protects the cache. You 
need to be in Object Mode to bake. 


Free Bake 
Active after the baking of simulation. Clears the baked 
cache. 


Calculate to Frame 
Bake physics to current frame. 


Current Cache to Bake 
Bake from Cache. 


Bake All Dynamics 
Bake all physics. 


Free All Bakes 
Free all baked caches of all objects in the current scene. 


Update All to Frame 
Update cache to current frame. 


If you have not saved the blend-file, the cache is created in 
memory, so save your file first or the cache may be lost. 


Rigid Body Field Weights 


Reference 


Panel: Scene >» Rigid Body World » Field 
Weights 


As other physics dynamics systems, rigid body simulation 
are also influenced by external force effectors. 


Rigid Body Constraints 


e Introduction 

o Connect 

o Physics Menu 

o Common Options 
e Types 
Fixed Constraint 
Point Constraint 
Hinge Constraint 
Slider Constraint 
Piston Constraint 
Generic Constraint 
Generic Spring Constraint 
Motor Constraint 
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Introduction 


Constraints (also known as joints) for rigid bodies connect 
two rigid bodies. The physics constraints are meant to be 
attached to an Empty object. The constraint then has fields 
which can be pointed at the two physics-enabled object 
which will be bound by the constraint. The empty object 
provides a location and axis for the constraint distinct from 
the two constrained objects. The location of the entity 
hosting the physics constraint marks a location and set of 
axes on each of the two constrained objects. These two 
anchor points are calculated at the beginning of the 
animation and their position and orientation remain fixed in 
the /Jocal coordinate system of the object for the duration of 
the animation. The objects can move far from the constraint 
object, but the constraint anchor moves with the object. If 
this feature seems limiting, consider using multiple objects 
with a non-physics Child of constraint and animate the 
relative location of the child. 


Connect 


The quickest way to constrain two objects is to select both 
and click the Connect button in Object > Rigid Body. This 
creates a new empty object (named “Constraint”) with a 
physics constraint already attached and pointing at the two 
selected objects. 


Physics Menu 


Also you can create Rigid Body Constraint on one of the two 
constrained objects with Rigid Body Constraint button of the 
Physics tab in the Properties. This constraint is dependent 
on the object location and rotation on which it was created. 
This way, there are no empty object created for the 
constraint. The role of the empty object is put on this object. 
The constrained object can be then be set as a Passive type 
for better driving of the constraint. 


Additional parameters appear in the Rigid Body Constraint 
panel of the Physics tab in the Properties for the selected 
empty object or the one of the two constrained objects with 
the created constraint. 


Common Options 


Reference 


Panel: Physics >» Rigid Body Constraint 


Settings 


Enabled 
Specifies whether the constraint is active during the 
simulation. 


Disable Collisions 
Allows constrained objects to pass through one another. 


Breakable 
Allows constraint to break during simulation. Disabled for 
the Motor constraint. This can be used to simulate 
destruction. 


Threshold 
Impulse strength that needs to be reached before the 
constraint breaks. 


Limits 


By using limits you can constrain objects even more by 
specifying a translation/rotation range on/around 
respectively one axis (see below for each one individually). 
To lock one axis, set both limits to 0. 


Objects 


First 
First object to be constrained. 


Second 
Second object to be constrained. 


Override Iterations 


Allows making constraints stronger (more iterations) or 
weaker (less iterations) than specified in the rigid body 
world. 


Iterations 
Number of constraint solver iterations made per 
simulation step for this constraint. 


Types 


Fixed Constraint 
Point Constraint 
Hinge Constraint 
o Options 
Slider Constraint 
o Options 
Piston Constraint 
o Options 
Generic Constraint 
o Options 
Generic Spring Constraint 
o Options 
Motor Constraint 
o Options 


Fixed Constraint 


Reference 
Panel: Physics >» Rigid Body Constraint 
Type: Fixed 


This constraint cause the two objects to move as one. Since 
the physics system does have a tiny bit of slop in it, the 


objects do not move as rigidly as they would if they were 
part of the same mesh. 


Point Constraint 


Reference 
Panel: Physics » Rigid Body Constraint 
Type: Point 


The objects are linked by a point bearing allowing any kind 
of rotation around the location of the constraint object, but 
no relative translation is permitted. The physics engine will 
do its best to make sure that the two points designated by 
the constraint object on the two constrained objects are 
coincident. 


Hinge Constraint 


Reference 
Panel: Physics » Rigid Body Constraint 
Type: Hinge 


The hinge permits one degree of freedom between two 
objects. Translation is completely constrained. Rotation is 
permitted about the Z axis of the object hosting the Physics 
constraint (usually an Empty, distinct from the two objects 
that are being linked). Adjusting the position and rotation of 
the object hosting the constraint allows you to control the 
anchor and axis of the hinge. 


The Hinge is the only single-axis rotational constraint that 
uses the Z axis instead of the X axis. If something is wrong 
with your hinge, check your other constraints to see if this 
might be the problem. 


Options 


Limits 
Z Angle 
Enables/disables limit rotation around Z axis. 


Lower 
Lower limit of Z axis rotation. 


Upper 
Upper limit of Z axis rotation. 


Slider Constraint 


Reference 
Panel: Physics » Rigid Body Constraint 
Type: Slider 


The Slider constraint allows relative translation along the X 
axis of the constraint object, but permits no relative 
rotation, or relative translation along other axes. 


Options 


Limits 
X Axis 
Enables/disables limit translation around X axis. 


Lower 
Lower limit of X axis translation. 


Upper 
Upper limit of X axis translation. 


Piston Constraint 


Reference 
Panel: Physics » Rigid Body Constraint 
Type: Piston 


A piston permits translation along the X axis of the 
constraint object. It also allows rotation around the X axis of 
the constraint object. It is like a combination of the 
freedoms of a slider with the freedoms of a hinge (neither of 
which is very free alone). 


Options 


Limits 
X Axis 
Enables/disables limit translation around X axis. 


Lower 
Lower limit of X axis translation. 


Upper 
Upper limit of X axis translation. 


X Angle 
Enables/disables limit rotation around X axis. 


Lower 
Lower limit of X axis rotation. 


Upper 
Upper limit of X axis rotation. 


Generic Constraint 


Reference 
Panel: Physics » Rigid Body Constraint 
Type: Generic 


The generic constraint has a lot of available parameters. 


The X, Y, and Z axis constraints can be used to limit the 
amount of translation between the objects. Clamping the 
min/max to zero has the same effect as the Point constraint. 


Clamping the relative rotation to zero keeps the objects in 
alignment. Combining an absolute rotation and translation 
clamp would behave much like the Fixed constraint. 


Using a nonzero spread on any parameter allows it to 
oscillate in that range throughout the course of the 
simulation. 


Options 


Limits 
Angular 
X Axis, Y Axis, Z Axis 
Enables/disables limit translation on X, Y or Z axis 
respectively. 


Lower 
Lower limit of translation for X, Y or Z axis 
respectively. 


Upper 
Upper limit of translation for X, Y or Z axis 
respectively. 


Linear 
X Angle, Y Angle, Z Angle 
Enables/disables limit rotation around X, Y or Z axis 
respectively. 


Lower 
Lower limit of rotation for X, Y or Z axis 
respectively. 


Upper 
Upper limit of rotation for X, Y or Z axis 
respectively. 


Generic Spring Constraint 


Reference 
Panel: Physics » Rigid Body Constraint 
Type: Generic Spring 


The generic spring constraint adds some spring parameters 
for the X/Y/Z axes to all the options available on the Generic 
constraint. Using the spring alone allows the objects to 
bounce around as if attached with a spring anchored at the 
constraint object. This is usually a little too much freedom, 
so most applications will benefit from enabling translation or 
rotation constraints. 


If the damping on the springs is set to 1, then the spring 
forces are prevented from realigning the anchor points, 
leading to strange behavior. If your springs are acting weird, 
check the damping. 


Options 


Limits 
X/Y/Z Axis 
Enables/disables limit translation on X, Y or Z axis 
respectively. 


Lower 
Lower limit of translation for X, Y or Z axis 
respectively. 


Upper 


Upper limit of translation for X, Y or Z axis 
respectively. 
X/Y/Z Angle 
Enables/disables limit rotation around the X, Y or Z 
axis respectively. 
Lower 
Lower limit of rotation for X, Y or Z axis 
respectively. 
Upper 
Upper limit of rotation for X, Y or Z axis 
respectively. 
Springs 
X/Y/Z Axis 
Enables/disables springs translation on X, Y or Z axis 
respectively. 
Stiffness 
Spring Stiffness of the translation on X, Y or Z axis 
respectively. Specifies how “bendy” the spring is. 
Damping 


Spring Damping of the translation on X, Y or Z axis 
respectively. Amount of damping the spring has. 


X/Y/Z Angle 


Enables/disables springs rotation around the X, Y or Z 
axis respectively. 


Stiffness 


Spring Stiffness of the rotation around the X, Y or Z 


axis respectively. Specifies how “bendy” the spring 
iS. 


Damping 
Spring Damping of the rotation around the X, Y or Z 
axis respectively. Amount of damping the spring 
has. 


Motor Constraint 


Reference 
Panel: Physics » Rigid Body Constraint 
Type: Motor 


The motor constraint causes translation and/or rotation 
between two entities. It can drive two objects apart or 
together. It can drive simple rotation, or rotation and 
translation (although it will not be constrained like a screw 
since the translation can be blocked by other physics 
without preventing rotation). 


The rotation axis is the X axis of the object hosting the 
constraint. This is in contrast with the Hinge which uses the 
Z axis. Since the Motor is vulnerable to confusing 
perturbations without a matching Hinge constraint, special 
care must be taken to align the axes. Without proper 
alignment, the motor will appear to have no effect (because 
the hinge is preventing the motion of the motor). 


Options 


Linear Motor/Angular Motor 
Enable 
Enable linear or angular motor respectively. 


Target Velocity 
Target linear or angular motor velocity respectively. 


Max Impulse 


Maximum linear or angular motor impulse 
respectively. 


Tips 


As with all physics-enabled objects, pay close attention to 
the Animated checkbox in the Rigid Body panel of the 
Physics tab in the Properties. A common mistake is to use 
keyframe animation on a Passive physics object without 
checking the Animated box. The object will move, but the 
physics engine will behave as if the Passive is still in its 
starting place, leading to disappointment. 


Animation 


The most common trick is to Keyframe animate the location 
or rotation of an Active physics object as well as the 
Animated checkbox. When the curve on the Animated 
property switches to disabled, the physics engine takes over 
using the object’s last known location, rotation and 
velocities. 


Animating the strengths of various other parameters (a 
Motor’s Target Velocity, a Hinge’s limits, etc.) can be used to 
accomplish a wide variety of interesting results. 


Enabling a constraint during the physics simulation often 
has dramatic results as the physics engine tries to bring into 
alignment two objects which are often dramatically out of 
alignment. It is very common for the affected objects to 
build up enough kinetic energy to bounce themselves out of 
camera. 


Rigid body dynamics can be baked to normal keyframes 
with Bake To Keyframes in the Object >» Rigid Body menu. 


Simulation Stability 


The simplest way of improving simulation stability is to 
increase the steps per second. However, care has to be 
taken since making too many steps can cause problems and 
make the simulation even less stable (if you need more than 
1000 steps, you should look at other ways to improve 
Stability). 


Increasing the number of solver iterations helps making 
constraints stronger and also improves object stacking 
Stability. 


It is best to avoid small objects, as they are currently 
unstable. Ideally, objects should be at least 20 cm in 
diameter. If it is still necessary, setting the collision margin 
to 0, while generally not recommended, can help making 
Small object behave more naturally. 


When objects are small and/or move very fast, they can 
pass through each other. Besides what is mentioned above 
it’s also good to avoid using mesh shapes in this case. Mesh 
Shapes consist of individual triangles and therefore do not 
really have any thickness, so objects can pass through more 
easily. You can give them some thickness by increasing the 
collision margin. 


Combining Rigid Bodies with 
Other Simulations 
Since the rigid body simulation is part of the animation 


system, it can influence other simulations just like the 
animation system can. 


In order for this to work, the rigid body object needs to have 
a Collision Modifier. Simply click on Collision in the Physics 
tab. 


Scaling Rigid Bodies 


Rigid body objects can be scaled, also during the simulation. 
This work well in most cases, but can sometimes cause 
problems. 


If dynamic scaling is not needed, rigid body objects should 
have the scale applied by using the Apply Scale tool ctrl-a. 
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Introduction 


Cloth simulation is one of the hardest aspects of computer 
graphics, it is a deceptively simple real-world item that is 
taken for granted, but it actually has very complex internal 
and environmental interactions. Cloth is commonly modeled 
as 2D mesh to simulate real world objects such as fabrics, 
flags, banners. And yet cloth can also be used to model 3D 
objects such as teddy bears, pillows, balloons, or balls. 


Cloth interacts with and is affected by other moving objects, 
the wind and other forces, as well as a general aerodynamic 
model, all of which is under your control. 


Cloth on 


carved 
Cloth wooden Cloth 
example. men example. 
(made by 
motorsep). 


Once Cloth physics have been added to a mesh, a Cloth 
modifier will be added to the object’s modifier stack. As a 
modifier then, it can interact with other modifiers, such as 
Armature and Smooth. In these cases, the ultimate shape of 
the mesh is computed in accordance with the order of the 


modifier stack. For example, you should smooth the cloth 
after the modifier computes the shape of the cloth. 


You can Apply the Cloth Modifier to freeze, or lock in, the 
Shape of the mesh at that frame, which removes the 
modifier. For example, you can drape a flat cloth over a 
table, let the simulation run, and then apply the modifier. In 
this sense, you are using the simulator to save yourself a lot 
of modeling time. 


Results of the simulation are saved in a cache, so that the 
Shape of the mesh, once calculated for a frame in an 
animation, does not have to be recomputed again. If 
changes to the simulation are made, you have full control 
over clearing the cache and re-running the simulation. 
Running the simulation for the first time is fully automatic 
and no baking or separate step interrupts the workflow. 


Computation of the shape of the cloth at every frame is 
automatic and done in the background; thus you can 
continue working while the simulation is computed. 
However, it is CPU-intensive and depending on the power of 
your PC and the complexity of the simulation, the amount of 
CPU needed to compute the mesh varies, as does the lag 
you might notice. 


Note 
Do Not Jump Ahead 


If you set up a cloth simulation but Blender has not 
computed the shapes for the duration of the simulation, 
and if you jump ahead a lot of frames forward in your 
animation, the cloth simulator may not be able to compute 
or show you an accurate mesh shape for that frame, if it 


has not previously computed the shape for the previous 
frame(s). 


Workflow 


A general process for working with cloth is to: 


1. Model the cloth object as a general starting shape. 

2. Designate the object as a “cloth” in the Physics tab of 
the Properties. 

3. Model other deflection objects that will interact with the 
cloth. Ensure the Deflection modifier is last on the 
modifier stack, after any other mesh deforming 
modifiers. 

4. Light the cloth and assign materials and textures, UV 
unwrapping if desired. 

5. If desired, give the object particles, such as steam 
coming off the surface. 

6. Run the simulation and adjust settings to obtain 
satisfactory results. The Timeline editors playback 
controls are great for this step. 

7. Optionally age the mesh to some point in the simulation 
to obtain a new default starting shape. 

8. Make minor edits to the mesh on a frame-by-frame basis 
to correct minor tears. 


Tip 


To avoid unstable simulation, make sure that the cloth 
object does not penetrate any of the deflection objects. 


Springs 


Internally, cloth physics is simulated with virtual springs that 
connect the vertices of a mesh. There are four types of 
springs that control how the cloth bends. These four types 
are defined below and illustrated in the following image: 


Mf 


SS 
SS 


Illustration of cloth springs; tension springs (blue), 
compression springs (red), shear springs (cyan), and 
angular bending springs (green). 


Tension Springs 
Control the stiffness of the cloth. 


Compression Springs 
Control the amount of force required to collapse or 
compress the cloth. 


Shear Springs 
Like compression springs but it controls the angular 
deformation. 


Angular Bending Springs 
Control how resilient the cloth is to folding or crumpling. 


All four of these spring types can be controlled 
independently in the Physical Properties panel. While these 
settings control surface springs, optionally, internal springs 
can be used for 3D meshes and behave similarly to Soft 
Bodies. 


Settings 


Reference 


Panel: Physics > Cloth 


Presets 
Contains a number of preset cloth examples. 


Quality Steps 
Set the number of simulation steps per frame. Higher 
values result in better quality, but will be slower. 


Speed Multiplier 
Adjust how fast time progresses in the cloth simulation. 


e Physical Properties 
o Stiffness 
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Physical Properties 


Reference 


Panel: Physics » Cloth > Physical Properties 


Mass 
The mass of the cloth material. 


Air Viscosity 
Air has some thickness which slows falling things down. 


Bending Model 
Linear 
Cloth model with linear bending springs (old). 


Angular 
Cloth model with angular bending springs. 


Stiffness 


Tension 
How much the material resists stretching. 


Compression 
How much the material resists compression. 


Structural 
Overall stiffness of the cloth (only in linear bending 
model). 


Shear 
How much the material resists shearing. 


Bending 
Wrinkle coefficient. Higher creates more large folds. 


Damping 


Tension 
Amount of damping in stretching behavior. 


Compression 
Amount of damping in compression behavior. 


Structural 
Amount of damping in stretching behavior (only in linear 
bending model). 


Shear 
Amount of damping in shearing behavior. 


Bending 
Amount of damping in bending behavior. 


Internal Springs 


As stated in the introduction, cloth physics are simulated 
through Springs connecting vertices on the surface of a 
mesh. But these springs only interact on the surface and 
only apply to 2D surfaces. 3D or Internal Springs can be 
used to make a mesh behave similarly to a Soft Body. 
Internal springs can be enabled by toggling the checkbox in 
the Internal Springs panel header. 


Max Spring Creation Length 
The maximum length an internal spring can have during 
creation. If the distance between internal points is 


greater than this, no internal spring will be created 
between these points. A length of zero means that there 
is no length limit. 


Max Creation Diversion 
The maximum angle that is allowed to use to connect the 
internal points can diverge from the vertex normal. 


Check Surface Normals 
Requires the points the internal springs connect to have 
opposite normal directions. 


Tension 
How much the material resists stretching. 


Compression 
How much the material resists compression. 


Vertex Group 
The Tension and Compression of internal springs can be 
controlled via a Vertex Group to specify which the 
portions of the mesh have internal springs or the spring 
strength. 


Max Tension 
Maximum tension stiffness value. 


Max Compression 
Maximum Compression stiffness value. 


Pressure 


Cloth pressure allows the simulation of soft-shelled objects 
such as balloons or balls that are filled with a type of fluid. 
This fluid is modeled as a gas; to emulate an incompressible 
liquid set Pressure Scale as high as possible without 


breaking the simulation. Cloth pressure can be enabled by 
toggling the checkbox in the Pressure panel header. 


Note 


Non-manifold meshes will work with cloth pressure 
however, pressure will escape out of the mesh holes and 
cause drifting or propulsion forces. One way to get around 
this is by using the Vertex Group to exclude the non- 
manifold portions of the mesh. 


Pressure 
The uniform pressure that is constantly applied to the 
mesh. This value is specified in units of Pressure Scale, 
and can be negative to simulate implosions or any other 
case where an object has outside pressure pushing 
inwards. 


Custom Volume 
Use the Target Volume parameter as the initial volume 
for the cloth, instead of computing it from the mesh 
itself. 


Target Volume 
The mesh volume where the inner/outer pressure will 
be the same. If set to zero, changes in the volume of 
the object will not affect pressure. 


Pressure Scale 
Ambient pressure (in kPa) that exists both inside and 
outside the object, balancing out when the volume 
matches the target. Increase the value to make the 
object resist changes in volume more strongly. 


Fluid Density 


Specifies the density of the fluid contained inside the 
object (in kg/liter = 1000 kg/m?, use 1 for water), used to 
generate a hydrostatic pressure gradient that simulates 
the weight of the fluid. If the value is negative, it instead 
models buoyancy from a surrounding fluid. 


The fluid is not actually simulated, so while the setting 
helps to achieve a more plausible object shapes at rest, it 
cannot create realistic fluid dynamics effects. It can also 
be used to give more weight to a soft body like object 
with heavy and sufficiently flexible filling, even if it is not 
a fluid by itself. 


The volume of the object is not preserved. If that is 
desired it should be used together with Pressure Scale. 
Fluid density times object size times 50 is a good start 
value for Scale to make sure that no more than 10% 
volume change if the object does not experience higher 
acceleration than standard gravity. 


Vertex Group 
Cloth pressure can be controlled via a Vertex Group to 
specify which the portions of the mesh to apply pressure. 
Zero weight means no pressure while a weight of one 
means full pressure. 


Note, faces with a vertex that has zero weight will be 
excluded from the Target Volume calculation. 


Cache 


Reference 


Panel: Physics » Cloth Cache 


After you have set up the deflection mesh for the frame 
range you intend to run the simulation (including animating 
that mesh via armatures), you can now tell the cloth 
Simulation to compute (and avoid) collisions. Select the 
cloth object and in the Object tab, Physics tab, set the Start 
and End settings for the simulation frames you wish to 
compute, and click the Bake button. 


Cache settings for cloth are the same as with other dynamic 
systems. See Particle Cache for details. 


Note 


If you move or edit the cloth object after you have already 
run the simulations, you must clear the cache; otherwise, 
Blender will use the position of the current/cached mesh’s 
vertices when trying to represent where they are. 


Note 
Subdivision Surface Modifier 
A bake/cache is done for every subdivision level so please 


use the equal subdivision level for render and preview. 


Note 


You cannot change Start or End without clearing the bake 
Simulation. When the simulation has finished, you will 
notice you have the option to free the bake, edit the bake 
and re-bake 


Editing the Cached Simulation 


The cache contains the shape of the mesh at each frame. 
You can edit the cached simulation, after you have baked 
the simulation and pressed the Bake Editing button. Just go 
to the frame you want to fix and Tab into Edit Mode. There 
you can move your vertices using all of Blender’s mesh 
Shaping tools. When you exit, the shape of the mesh will be 
recorded for that frame of the animation. If you want 
Blender to resume the simulation using the new shape 
going forward, select Rebake from next Frame and play the 
animation. Blender will then pick up with that shape and 
resume the simulation. 


Edit the mesh to correct minor tears and places where the 
colliding object has punctured the cloth. 


If you add, delete, or extrude vertices in the mesh, Blender 
will take the new mesh as the starting shape of the mesh 
back to the first frame of the animation, replacing the 
original shape you started with, up to the frame you were on 
when you edited the mesh. Therefore, if you change the 
content of a mesh, when you press Tab out of Edit Mode, you 
should unprotect and clear the cache so that Blender will 
make a consistent simulation. 


Shape 


Reference 


Panel: Physics >» Cloth >» Shape 


Cloth Presets 


v Pinning: 


Cloth Shape. 


Pin Group 
Vertex group to use for pinning. 


The shape of the cloth can be controlled by pinning cloth 
to a Vertex Group. There are several ways of doing this 
including Weight Painting areas you want to pin. The 
weight of each vertex in the group controls how strongly 
it is pinned. 


Stiffness 
Target position stiffness. 


Sewing 


Another method of restraining cloth similar to pinning is 
sewing springs. Sewing springs are virtual springs that 
pull vertices in one part of a cloth mesh toward vertices 
in another part of the cloth mesh. This is different from 
pinning which binds vertices of the cloth mesh in place or 
to another object. A clasp on a cloak could be created 
with a sewing spring. The spring could pull two corners of 
a cloak about a character’s neck. This could result in a 
more realistic simulation than pinning the cloak to the 
character’s neck since the cloak would be free to slide 
about the character’s neck and shoulders. 


Sewing springs are created by adding extra edges to a 
cloth mesh that are not included in any faces. They 
Should connect vertices in the mesh that should be 
pulled together. For example the corners of a cloak. 


Max Sewing Force 
Maximum force that can be applied by sewing springs. 
Zero means unbounded, but it is not recommended to 
leave the field at zero in most cases, as it can cause 
instability due to extreme forces in the initial frames 
where the ends of the sewing springs are far apart. 


Shrinking Factor 


Factor by which to shrink the cloth, specifying a negative 
value controls the amount for the cloth to grow. 


Dynamic Mesh 
Allows animating the rest shape of cloth using shape 
keys or modifiers (e.g. an Armature modifier or any 
deformation modifier) placed above the Cloth modifier. 
When it is enabled, the rest shape is recalculated every 
frame, allowing unpinned cloth to squash and stretch 
following the character with the help of shape keys or 


modifiers, but otherwise move freely under control of the 
physics simulation. 


Normally cloth uses the state of the object in the first 
frame to compute the natural rest shape of the cloth, and 
keeps that constant throughout the simulation. This is 
reasonable for fully realistic scenes, but does not quite 
work for clothing on cartoon style characters that use a 
lot of squash and stretch. 


Rest Shape Key 
Allows starting the cloth simulation using a specific 
Shape key as the rest state, instead of the shape that 
results from evaluating shape keys and preceding 
modifiers in the regular way. This option is mutually 
exclusive with Dynamic Mesh. 


This can be used to start the simulation with the cloth in 
a pre-draped state without applying that shape as a 
plastic deformation that relaxes all springs as a side 
effect. 


Collisions 


In most cases, a piece of cloth does not just hang there in 
3D space, it collides with other objects in the environment. 
To ensure proper simulation, there are several items that 
have to be set up and working together: 


The Cloth object must be told to participate in collisions. 
Optionally (but recommended) tell the cloth to collide 
with itself. 

Other objects must be visible to the Cloth object via 
Shared layers. 

The other objects must be mesh objects. 

The other objects may move or be themselves deformed 
by other objects (like an armature or shape key). 

The other mesh objects must be told to deflect the cloth 
object. 

The blend-file must be saved in a directory so that 
simulation results can be saved. 

You then Bake the simulation. The simulator computes 
the shape of the cloth for a frame range. 

You can then edit the simulation results, or make 
adjustments to the cloth mesh, at specific frames. 

You can make adjustments to the environment or 
deforming objects, and then re-run the cloth simulation 
from the current frame forward. 


Collision Settings 


Reference 


Panel: Physics » Cloth » Collision 


¥ Collisions 
Quality 
¥ ™ Object Collisions 


Distance 0.015m 


Impulse Clamping 0.000 


| cme | 


Collision Collecti.. [=] 
¥ ™ Self Collisions 


Friction 
Distance 
Impulse Clamping 


Vertex Group §s 


Cloth Collisions panel. 


Now you must tell the Cloth object that you want it to 
participate in collisions. For the cloth object, locate the Cloth 


Collision panel. 


Quality 
A general setting for how fine and good a simulation you 


wish. Higher numbers take more time but ensure less 
tears and penetrations through the cloth. 


Object Collisions 


If the cloth object needs to be deflected by some other 
object. To deflect a cloth, the object must be enabled as an 
object that collides with the cloth object. To enable objects 
to collide with cloth objects enable collision physics for the 
collider object (not on the cloth object). 


Note 


If your colliding object is not a mesh object, such as a 
NURBS surface, or a text object, you must convert it to a 
mesh object using Convert. 


Distance 
The distance another object must get to the cloth for the 
simulation to repel the cloth out of the way. Smaller 
values might give errors but gives some speed-up while 
larger will give unrealistic results if too large and can be 
Slow. It is best to find a good in between value. 


Impulse Clamping 
Prevents explosions in tight and complicated collision 
situations by restricting the amount of movement after a 
collision. 


Vertex Group 
Faces that have all vertices assigned to this Vertex Group 
are excluded from collision with objects. 


Collision Collection 
Only objects that are a part of this Collection can collide 
with the cloth. Note that these objects must also have 
Collision physics enabled. 


Self-Collisions 


Real cloth cannot penetrate itself, so you normally want the 
cloth to self-collide. Enable this to tell the cloth object that it 
should not penetrate itself. This adds to the simulation’s 
compute time, but provides more realistic results. 


Tip 


A flag, viewed from a distance does not need this enabled, 
but a close-up of a cape or blouse on a character should 
have this enabled. 


Friction 
A coefficient for how slippery the cloth is when it collides 
with itself. For example, silk has a lower coefficient of 
friction than cotton. 


Distance 
As cloth at this distance begins to repel away from itself. 
Smaller values might give errors but gives some speed- 
up while larger will give unrealistic results if too large and 
can be slow. It is best to find a good in between value. 


Impulse Clamping 
Prevents explosions in tight and complicated collision 
situations by restricting the amount of movement after a 
collision. 


Vertex Group 
Faces that have all vertices assigned to this Vertex Group 
are excluded from self-collision. 


See also 


Example blend-file: Cloth self-collisions. 


Troubleshooting 


If you encounter some problems with collision detection, 
there are a few ways to fix them: 


e The fastest solution is to increase the Distance for 
Object/Self Collisions. This will be the fastest way to fix 
the clipping; however, it will be less accurate and will 
not look as good. Using this method tends to make it 
look like the cloth is resting on air, and gives it a very 
rounded look. 

e Asecond method is to increase the Quality (in the Cloth 

panel). This results in smaller steps for the simulator 

and therefore to a higher probability that fast-moving 
collisions get caught. You can also increase the 

Collisions Quality to perform more iterations to get 

collisions solved. 

If none of the methods help, you can easily edit the 

cached/baked result in Edit Mode afterwards. 

If the Cloth is torn by the deforming mesh; increase the 

stiffness settings. 


Property Weights 


Reference 


Panel: Physics >» Cloth > Property Weights 


This panel is used to constrain certain cloth properties to a 
certain vertex group. The properties that they control can be 
found in a combination of the Physical Properties and Shape 
panels. 


Structural Group 
Defines a vertex group to control over structural 
stiffness. 


Max Tension 
Maximum tension stiffness value. 


Max Compression 
Maximum Compression stiffness value. 


Shear Group 
Vertex group for fine control over shear stiffness. 


Max Shearing 
Maximum shear scaling value. 


Bending Group 
Vertex group for fine control over bending stiffness. 


Max Bending 
Maximum bending stiffness value. 


Shrinking Group 


Vertex group for shrinking cloth. 


Max Shrinking 
Max amount to shrink cloth by, specifying a negative 
value controls the max amount for the cloth to grow. 


Field Weights 


Reference 


Panel: Physics >» Cloth > Field Weights 


As other physics dynamics systems, Cloth simulation is also 
influenced by external force effectors. 


Examples 


To start with cloth, the first thing you need, of course, is 
some fabric. So, let us delete the default cube and adda 
plane. In order to get some good floppy and flexible fabric, 
you will need to subdivide it several times, about eight is a 
good number. So Tab into Edit Mode and subdivide the mesh 
a couple of times. 


Now, we will make this cloth by going to the Physics tab. 
Scroll down until you see the Cloth panel, and press the 
Cloth button. Now, a lot of settings will appear, most of 

which we will ignore for now. 


That is all you need to do to set your cloth up for animating, 
but if you playback the animation, the drop of your newly 
created fabric will be quite unspectacular. That is what we 
will cover in the next two sections about pinning and 
colliding. 


Using Simulation to 
Shape/Sculpt a Mesh 


You can Apply the Cloth Modifier at any point to freeze the 
mesh in position at that frame. You can then re-enable the 
cloth, setting the start and end frames from which to run the 
simulation forward. 


Another example of aging is a flag. Define the flag as a 
simple grid shape and pin the edge against the flagpole. 
Simulate for 50 frames or so, and the flag will drop to its 
“rest” position. Apply the Cloth Modifier. If you want the flag 


to flap or otherwise move in the scene, re-enable it for the 
frame range when it is in camera view. 


Smoothing of Cloth 


Now, if you followed this from the previous section, your 
cloth is probably looking a little blocky. In order to make it 
look nice and smooth like the picture you need to apply a 
Smooth and/or Subdivision Surface Modifier in the Modifiers 
tab. Then, in the Toolbar, find the Edit panel and Press 
Smooth. 


Cloth on Armature 


Clothing can be simulated and pinned to an armature. For 
example, a character could have a baggy tunic pinned to 
the character’s waist with a belt. 


The typical workflow for pinning: 


1. Set the armature to its bind pose. 

2. Model clothing that encloses but does not penetrate the 
character’s mesh. 

3. Parent the clothing objects to the armature. The 
armature will now have several child meshes bound to 
it. 

4. Create a new vertex group on each cloth object for its 
pinned vertices. 

5. Add vertices to be pinned to this vertex group and give 
these vertices nonzero weights (you probably want 
weight = 1). For example the belt area of the tunic 
would be in the vertex group and have weight one. 

6. Designate the clothing objects as “cloth” in the Physics 
tab of the Properties. Make sure the Cloth Modifier is 


below the Armature Modifier in the modifier stack. 

. In the cloth Shape panel select the vertex group. 

. Add collision physics to the character’s mesh. 

. The clothing is now ready; non-pinned vertices will be 
under control of the Cloth modifier. Pinned vertices will 
be under control of the Armature modifier. 


WO CO ~N 


Note 


When animating or posing the character you must begin 
from the bind pose. Move the character to its initial pose 
over several frames so the physics engine can simulate 
the clothing moving. Very fast movements and teleport 
jumps can break the physics simulation. 


Regression blend-file. 


Cloth with Animated Vertex 
Groups 


Cloth with animated pinned vertices: Regression blend-file. 
Unsupported: Starting with a goal of 0 and increasing it, but 
still having the vertex not pinned will not work (e.g. from 
goal = 0 to goal = 0.5). 


Cloth with Dynamic Paint 


Cloth with Dynamic Paint using animated vertex groups: 
Regression blend-file. Unsupported: Starting with a goal of 0 
and increasing it, but still having the vertex not pinned will 
not work (e.g. from goal = 0 to goal = 0.5) because the 
necessary “goal springs” cannot be generated on-the-fly. 


Using Cloth for Soft Bodies 
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Using cloth for soft bodies. 


Cloth can also be used to simulate soft bodies. It is for sure 
not its main purpose but it works nonetheless. The example 


image uses standard Rubber material, no fancy settings, 
just Alt-A. 


Blend-file for the example image: Using Cloth for soft 
bodies. 


Cloth with Wind 


Flag with wind applied. 


Regression blend-file for Cloth with wind and self-collisions 


(also the blend for the image above): Cloth flag_with wind 
and self-collisions. 


Soft Body 
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Introduction 


Soft body simulation is used for simulating soft deformable 
objects. It was designed primarily for adding secondary 
motion to animation, like jiggle for body parts of a moving 
character. 


It also works for simulating more general soft objects that 
bend, deform and react to forces like gravity and wind, or 
collide with other objects. 


While it can simulate cloth and other stiff types of 
deformable objects to an extent, the Cloth Simulation can 
do it better with a solver specifically designed for this 
purpose. 


The simulation works by combining existing animation on 
the object with forces acting on it. There are exterior forces 
like gravity or force fields and interior forces that hold the 
vertices together. This way you can simulate the shapes 
that an object would take on in reality if it had volume, was 
filled with something, and was acted on by real forces. 


Soft bodies can interact with other objects through Collision. 
They can interact with themselves through Sel/f-Collision. 


The result of the soft body simulation can be converted to a 
static object. You can also bake edit the simulation, i.e. edit 
intermediate results and run the simulation from there. 


Typical Scenarios for using Soft 
Bodies 


The wind cone is a soft body, as the suspension. 
Animation 
Soft bodies are well suited for: 


e Jiggle on moving characters. 

Elastic and deformable objects made of materials like 

rubber or gelatin. 

e Tree branches moving in the wind, swinging ropes, and 
the like. 

e Flags, wide sleeves, cushions or other simple fabric 
reacting to forces. 


The following videos may give you some more ideas: 


e https://www.youtube.com/watch?v=hLnY-OFUBZM 
e https://www.youtube.com/watch?v=qdusMZIBbQ4 


Creating a Soft Body 


Soft body simulation works for all objects that have vertices 
or control points (meshes, curves, surfaces, and lattices). 


To add a soft body simulation to an object, go to the Physics 
tab (bouncing ball icon) in the Properties and activate the 
Soft Body button. For a reference of all the settings see this 
page. 


You start a soft body simulation by playback animation with 
Alt-A, and stop the simulation with Esc or Alt-A. 


Interaction in Real-Time 


To work with a soft body simulation, you will find it handy to 
use the Timeline editor. You can change between frames 
and the simulation will always be shown in the actual state. 
You can interact in real-time with the simulation, e.g. by 
moving collision objects or shaking a soft body object. 


You can then select the soft body object while running the 
simulation and Apply the modifier in the Modifiers tab of the 
Properties. This makes the deformation permanent. 


Tips 


e Soft bodies work especially well if the objects have an 
even vertex distribution. You need enough vertices for 
good collisions. You change the deformation (the 
stiffness) if you add more vertices in a certain region. 

e The calculation of collisions may take a long time. If 
something is not visible, why calculate it? 

e To speed up the collision calculation it is often useful to 

collide with an additional, simpler, invisible, somewhat 

larger object. 

Use soft bodies only where it makes sense. If you try to 

cover a body mesh with a tight piece of cloth and 

animate solely with soft body, you will have no success. 


Self-collision of soft body hair may be activated, but that 
is a path that you have to wander alone. We will deal 
with Collisions in detail later. 

e Try and use a Lattice or a Curve Guide soft body instead 
of the object itself. This may be magnitudes faster. 


Settings 


Reference 


Panel: Physics >» Soft Body 


Collision Collection 
If set, soft body collides with objects from the collection, 
instead of using objects that are on the same layer. 
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Object 


Friction 
The friction of the surrounding medium. Generally friction 
dampens a movement. The larger the friction, the more 
viscous is the medium. Friction always appears when a 
vertex moves relative to its surround medium. 


Mass 
Mass value for vertices. Larger mass slows down 
acceleration, except for gravity where the motion is 
constant regardless of mass. Larger mass means larger 
inertia, so also braking a soft body is more difficult. 


Control Point 
You can paint weights and use a specified vertex group 
for mass values. 


Simulation 


Speed 
You can control the internal timing of the soft body 
system with this value. It sets the correlation between 
frame rate and tempo of the simulation. A free falling 
body should cover a distance of about five meters after 
one second and travel at a speed of ten meters per 
seconds. 


You can adjust the scale of your scene and simulation 
with this correlation. If you render with 25 frames per 
second, you will have to set Speed to 1.3. 


Cache 


Reference 


Panel: Physics >» Soft Body >» Cache 


Soft Body physics simulations use a unified system for 
caching and baking. See Particle Cache and General Baking 
documentation for reference. 


Goal 


Reference 


Panel: Physics >» Soft Body » Goal 


Enabling this tells Blender to use the motion from 
animations (F-Curves, armatures, parents, lattices, etc.) in 
the simulation. The “goal” is the desired end position for 
vertices based on this animation. 


See exterior forces for details. 


Vertex Group 
Use a vertex group to allow per-vertex goal weights 
(multiplied by the Default goal). 


Settings 


Stiffness 
The spring stiffness for Goal. A low value creates very 
weak springs (more flexible “attachment” to the goal), a 
high value creates a strong spring (a stiffer “attachment” 
to the goal). 


Damping 
The friction coefficient for Goa/. Higher values give 
damping of the spring effect (little jiggle), and the 
movement will soon come to an end. 


Strengths 


Default 
Goal weight/strength for all vertices when no Vertex 
Group is assigned. If you use a vertex group the weight 
of a vertex defines its goal. 


Min/Max 
When you use a vertex group, you can use the Minimum 
and Maximum to fine-tune (clamp) the weight values. 
The lowest vertex weight will become Minimum, the 
highest value becomes Maximum. 


Edges 


Reference 


Panel: Physics » Soft Body » Edges 


Allow the edges in a mesh object to act like springs. See 
interior forces. 


Springs 
Use a specified vertex group for spring strength values. 


Pull 
The spring stiffness for edges (how much the edges are 
allowed to stretch). A low value means very weak springs 
(a very elastic material), a high value is a strong spring 
(a stiffer material) that resists being pulled apart. 


A value of 0.5 is latex, 0.9 is like a sweater, 0.999 isa 
highly-starched napkin or leather. The soft body 
Simulation tends to get unstable if you use a value of 
0.999, so you should lower this value a bit if that 
happens. 


Push 


How much the soft body resists being scrunched 
together, like a compression spring. Low values for fabric, 
high values for inflated objects and stiff material. 


Damp 


The friction for edge springs. High values (max of 50) 
dampen the Push/Pull effect and calm down the cloth. 


Plasticity 


Permanent deformation of the object after a collision. The 
vertices take a new position without applying the 
modifier. 


Bending 
This option creates virtual connections between a vertex 
and the vertices connected to its neighbors. This includes 
diagonal edges. Damping also applies to these 
connections. 


Length 
The edges can shrink or be blown up. This value is given 
in percent, O disables this function. 100% means no 
change, the body keeps 100% of its size. 


Collision Edge 
Checks for edges of the soft body mesh colliding. 


Face 


Checks for any portion of the face of the soft body mesh 
colliding (which is computationally intensive). While Face 
enabled can solve collision errors, there does not seem to 
be any dampening settings for it. So parts of the soft 
body object near a collision mesh tend to “jitter” as they 
bounce off and fall back, even when there is no motion of 
any meshes. Edge collision has dampening, so that can 
be controlled, but Deflection dampening value ona 
collision object does not seem to affect the face collision. 


Aerodynamics 


Force from surrounding media. See exterior forces for 
details. 


Type 


Simple 
Edges receive a drag force from the surrounding 
media. 


Lift Force 
Edges receive a lift force when passing through the 
surrounding media. 


Factor 
How much aerodynamic force to use. Try a value of 30 at 


first. 


Stiffness 


For quad faces, the diagonal edges are used as springs. This 
stops quad faces to collapse completely on collisions (what 
they would do otherwise). 


Shear 
Stiffness of the virtual springs created for quad faces. 


Self Collision 


Reference 
Panel: Physics >» Soft Body » Self Collision 
Note 


Self-Collision is working only if you have activated Use 
Edges. 


When enabled, allows you to control how Blender will 
prevent the soft body from intersecting with itself. Every 
vertex is surrounded with an elastic virtual ball. Vertices 
may not penetrate the balls of other vertices. If you want a 
good result you may have to adjust the size of these balls. 
Normally it works pretty well with the default options. 


Calculation Type 
Manual 
The Ball Size directly sets the ball size. 


Average 
The average length of all edges attached to the vertex 
is calculated and then multiplied with the Ball Size 
setting. Works well with evenly distributed vertices. 


Minimal/Maximal 
The ball size is as large as the smallest/largest spring 
length of the vertex multiplied with the Ball/ Size. 


Average Min Max 
Size = ((Min + Max)/2) x Ball Size. 


Ball Size 
Fraction of the length of attached edges. The edge length 
is computed based on the chosen algorithm. This setting 
is the factor that is multiplied by the spring length. It is a 
spherical distance (radius) within which, if another vertex 
of the same mesh enters, the vertex starts to deflect in 
order to avoid a self-collision. 


Set this value to the fractional distance between vertices 
that you want them to have their own “space”. Too high 
of a value will include too many vertices at all times and 
slow down the calculation. Too low of a level will let other 
vertices get too close and thus possibly intersect 
because there will not be enough time to slow them 
down. 


Stiffness 
How elastic that ball of personal space is. A high stiffness 
means that the vertex reacts immediately to another 
vertex enters their space. 


Dampening 
How the vertex reacts. A low value just slows down the 
vertex as it gets too close. A high value repulses it. 


Note 


Collisions with other objects are set in the (other) Collision 
panel. To collide with another object they have to share at 
least one common layer. 


Solver 


Reference 


Panel: Physics » Soft Body > Solver 


The settings in the Soft Body Solver panel determine the 
accuracy of the simulation. 


Step Size Min 
Minimum simulation steps per frame. Increase this value, 
if the soft body misses fast-moving collision objects. 


Max 
Maximum simulation steps per frame. Normally the 
number of simulation steps is set dynamically (with the 
Error Limit) but you have probably a good reason to 
change it. 


Auto-Step 
Use velocities for automatic step sizes. Helps the Solver 
figure out how much work it needs to do based on how 
fast things are moving. 


Error Limit 
Rules the overall quality of the solution delivered. The 
most critical setting that defines how precise the solver 
Should check for collisions. Start with a value that is half 
the average edge length. If there are visible errors, jitter, 
or over-exaggerated responses, decrease the value. The 
solver keeps track of how “bad” it is doing and the Error 
Limit causes the solver to do some “adaptive step 
SIZiINg”. 


Diagnostics 


Print Performance to Console 
Prints on the console how the solver is doing. 


Estimate Matrix 
Estimate matrix, split to COM, ROT, SCALE. 


Helpers 


These settings control how the soft body will react (deform) 
once it either gets close to or actually intersects (cuts into) 
another collision object on the same layer. 


Choke 
Calms down (reduces the exit velocity of) a vertex or 
edge once it penetrates a collision mesh. 


Fuzzy 
Fuzziness while on collision, high values make collision 
handling faster but less stable. Simulation is faster, but 
less accurate. 


Forces 
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Exterior 


Exterior forces are applied to the vertices (and nearly 
exclusively to the vertices) of soft body objects. This is done 
using Newton's Laws of Physics: 


e If there is no force on a vertex, it stays either unmoved 
or moves with constant speed in a straight line. 

e The acceleration of a vertex depends on its mass and 
the force. The heavier the mass of a vertex the slower 
the acceleration. The larger the force the greater the 
acceleration. 

e For every action there is an equal and opposite reaction. 


Well, this is done only in the range of computing 
accurateness, there is always a little damping to avoid 
overshoot of the calculation. 


Example 


We will begin with a very simple example: the default cube. 


e To judge the effect of the external forces you should at 
first turn off the Goal, so that the vertices are not 
retracted to their original position. 

e Start playback to run the simulation. 


What happens? The cube moves in negative Z direction. 
Each of its eight vertices is affected by a global, constant 
force - the gravitation. Gravitation without friction is 
independent from the weight of an object, so each object 
you would use as a soft body here would fall with the same 


acceleration. The object does not deform, because every 
vertex moves with the same speed in the same direction. 


Force Fields 


Soft body vertices interact with all the Force Fields applied 
(usually to particles) in the layer, such as wind, force fields, 
and what ever physics field effect is on a common layer. 


Soft Body Field Weights 


Reference 


Panel: Physics >» Soft Body » Field Weights 


The Soft Body Field Weights panel allows you to control how 
much influence each type of external force field has on the 
soft body system. 


Effector Collection 
Limit effectors to a specified group. Only effectors in this 
group will have an effect on the current system. 


Gravity 
Control how much the Global Gravity has an effect on the 
system. 


All 
Scale all of the effector weights. 


Aerodynamics 


Edges can be affected by wind as they move, and sail or 
flutter in a breeze. A simple aerodynamic model of a flag 
sailing in the wind. 


This special exterior force is not applied to the vertices but 
to the connecting edges. Technically, a force perpendicular 
to the edge is applied. The force scales with the projection 
of the relative speed on the edge (dot product). Note that 
the force is the same if wind is blowing or if you drag the 
edge through the air with the same speed. That means that 
an edge moving in its own direction subject to no force, and 
an edge moving perpendicular to its own direction is 
Subjected to maximum force. 


The angle and the relative speed between medium and 
edge is used to calculate the force on the edge. This force 
results that vertices with few connecting edges (front of a 
plane) fall faster than vertices with more connecting edges 
(middle of a plane). If all vertices have the same amount of 
edges in a direction they fall with equal speed. 


The Aerodynamics settings are set in the Soft Body Edges 
panel. 


Goal 


A “goal” is a shape that a soft body object tries to conform 
to. It acts like a pin on a chosen set of vertices, controlling 
how much of an effect soft body has on them. 


Enabling Soft Body Goal tells Blender to use the position (or 
animated position) of a vertex in the simulation. Animating 
the vertices can be done in all the usual ways (F-Curves, 
armatures, parents, lattices, etc.) before the soft body 
simulation is applied. The “goal” is the desired end position 


for vertices. How a soft body tries to achieve this goal can 
be defined using stiffness forces and damping. 


See the Soft Body Goal settings for details. 
Goal Strength 


The Goal Strength defines how much motion from an 
animation system gets applied. 


A Goal value of 1.0 means no soft body simulation, the 
object act like any regular animated object (i.e. the vertex is 
kept at its original position). When setting Goal to 0.0 (or no 
goal), the vertex is only influenced by physical laws 
according to soft body simulation. 


By setting goal values between 0.0 and 1.0, you can blend 
between having the object affected only by the animation 
system, and having the object affected only by the soft 
body effect. 


Goal also serves as a memory, to make sure soft objects 
don’t deform too much, ending up in the non-soft animated 
Shape. Using the Vertex Group weight system, you can 
define a Goal weight per vertex. To make this look more 
natural, spring forces can be defined to control how far 
vertices can move from their original position. 


Often Weight Paint is used to adjust the weight comfortably. 
For non-mesh objects the Weight parameter of their 
vertices/control points is used instead; Use the Context 
menu in Edit Mode or the Transform panel in the Sidebar 
region. The weight of Hair particles can also be painted in 
Particle Edit Mode. 


Technical Details 


In the Soft Body world, vertices of meshes are treated as 
particles having a mass. Their movement is determined by 
the forces affecting them. Beside other forces the individual 
particles can interact with another along edges using a 
physical model which is very close to shock absorbers used 
in cars. The working parts are: 


e A spring trying to keep the particles at a certain 
distance. How hard the spring tries to do that is 
controlled by the soft body parameter Stiffness. 

e A damping element to calm the movement down. The 
resistance the element builds up against motion is 
controlled by the soft body parameter Damping. 


Interior 


In between each neighboring vertex of a mesh, you typically 
create edges to connect them. Imagine each edge as a 
spring. Any mechanical spring is able to stretch under 
tension, and to squeeze under pressure. All springs have an 
ideal length, and a stiffness that limits how far you can 
stretch or squeeze the spring. 


In Blender’s case, the ideal length is the original edge 
length which you designed as a part of your mesh, even 
before you enable the Soft Body system. Until you add the 
Soft Body physics, all springs are assumed to be perfectly 
stiff: no stretch and no squeeze. 


You can adjust the stiffness of all those edge springs, 
allowing your mesh to sag, to bend, to flutter in the breeze, 
or to puddle up on the ground. 


To create a connection between the vertices of a soft body 
object there have to be forces that hold the vertices 
together. These forces are effective along the edges ina 
mesh, the connections between the vertices. The forces act 
like a spring. Fig. Vertices and forces along their connection 
edges. illustrates how a 3X3 grid of vertices (a mesh plane 
in Blender) are connected in a soft body simulation. 


Vertices and Additional forces 


forces along their with Stiff Quads 
connection enabled. 
edges. 


But two vertices could freely rotate if you do not create 
additional edges between them. The logical method to keep 
a body from collapsing would be to create additional edges 
between the vertices. This works pretty well, but would 
change your mesh topology drastically. 


Luckily, Blender allows to define additional virtual 
connections. On one hand you can define virtual 
connections between the diagonal edges of a quad face 
(Stiff Quads Fig. Additional forces with Stiff Quads enabled.), 
on the other hand you can define virtual connections 
between a vertex and any vertices connected to its 
neighbors’ Bending Stiffness. In other words, the amount of 
bend that is allowed between a vertex and any other vertex 
that is separated by two edge connections. 


Settings 


The characteristics of edges are set with the Springs and 
Stiff Quads properties in the Soft Body Edges panel. See the 


Soft Body Edges settings for details. 


Tips: Preventing Collapse 


Stiff Quads 


To show the effect of the different edge settings we will use 
two cubes (blue: only quads, red: only tris) and let them fall 
without any goal onto a plane (how to set up collision is 
shown on the page Collisions). See the example blend-file. 


Without Stiff Quads. 


Frame 


Frame 1. Frame 36. AOL. 


In Fig. Without Stiff Quads., the default settings are used 
(without Stiff Quads). The “quad only” cube will collapse 
completely, the cube composed of tris keeps its shape, 
though it will deform temporarily because of the forces 
created during collision. 


With Stiff Quads. 


Ad aa 


Frame 1. Frame 36. 


Frame 
401. 


In Fig. With Stiff Quads., Stiff Quads is activated (for both 
cubes). Both cubes keep their shape, there is no difference 
for the red cube, because it has no quads anyway. 


Bending Stiffness 


The second method to stop an object from collapsing is to 
change its Bending stiffness. This includes the diagonal 
edges (damping also applies to these connections). 


Bending Stiffness. 
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Frame 1. Frame 36. AOL. 


In Fig. Bending _Stiffness., Bending is activated with a 
strength setting of 1. Now both cubes are more rigid. 


- & 4 
Two planes No High 
going to bending bending 


collide. stiffness. 


stiffness 
(10). 


Bending stiffness can also be used if you want to make a 
subdivided plane more plank like. Without Bending the faces 
can freely rotate against each other like hinges Fig. No 
bending_stiffness.. There would be no change in the 
simulation if you activated Stiff Quads, because the faces 
are not deformed at all in this example. 


Bending stiffness is the strength needed for the plane to be 
deformed. 


Collision 


There are two different collision types that you may use: 
collision between different objects and internal collision. We 
should set one thing straight from the start - the primary 
targets of the collision calculation are the vertices of a soft 
body. So if you have too few vertices too few collision takes 
place. Secondarily, you can use edges and faces to improve 
the collision calculation. 


Collisions with Other Objects 


For a soft body to collide with another object there are a few 
prerequisites: 


e If Collision Collection is set, the object must belong to 
the collection. 

e The collision object has to be a mesh object. 

e You have to activate the Collision in the Physics tab for 
the collision object. The collision object may also be a 
soft body. 


Examples 


A soft body cube colliding with a plane (Fig. A soft body cube 
colliding with a plane.) works pretty well, but a soft body 
plane falls right through a cube that it is supposed to collide 
with (Fig. A soft body plane colliding _with a cube, so no 
interaction at all.). 


| 
re 
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A soft body cube A soft body plane 
colliding with a colliding with a 
plane. cube, so no 


interaction at all. 


Why is that? Because the default method of calculation only 
checks to see if the four vertices of the soft body plane 
collides with the cube as the plane is pulled down by gravity. 
You can activate Collision: Face (in the Soft Body Edges 
panel) to enable collision between the face of the plane and 
the object instead, but this type of calculation takes much 
longer. 


Let us have a closer look at the collision calculation, so you 
can get an idea of how we might optimize it. 


Calculating Collisions 


Soft body simulations are by default done on a per-vertex 
basis. If the vertices of the soft body do not collide with the 
collision object, there will be no interaction between the two 
objects. 


In the video below, you can see the vertices colliding with a 
plane. If a vertex penetrates the zone between Outer and 
Inner, it is repulsed by a force in the direction of the face 
normal. The position that a vertex finally ends up in is 


dependent on the forces that act upon it. In the example 
(the first vertex on the left in the video below) gravity and 
the repulsion force of the face balance out. The speed at 
which the vertex is pulled out of the collision zone is 
influenced by the Choke parameter in the Soft Body Solver 
settings. 


See also 


Download the blend-file. 


Now let’s see what happens if we make vertices heavier and 
let them travel at a faster speed. In the video above, you 
can see vertices traveling at different soeeds. The two on 
the far right (fifth and sixth) are traveling so fast that they 
pass right through the collision zone (this is because of the 
default solver precision, which we can fix later). You will 
notice that the fourth vertex also travels quite fast and 
because it is heavier it breaches the inner zone. The first 
three vertices collide correctly. 


You can set up your collision so that edges and even faces 
are included in the collision calculation in the Soft Body 
Edges panel with the Collision Face and Edge options. The 
collision is then calculated differently. It is checked whether 
the edge or face intersects with the collision object, the 
collision zones are not used. 


Good Collisions 


If the collision you have set up is not behaving properly, you 
can try the following: 


e The soft body object must have more subdivisions than 
the collision object. Add loop cuts to the soft body object 
in strategic areas that you know are most likely to be 
involved in a collision. 

Check the direction of the face normals. 

If the collision object has sharp spikes, they might 

penetrate the soft body. 

e The resolution of the solver must match the speed at 
which soft body vertices are traveling. Lower the 
parameter Error Limit and carefully increase Min Step. 

e Outer and Inner should be large enough, but zones of 

opposite faces should not overlap, or you have forces in 

opposite directions. 

If you use strong forces you should use large zones. 

e Set Choke to a high enough value (all the way up if 

necessary) if you have difficulties with repelled vertices. 

Colliding faces are difficult to control and need long 

calculation times. Try not to use them. 


Often it is better to create a simplified mesh to use as your 
collision object, however, this may be difficult if you are 
using an animated mesh. 


Self-Collisions 


For information on self-collision please refer to the Self- 
Collision settings. 


Examples 


Here are some simple examples showing the power of soft 
body physics. 


A Bouncing Cube 


The Process 


First, change your start and end frames to 1 and 150. 


Then, add a plane, and scale it five times. Next, go to the 
physics tab, and add a collision. The default settings are fine 
for this example. 


Now add a cube, or use the default cube, then enter Edit 
Mode to subdivide it three times. Add a Bevel Modifier to it 
to smoothen the edges and then to add a little more, press R 
twice, and move your cursor a bit. 


When finished, your scene should look like this: 


The scene, ready for soft body physics. 


Everything is ready to add the soft body physics. Go to 
Properties » Physics and choose Soft Body. Uncheck the Soft 
Body Goal, and check Soft Body Self Collision. Also, under 
Soft Body Edges, increase the Bending to 10. 


Playing the animation will now give a slow animation of a 
bouncing cube. To speed things up, we need to bake the soft 
body physics. 


Under Soft Body Cache change the values of your start and 
end frames. In this case 1 and 150. Now, to test if 
everything is working, you can take a cache step of 5 or 10, 
but for the final animation it is better to reduce it to 1, to 
cache everything. 


You can now bake the simulation, give the cube materials 
and textures and render the animation. 


The Result 


Ihe rendered bouncing_cube 
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Introduction 


Liquid Simulations 


Fluid physics are used to simulate physical properties of 
liquids especially water. While creating a scene in Blender, 
certain objects can be marked to become a part of the fluid 
Simulation. For a fluid simulation you have to have a domain 
to define the space that the simulation takes up. In the 
domain settings you will be able to define the global 
simulation parameters (such as viscosity and gravity). 


Example of a liquid simulation. 


Gas Simulations 


Gas or smoke simulations are a subset of the fluids system, 
and can be used for simulating collections of airborne solids, 


liquid particulates and gases, such as those that make up 
smoke. It simulates the fluid movement of air and generates 
animated Voxel textures representing the density, heat, and 
velocity of other fluids or suspended particles (e.g. smoke) 
which can be used for rendering. 


Example of a fire simulation. 


Gases or smoke are emitted inside of a Domain from a mesh 
object or particle system. The smoke movement is 
controlled by airflow inside the domain, which can be 
influenced by Effector objects. Smoke will also be affected 
by the scene’s gravity and force fields. Airflow inside the 
domain can affect other physics simulations via the Fluid 
Flow force field. 


Workflow 


At least a Domain object and one Flow object are required to 
create a fluid simulation. 


. Create a Domain object that defines the bounds of the 


simulation volume. 


. Set up Flow objects which will emit fluid. 
. Set up Effector objects to make the fluid interact with 


objects in the scene. 


4. Assign a material to the domain object. 
5. 
6. Bake the Cache for the simulation. 


Save the blend-file. 


Note 


There are Quick Liguid and Quick Smoke tools which will 
automatically create a domain object with a basic liquid or 
smoke and fire material. 
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Settings 


Reference 
Panel: Physics » Fluid » Settings 
Type: Domain 


The domain object contains the entire simulation. Fluid 
simulations cannot leave the domain, it will either collide 
with the edge or disappear, depending on the domain’s 
settings. 


Keep in mind that large domains need higher resolutions 
and longer bake times. You will want to make it just large 
enough that the simulation will fit inside it, but not so large 
that it takes too long to compute the simulation. 


To create a domain, add a cube and transform it until it 
encloses the area where you want the simulation to take 
place. Translation, rotation, and scaling are all allowed. To 
turn it into a fluid domain, click Fluid in the Properties > 
Physics tab, then select Domain as the fluid Type. 


Note 


You can use other shapes of mesh objects as domain 
objects, but the fluid simulator will use the shape’s 
Bounding Box as the domain bounds. In other words, the 
actual shape of the domain will still be rectangular. 


Domain Type 


A fluid domain can control either liquid or gas flows. 
Liquid domains take all liquid flow objects that intersect 
with the domain into consideration. Gas domains 
consider all intersecting Smoke, Fire, and Smoke & Fire 
flow objects. It is not possible to change the domain type 
dynamically. 


Resolution Divisions 
The fluid domain is subdivided into many “cells” called 
Voxels which make up “pixels” of fluid. This setting 
controls the number of subdivisions in the domain. 
Higher numbers of subdivisions are one way of creating 
higher resolution fluids. 


Since the resolution is defined in terms of “Subdivisions”, 
larger domains will need more divisions to get an 
equivalent resolution to a small domain. For example, a 
one meter cube with 64 Resolution Divisions will need 
128 divisions to match a 2 meter cube. The dimension 
used as the base division is the longest dimension of the 
objects bounding box. To help visualize the voxel size, the 
Resolution Divisions can be previewed with a small cube 
shown in the 3D Viewport, to show the size of these 
divisions. 


Time Scale 
Controls the speed of the simulation. Low values result in 
a “slow motion” simulation, while higher values can be 
used to advance the simulation faster (good for 
generating fluids to be used in still renders). 


CFL Number 
Determines the maximum velocity per grid cell and is 
measured in grid cells per time step. Fluid is only allowed 
to move up to this velocity in one time step. If this 


threshold is exceeded the solver will subdivide the 
simulation step. 


In general, greater CFL (Courant-Friedrichs-Lewy) 
numbers will minimize the number of simulation steps 
and the computation time. Yet it will yield less physically 
accurate behavior for fast fluid flows. Smaller CFL 
numbers result in more simulation steps per frame, 
longer simulation times but more accurate behavior at 
high velocities (e.g. fast fluid flow colliding with 
obstacle). 


Note 


When lowering the CFL number it is recommended to 
increase the maximum number of time steps. Similarly, 
when increasing the CFL number the minimum number of 
time steps should be adjusted. 


Use Adaptive Time Steps 
Lets the solver automatically decide when to perform 
multiple simulation steps per frame. It takes into account 
the maximum and minimum number of time steps, the 
current Frame Rate, and the Time Scale. 


Timesteps Maximum 
Maximum number of allowed time steps per frame. If 
needed, the solver will divide a simulation step up to this 
number of sub-steps. 


Timesteps Minimum 
Minimum number of allowed time steps per frame. The 
solver will always perform at least this number of 
simulation steps per frame. 


Gravity 
By default the fluid solver will use the global scene 
gravity. This behavior can be disabled in the scene 
settings. Disabling the global gravity will enable the fluid 


gravity options. 


Empty Space Gas Only 
Voxels with values under this value are considered empty 


space. More empty space optimizes rendering. With 
OpenVDB caching it also reduces cache sizes. 


Delete in Obstacle 


Remover any volume of fluid that intersects with an 
obstacle inside the domain. 


Border Collisions 


Reference 

Panel: Physics >» Fluid » Settings » Border 
Collisions 

Type: Domain (Gas) 


Controls which sides of the domain will allow fluid “pass 
through” the domain, making it disappear without 
influencing the rest of the simulation, and which sides will 


deflect fluids. 
Smoke 


Reference 


Panel: Physics » Fluid » Settings » Smoke 
Type: Domain (Gas) 


Buoyancy Density 
Buoyant force based on smoke density. 


e Values above 0 will cause the smoke to rise 
(simulating smoke which is lighter than ambient air). 

e Values below 0 will cause smoke to sink (simulating 
smoke which is heavier than ambient air). 


Buoyancy Heat 
Controls how much smoke is affected by temperature. 
The effect this setting has on smoke depends on the per 
flow object Initial Temperature: 


e Values above 0 will result in the smoke rising when 
the flow object /nitial Temperature is set to a positive 
value, and smoke sinking when the flow object /nitial 
Temperature is set to a negative value. 

Values below 0 will result in the opposite of positive 
values, i.e. smoke emitted from flow objects with a 
positive /nitial Temperature will sink, and smoke from 
flow objects with a negative /nitial Temperature will 
rise. 


Note that smoke from multiple flow objects with different 
temperatures will mix and warm up or cool down until an 
equilibrium is reached. 


Vorticity 
Controls the amount of turbulence in the smoke. Higher 
values will make lots of small swirls, while lower values 
make smoother shapes. 


Comparison of different amounts of vorticity. 


Domain with a Domain with a 
vorticity of 0.0. vorticity of 0.2. 


Dissolve 


Allow smoke to dissipate over time. 


Time 
Speed of smoke’s dissipation in frames. 


Slow 


Dissolve smoke in a logarithmic fashion. Dissolves 
quickly at first, but lingers longer. 


Fire 


Reference 


Type: Domain 


Panel: Physics » Fluid » Settings » Fire 


Reaction Speed 
How fast fuel burns. Larger values result in smaller 
flames (fuel burns before it can go very far), smaller 
values result in larger flames (fuel has time to flow 
farther before being fully consumed). 


Flame Smoke 
Amount of extra smoke created automatically to simulate 


burnt fuel. This smoke is best visible when using a “Fire + 
Smoke” Flow Object. 


Vorticity 
Vorticity for flames in addition to the global fluid Vorticity. 


Temperature Maximum 


Maximum temperature of flames. Larger values result in 
faster rising flames. 


Minimum 
Minimum temperature of flames. Larger values result in 
faster rising flames. 


Flame Color 
Color of flame created by burnt fuel. 


Liquid 
Reference 


Type: Domain 
Panel: Physics » Fluid » Settings » Liquid 


Liquid settings control the behavior of the particles which 
the simulation consists of. Enabling the liquid checkbox will 
automatically create a particle system for the simulation. 
This particle system visualizes the flow of the simulation. 
Visualizing the liquid particles is optional. The fluid 
simulation will make use of all the fields without an attached 
particle system too. 


Note 


Disabling the liquid checkbox will delete the attached 
particle system and its settings. 


Simulation Method 
Determines the liquid particle simulation method. 


FLIP 
Produces a very splashy simulation with lots of 
particles dispersed in the air. 


APIC 
Produces a very energetic but also more stable 
simulation. Vortices within the liquid will be preserved 
better than with FLIP. 


FLIP Ratio Simulation FLIP Only: 
How much FLIP velocity to use when updating liquid 
particle velocities. A value of 1.0 will result in a 
completely FLIP based simulation. Completely FLIP based 
simulations produce more chaotic splashes and are 
preferable when simulating greater quantities of liquid. 
When using smaller values the behavior will be less 
turbulent and splashes are more subtle. This is optimal 
when simulating scenes where the liquid is supposed to 
be on a small scale. 


System Maximum 
Maximum number of fluid particles that are allowed in 
the simulation. If this field is set to a nonzero value the 
simulation will never contain more than this number of 
fluid particles. Otherwise, with a value of zero the solver 
will always sample new particles when needed. 


Particle Radius 
The radius of one liquid particle in grid cells units. This 
value describes how much area is covered by a particle 
and thus determines how much area around it can be 
considered as liquid. A greater radius will let particles 
cover more area. This will result in more grids cell being 
tagged as liquid instead of just being empty. 


Whenever the simulation appears to leak or gain volume 
in an undesired, non physically accurate way it is a good 
idea to adjust this value. That is, when liquid seems to 
disappear this value needs to be increased. The inverse 
applies when too much liquid is being produced. 


Sampling 
Factor that is used when sampling particles. A higher 
value will sample more particles. Note that particle 
resampling occurs at every single simulation step. 


Randomness 
New particles are sampled with some randomness 
attached to their position which can be controlled by this 
field. Higher values will sample the liquid particles more 
randomly in inflow regions. With a value of 0.0 all new 
particles will be sampled uniformly inside their 
corresponding grid cells. 


When trying to create a laminar inflow (with little 
randomness) or more turbulent flows (with greater 


randomness) this value can be useful. 


Particles Maximum 
The maximum number of liquid particles per grid cell. 
During a simulation the number of liquid particles in a 
cell can fluctuate: Particles can flow into other cells or 
can get deleted if they move outside the narrow band. 
Resampling will add new particles considering this 
maximum. 


This value sets the upper threshold of particles per cell. It 
is also a good way to estimate how many particles there 
can be in your simulation (one needs to take grid 
resolution into account too). This can be useful before 
baking and when planning a simulation. 


Minimum 
The minimum number of liquid particles per grid cell. 
Similarly to the maximum particle threshold, this value 
ensures that there are at least a certain amount of 
particles per cell. 


Narrow Band Width 


Controls the width in grid cell units of the narrow band 
that liquid particles are allowed to flow in. A high value 
will result in a thicker band and can result in an inflow 
region completely filled with particles. Unless the goal of 
the simulation is to visualize the liquid particles it is 
recommended to not increase the band width 
significantly as more particles slow down the simulation. 


In some situations increasing this value can help create 
volume when the simulation appears to leak. In all other 
cases it is best to keep the narrow band as thin as 
possible since the liquid surface contains most details 


and simulating particles inside the liquid is not an 
optimal use of computing resources. 


See also 


The narrow band is an implementation of Narrow Band FLIP 
for Liquid Simulations. 


Fractional Obstacles 
Enables finer resolution in fluid / obstacle regions (second 
order obstacles). This option reduces the “stepping 
effect” that results when an obstacle lies inclined inside 
the domain. It also makes liquid flow more smoothly over 
an obstacle. 


Obstacle Distance 

Determines how far apart fluid and obstacles are. This 
value can be used to achieve a more fluid motion over 
inclined obstacles: Depending on the slope of the 
obstacle increasing this value can help liquid particles 
flow better over an obstacle. Setting this field to a 
negative value will let fluid move towards the inside of 
an obstacle. 


Obstacle Threshold 
Value to control the smoothness of the fractional 
obstacle option. Smaller value reduce the “stepping 
effect” but may result particles sticking to the 
obstacle. 


Bake Data, Free Data 
This option is only available when using the Modular 
cache type. Bake Data simulates and stores the base of 
the fluid simulation on drive. Both gas and liquid 
simulations can add refinements on top of this (e.g. gas 


simulations can add noise, liquid simulations can add a 
mesh or secondary particles or both). 


The progress will be displayed in the status bar. Pressing 
Esc will pause the simulation. 


Once the simulation has been baked, the cache can be 
deleted by pressing Free Data. It is possible to pause or 
resume a Bake All process. 


Gas Settings 


Adaptive Domain 
Noise 
Viewport Display 
o Slice 
Grid Display 
Vector Display 
Advanced Gridlines Only 


o Oo 0 


Adaptive Domain 


Reference 
Type: Domain 
Panel: Physics > Fluid » Adaptive Domain 


When enabled, the domain will adaptively shrink to best fit 
the gas, saving computation time by leaving voxels without 
gas out of the simulation. Unless the Add Resolution is used, 
the adaptive domain will not exceed the bounds of the 
original domain. 


Add Resolution 
Number of voxels to add around the outside of the 
domain. 


Margin 
Amount of extra space to leave around gas, measured in 
voxels. With very fast-moving gas larger margins may be 
required to prevent the gas from being cut off by the 
adaptive boundary, but note this will increase the 
number of voxels which need to be computed. 


Threshold 
Smallest amount of gas a voxel can contain before it is 
considered empty and the adaptive domain is allowed to 
cut it out of the simulation. 


Noise 


Reference 
Type: Domain 
Panel: Physics > Fluid » Noise 


Adding noise to the gas simulation creates a finer detailed 
looking simulation on top of the base. This makes it possible 
to add more details to gases (i.e. fire or smoke or both) 
without changing the overall fluid motion. 


See also 


Fluid noise is an implementation of Wavelet Turbulence for 
Fluid Simulation. 


Besides enabling parts of the interface, checking Noise lets 
the cache know which simulation data to read. If, for 
example, Noise is enabled but there is no noise simulation 
data to read it will show an empty domain. The checkbox 
does not reset the cache and can be used to switch the view 
between base resolution and noise view. 


Upres Factor 
Factor by which to enhance the resolution of the noise. 
The scaling factor is coupled to the Resolution Divisions. 


Strength 
Strength of the noise. Higher values result in more 
turbulent vortices. 


Scale 


Scale of the noise. Greater values result in larger 
vortices. 


Time 
Animation time of the noise. This value has an influence 
on where the noise field is evaluated. It can be used as a 
seed to give wavelet noise a slightly different look in two 
domains that are otherwise the same. 


Smoke plume with varying animation time. While the 
fluid motion of all four smoke plumes are alike each 
example has a unique look. 


Animation Time: Animation Time: 
0.1 1.0 


Animation Time: Animation Time: 
2.5 10.0 
Note 


Resolution Divisions and Upres Factor are not 
equivalent. By using different combinations of these 
resolution settings, you can obtain a variety of different 
styles of smoke. 


Comparison of fire simulations with and without noise at 
the same grid resolution. 


. i Resolution 
Resolution Division: ee 
Divisions: 100, 
200, without noise 
Noise scale: 2. 


Low division simulations with lots of Upres Factor 
divisions generally appear smaller in real-world scale and 
can be used to achieve pyroclastic plumes such as in the 
following image: 


Bake Noise, Free Noise 


This option is only available when using the Modular 
cache type. 


The progress will be displayed in the status bar. Pressing 
Esc will pause the simulation. 


Once the simulation has been baked, the cache can be 
deleted by pressing Free Noise. It is possible to pause or 
resume a Bake Noise process. 


Viewport Display 


Thickness 
Factor that scales the thickness of the grid that is 
currently being displayed. 


Interpolation 


Interpolation method to use for the visualization of the 
fluid grid. 


Linear 
Linear interpolation between voxels. Gives good 
smoothness and speed. 


Cubic 
Cubic interpolation between voxels. Gives smoothed 
high quality interpolation, but is slower. 


Closest 
No interpolation between voxels. Gives raw voxels. 


Slice per Voxel 
Determines how many slices per voxel should be 
generated. 


Slice 


Renders only a single 2D section of the domain object. 


Axis 
Auto 
Adjust slice direction according to the view direction. 


XIY/Z 
Slice along the X/Y/Z axis. 


Position 
Position of the slice relative to the length of the 
respective domain side. 


Gridlines Closest Interpolation Only 
Display gridlines to differentiate the underlying cells in 
the current slice of the fluid domain. 


Grid Display 


Use a specific color map for the visualization of the 
simulation field. This comes in handy during debugging or 
when making more advanced adjustments to the simulation. 
For instance, if the actual color of a fire simulation is barely 
visible in the viewport then changing the color profile can 
help to see the real size of the flame. 


Field 


The simulation field used in the display options (e.g. 
density, fuel, heat). 


Comparison of a fire simulation with and without color 
mapping. 


” 


Slice view of “fire” Slice view of “fire 
grid without color grid with color 
mapping. mapping. 


Scale 
Scale the selected simulation field by this value. 


Vector Display 


Visualization options for the vector fields. 


Display As 
Streamlines 
Choose to display the vectors as “Streamlines”. 


Needle 
Choose to display the vectors as “Needles”. 


MAC Grid 


Choose to display the vector field as “Marker-And-Cell 
Grid”. 
XIY/Z 


Show an individual X/Y/Z component of the MAC 
grid. 


Magnitude Streamlines or Needle Only 
Scale the display vectors by the magnitude of the vectors 
they represent. 


Field 
The vector field represented by the display vectors (e.g. 
fluid velocity, external forces). 


Scale 
Scale the vectors by this size in the viewport. 


Advanced Gridlines Only 


Advanced coloring options for gridlines. 


Color Gridlines 
Flags 
Color gridlines with flags. 


Highlight Range Grid Display Only 
Highlight the cells with values of the displayed grid 
within the range. Values between the Lower Bound 
and Upper Bound (inclusive) are considered to be 
within the range. 


Lower Bound 
Lower bound of the highlighting range. 


Upper Bound 


Upper bound of the highlighting range. 


Color 
Color used to highlight the cells. 


Cell Type 
Choose to highlight only a particular type of cells. 


Liquid Settings 


e Mesh 

e Particles 
e Diffusion 
e Viscosity 


Mesh 


The liquid mesh is, besides the liquid particles, another way 
to visualize the liquid simulation. It is generated directly 
from the liquid particles and often uses a higher resolution 
than the base Resolution Divisions. 


Besides enabling parts of the interface, checking Mesh lets 
the cache know which simulation data to read. If, for 
example, Mesh is enabled but there is no mesh simulation 
data to read it will show the original domain. The checkbox 
does not reset the cache and can be used to switch the view 
between the original domain and the baked liquid mesh. 


It is important to keep in mind that the shape of the mesh 
depends on a combination of a// these parameters. E.g. 
changing the Particle Radius will lead to a different 
interpretation of the concavity values. 


Upres Factor 
Factor by which to enhance the resolution of the mesh. 
The scaling factor is coupled to the Resolution Divisions 
(i.e. the mesh is this times bigger than the base 
simulation). 


Particle Radius 
The radius of one liquid particle in grid cells units. This 
value describes how much area is covered by a particle 
and thus determines how much area around it can be 
considered as liquid. A greater radius will let particles 
cover more area. This will result in meshes covering more 
volume around liquid particles. 


This property refers to the same Particle Radius 
described in the liquid domain settings. Yet for the mesh, 
it is useful to interpret the particle radius on its own. For 
one, the mesh can have a resolution different from the 
base resolution through the Upres Factor. For another, it 
is often desirable to be able to control the mesh size 
around a single liquid particle. 


Use Speed Vectors 


If this checkbox is enabled, speed vectors (mesh vertex 
velocities) are generated and stored on drive. They can 
be used to compute image-based motion blur with the 
compositing nodes. 


Comparison of a liquid splash with and without motion 
blur (rendered with Cycles). 


Motion blur - 
enabled. disabled. 


Mesh Generator 
The mesh generator method determines the accuracy of 
the mesh. The Final option produces a higher quality 
mesh and provides more configuration option than the 
Preview option which in turn is faster but not as smooth. 


Smoothing Positive 


Positive mesh smoothing iterations. Higher values will 
make the mesh outline increasingly smooth. Yet higher 
values can prevent small details (e.g. smaller liquid 
drops) from getting meshed. 


Smoothing Negative 
Negative mesh smoothing iterations. Higher values will 
make the mesh outline sharper. High values will preserve 
details, however, the mesh outline will become more 
ragged (e.g. a single mesh particle will become less 
rounded and have more flat sides). 


Comparison of a liquid drop hitting a surface 
(viewed from top) with varying smoothing values. 
Left: 1, 1 (Smoothing Positive, Smoothing 
Negative). Middle: 10, 1. Right: 1, 10. Note the 
Slightly sharper corners in the right splash 
(compared to the left one). 


Concavity Upper 
Upper mesh concavity bound. High values tend to 
smoothen and fill out concave regions. 


Concavity Lower 


Lower mesh concavity bound. High values tend to 
smoothen and fill out concave regions. 


Using a lower concavity which is greater the upper 
concavity can result in distorted, non-manifold meshes. 
Unless the artist sees value in this kind of mesh, such 
concavity value combinations should be avoided. 


Crown splash with varying upper and lower concavity 
settings. Note that setting the concavity values to the 
Same value produces a very granular mesh. 


Upper: Upper: Upper: 
1.5; LS, 1.5; 
Lower: Lower: Lower: 
0.0. 0.5. 1.0. 


Upper: Upper: Upper: 
2.0, 2.0, 2.0, 


Lower: Lower: Lower: 
0.0. 0.5. 1.0. 


Bake Mesh, Free Mesh 


This option is only available when using the Modular 
cache type. 


The progress will be displayed in the status bar. Pressing 
Esc will abort the simulation. 


Once the simulation has been baked, the cache can be 
deleted by pressing Free Mesh. It is possible to pause or 
resume a Bake Mesh process. 


Particles 


Spray 
Create spray particles during the secondary particle 
simulation. Spray particles are those that appear to fly 
through the air above the liquid surface when there is a 
bigger splash. 


Foam 
Create foam particles during the secondary particle 
Simulation. Foam particles are those that solely move on 
the liquid surface. 


Bubbles 
Create bubble particles during the secondary particle 
simulation. Bubble particles are those that move below 
the liquid surface. 


Note 


Enabling a secondary particle type will also create a 
particle system for that type of particles. Disabling a 
particle type will delete this particle system including its 
settings. 


Combined Export 
Select particle types that should go into the same 
particle system. This option has no effect on the outcome 
of the simulation. It only changes the way particle 
systems are allocated in the particle settings. 


Upres Factor 


Factor by which to enhance the resolution of the particle 
simulation. The scaling factor is coupled to the Resolution 
Divisions (i.e. the particle simulation is this times bigger 
than the base simulation). 


Wave Crest Potential Maximum 
Upper clamping threshold for marking fluid cells as wave 
crests. A higher value results in less marked cells. 


Wave Crest Potential Minimum 
Lower clamping threshold for marking fluid cells as wave 
crests. A lower value results in more marked cells. 


Trapped Air Potential Maximum 
Upper clamping threshold for marking fluid cells where 
air is trapped. A higher value results in less marked cells. 


Trapped Air Potential Minimum 
Lower clamping threshold for marking fluid cells where 
air is trapped. A lower value results in more marked cells. 


Kinetic Energy Potential Maximum 
Upper clamping threshold that indicates the fluid speed 
where cells start to emit particles. A higher value results 
in generally less particles. 


Kinetic Energy Potential Minimum 
Lower clamping threshold that indicates the fluid speed 
where cells start to emit particles. A lower value results 
in generally more particles. 


Potential Radius 
Radius to compute potential for each cell. Higher values 
are slower but create smoother potential grids. 


Particle Update Radius 


Radius to compute position update for each particle. 
Higher values are slower but particles move less chaotic. 


Wave Crest Particle Sampling 
Maximum number of particles generated per wave crest 
cell per frame. 


Trapper Air Particle Sampling 
Maximum number of particles generated per trapped air 
cell per frame. 


Particle Life Maximum 
Highest possible particle lifetime. 


Particle Life Minimum 
Lowest possible particle lifetime. 


Bubble Buoyancy 
Amount of buoyancy force that rises bubbles. A high 
value results in bubble movement mainly upwards. 


Bubble Drag 
Amount of drag force that moves bubbles along with the 
fluid. A high value results in bubble movement mainly 
along with the fluid. 


Particles in Boundary 
Delete 
Delete secondary particles that are inside obstacles or 
left the domain. 


Push Out 
Push secondary particles that left the domain back 
into the domain. 


Bake Particles, Free Particles 


This option is only available when using the Modular 
cache type. 


The progress will be displayed in the status bar. Pressing 
Esc will pause the simulation. 


Once the simulation has been baked, the cache can be 
deleted by pressing Free Particles. It is possible to pause 
or resume a Bake Particles process. 


Diffusion 


Reference 
Type: Domain 
Panel: Physics » Fluid >» Diffusion 


Liquid diffusion defines the physical properties of a liquid 
and in turn define how a liquid interacts with its 
environment. The main factors of diffusion are the Viscosity 
and Surface Tension. These properties can be adjusted to 
create virtual liquids that behave like water, oil, honey, or 
any other liquid. A couple presets exist to change the 
diffusion for different substances are predefined and can be 
changed in the preset menu. Fluid Diffusion settings can be 
enabled/disabled in the panel header. 


Viscosity 
The viscosity refers to the “thickness” of the fluid and 
actually the force needed to move an object of a certain 
surface area through it at a certain speed. 


For manual entry, please note that the normal real-world 
viscosity (the so-called dynamic viscosity) is measured in 
Pascal-seconds (Pa.s), or in Poise units (P, equal to 0.1 
Pa.s), and commonly centiPoise units (cP, equal to 0.001 
Pa.s). 


Blender, on the other hand, uses the kinematic viscosity 
which is dynamic viscosity in Pa.s, divided by the density 
in kg.m-3, unit m2.s-4. So for example, the viscosity of 
water at room temperature is 1.002 cP, or 0.001002 Pa.s; 
the density of water is about 1000 kg.m-3, which gives a 


kinematic viscosity of 0.000001002 m2.s"! - so the entry 
would be 1.002 times 10 to the minus six (1.002x10° in 
scientific notation). 


The table below gives some examples of fluids together 
with their dynamic and kinematic viscosities. 


Blender viscosity unit conversion. 


Kinematic 

Fluid Dynamic viscosity 
viscosity (in cP) (Blender, in 
m2,s-1) 
: 1.002x10° 1.002x10°6 
water ieyC) (1.002) (0.000001002) 
5.0x10°> 
2 


Honey (20 °C) 1.0x104 (10,000) 2.0x10-3 (0.002) 


Chocolate Syrup 3.0x104 (30,000) 3.0x10-3 (0.003) 


1.0x105 re 
Ketchup (100,000) 1.0x10-* (0.1) 
Melting Glass 1.0x101° 1.0 10° (1.0) 


To simplify the input of these numbers, the viscosity is 
changed by entering values in scientific notation by 
entering a base value and the exponent of that number. 


Base 
The base of the viscosity value (e.g. 1.002 in the case 
of water (20 °C)). 


Exponent 
The exponent of the viscosity value that will be 
multiplied by 10°© (e.g. 6 in the case of water (20 °C)). 


Note 
Viscosity Varies 


The default values in Blender are considered typical for 
those types of fluids and “look right” when animated. 
However, actual viscosity of some fluids, especially 
sugar-laden fluids like chocolate syrup and honey, 
depend highly on temperature and concentration. Oil 


temperature is basically a solid, but glass at 1500 °C 
flows (nearly) like water. 


Warning 


The simulator is not suitable for non-fluids, such as 
materials that do not “flow”. Simply setting the 
viscosity to very large values will not result in rigid body 
behavior, but might cause instabilities. 


Surface Tension 
Surface tension in grid units. Higher value will produce 
liquids with greater surface tension. 


Viscosity 


Strength 
The viscosity of the liquid. Higher values result in more 
viscous fluids. 


Note 

A strength value of 0 will still apply some viscosity. 
Uncheck the Viscosity option to disable the viscosity 
simulation step completely. 


Rotating liquid inflow with varying viscosities. 


Viscosity of 0.2 (at Viscosity of 0.4 (at 
frame 65). frame 200). 


Guides 


Reference 
Panel: Physics » Fluid » Guides 
Type: Domain 


Fluid guides are used to apply forces onto the simulation. 
They are like simple external forces but also seek to 
preserve the physically accurate flow of the fluid. The 
Guides panel allows you to adjust guiding forces globally, 
i.e. for the entire domain. Enabling the guides hints the fluid 
solver to use the more accurate, but also computationally 
more expensive pressure solving step. 


Even when there are no guiding objects baked or there is no 
guiding domain attached, the fluid solver will still perform 
the more expensive pressure guiding algorithm if guiding is 
enabled. It is therefore recommended to only enable Guides 
when there is a clear intention to use guiding in the 
simulation. 


See also 


Fluid guiding is an implementation of Primal-Dual 
Optimization for Fluids. 


Velocity Factor 
Controls the lag of the guiding. A larger value (also 
known as the ‘alpha’ guiding value) results in a greater 


lag. 


Size 
This setting determines the size of the vortices that the 
guiding produces. A greater guiding size (also known as 
the blur radius or ‘beta’ guiding value) results in larger 
vortices. 


Velocity Factor 
All guiding velocities are multiplied by this factor. That is, 
every cell of the guiding grid, which has the same size as 
the domain object, is multiplied by this factor. 


Velocity Source 


Guiding velocities can either come from objects that 
move inside the domain or from other fluid domains. 


Effector 
All effector objects inside the domain will be 
considered for the global guiding velocity grid. Once 
effector objects have been baked it is not possible to 
change the fluid domain resolution anymore. 


Domain 


When using another fluid domain as the guiding 
velocity source this domain may have a different 
resolution and may also be of a different type (e.g. the 
guiding domain is of type Gas while the actual domain 
with the guiding effect in it is of type Liquid). 


In order to use a domain as the velocity source, this 
domain needs to be baked already. 


Guide Parent 
When using Domain as the velocity source, this field 
serves to select the guiding domain object. 


Bake Guides, Free Guides 


This option is only available when using the Modular 
cache type and when using Effector as the Velocity 
Source. Bake Guides writes vertex velocities of effector 
objects to drive. It is meant to be used before baking the 
fluid simulation. 


The progress will be displayed in the status bar. Pressing 
Esc will pause the simulation. 


Once the simulation has been baked, the cache can be 
deleted by pressing Free Guides. It is possible to pause or 
resume a Bake Guides process. 


Collections 


Reference 

Type: Domain 

Panel: Properties >» Physics » Fluid » Collections 
Flow 


If set, only objects in the specified Collection will be 
allowed to act as Flow objects in this domain. 


Effector 
If set, only objects in the specified Collection will be 
allowed to act as Effector objects in this domain. 


Cache 


Reference 
Panel: Physics » Fluid » Cache 
Type: Domain 


The Cache panel is used to Bake the fluid simulation and 
stores the outcome of a simulation so it does not need to be 
recalculated. 


Baking takes a lot of compute power (hence time). 
Depending on the scene, it is recommended to allocate 
enough time for the baking process. 


If the mesh has modifiers, the rendering settings are used 
for exporting the mesh to the fluid solver. Depending on the 
setting, calculation times and memory use might 
exponentially increase. For example, when using a moving 
mesh with Subdivision Surface as an obstacle, it might help 
to decrease simulation time by switching it off, or to a low 
subdivision level. When the setup/rig is correct, you can 
always increase settings to yield a more realistic result. 


Note 


Fluid simulations use their own cache. All other physics 
simulations make use of the General Baking operators. 


Cache Directory 
Directory to store baked simulation files in. Inside this 
directory each simulation type (i.e. mesh, particles, 


noise) will have its own directory containing the 
simulation data. 


Type 
The type of the cache determines how the cache can be 
baked. 


Replay 
The cache will be baked as the simulation is being 
played in the viewport. 


Modular 
The cache will be baked step by step: The bake 
operators for this type are spread across various 
panels within the domain settings (e.g. the bake tool 
for the mesh can be found in the Mesh panel). 


All 
The cache will be baked with a single tool. All selected 
settings will be considered during this bake. The bake 
tool for this type can be found in the Cache panel. 


Important 

“Replay” only works when the Playback Sync mode is 
set to “Play Every Frame”. If you need to use “Frame 
Dropping” or “Sync to Audio”, consider using the 
“Modular” or “All” options below. 


Start 
Frame on which to start the simulation. This is the first 
frame that will be baked. 


End 
Frame on which to stop the simulation. This is the last 
frame that will be baked. 


Note 

The simulation is only calculated for positive frames 
between the Start and End frames of the Cache panel. 
So if you want a simulation that is longer than the 
default frame range you have to change the End frame. 


Offset 
Frame offset that is used when loading the simulation 
from the cache. It is not considered when baking the 
simulation, only when loading it. 


Use Resumable Cache 
Extra data will be saved so that you can resumed baking 
after pausing. Since more data will be written to drive it 
is recommended to avoid enabling this option when 
baking at high resolutions. 


Volume File Format 
File format for volume based simulation data (i.e. grids 
and particles). 


Uni Cache 
Blender’s own caching format with some compression. 
Each simulation object is stored in its own .uni cache 
file. 


OpenVDB 
Advanced and efficient storage format. All simulation 
objects (i.e. grids and particles) are stored in a single 
.vdb file per frame. 


Mesh File Format Liquids Only 
File format for the mesh cache files. 


Binary Object 


Mesh data files with some compression. 


Object 
Simple, standard data format for mesh data. 


Bake All, Free All 
This option is only available when using the Final cache 
type. Bake All will run the simulation considering all 
parameters from the settings (i.e. it will bake all steps 
that can be baked individually with the Modular cache 
type at once). 


The progress will be displayed in the status bar. Pressing 
Esc will abort the simulation. 


Once the simulation has been baked, the cache can be 
deleted by pressing Free All. It is not possible to pause or 
resume a Bake All process as only the most essential 
cache files are stored on drive. 


Advanced 


Compression Volumes OpenVDB Only 
Compression method that is used when writing OpenVDB 
cache files. 


None 
Cache files will be written without any compression. 
Zip 
Cache files will be written with Zip compression. 
Effective but slower than Blosc. 


Blosc 


Cache files will be written with Blosc compression. 
Multithreaded compression, similar in size and quality 
to Zip compression. 


Precision Volumes OpenVDB Only 
Precision level that is used when writing OpenVDB cache 
files. 


Full 
Volumetric data (e.g. grids, particles) will be written 
with full precision (32-bit). 


Half 
Volumetric data (e.g. grids, particles) will be written 
with half precision (16-bit). 


Mini 
Volumetric data (e.g. grids, particles) will be written 
with mini float precision (8-bit) where possible. For 
cache data where this is not possible, 16-bit floats will 
be used instead. 


Export Mantaflow Script 
Export the simulation as a standalone Mantaflow script 
when baking the scene (exported on “Bake Data”). 
Usually, only developers and advanced users who know 
how to use the Mantaflow GUI will make use of this 
functionality. Use a Debug _ Value of 3001 to enable. 


Field Weights 


Reference 

Panel: Properties » Physics » Fluid » Field 
Weights 

Type: Domain 


These settings determine how much gravity and Force Fields 
affect the fluid. 


Effector Collection 


When set, fluid can only be influenced by force fields in 
the specified collection. 


Gravity 
How much the fluid is affected by Gravity. 


All 
Overall influence of all force fields. 


The other settings determine how much influence individual 
force field types have. 


Flow 


Fluid Flow types are used to add or remove fluid to a domain 
object. Flow objects should be contained within the 
domain’s Bounding Box in order to work. 


To define any mesh object as a Flow object, add Fluid 
physics by clicking Fluid in Properties » Physics. Then select 
Flow as the fluid Type. Now you should have a default fluid 
flow source object. 


Settings 


Reference 


Panel: Physics » Fluid >» Settings 
Type: Flow 


Flow Type 
Smoke 
Emit only smoke. 


Fire + Smoke 
Emit both fire and smoke. 


Fire 
Emit only fire. Note that the domain will automatically 
create some smoke to simulate smoke left by burnt 
fuel. 

Liquid 
Emit liquid. 


Flow Behavior 


Controls if the Flow object either adds (/nflow), removes 
(Outflow), or turns the mesh itself into fluid (Geometry). 


Inflow 
This object will emit fluid into the simulation, like a 
water tap or base of a fire. 


Outflow 
Any fluid that enters the Bounding Box of this object 
will be removed from the domain (think of a drain or a 
black hole). This can be useful in combination with an 
inflow to prevent the whole domain from filling up. 
Outflow objects can be animated and the area where 
the fluid disappears will follow the object as it moves 
around. 


Geometry 

All regions of this object that are inside the domain 
bounding box will be used as actual fluid in the 
simulation. You can place more than one fluid object 
inside the domain. Also make sure that the surface 
normals are pointing outwards or else they will not 
simulate properly. In contrast to domain objects, the 
actual mesh geometry is used for fluid objects. 


Use Flow 
Enables or disables the flow of fluid, this property is 
useful for animations to selectively enable and disable 
when fluid is being added to or removed from the 
domain. 


Sampling Substeps 
Number of sub-steps used to reduce gaps in emission of 
fluid from fast-moving sources. 


Comparison of smoke inflow quickly rising upwards at 
different sub-step rates. 


Sampling sub- Sampling sub- 
steps: 0. steps: 3. 


Note that these emission sub-steps occur at every 
simulation step and not per frame. The simulation step 
count is controlled by the adaptive time stepping. 


Smoke Color 
The color of emitted smoke. When smoke of different 
colors are mixed they will blend together, eventually 
settling into a new combined color. 


Absolute Density 
If this checkbox is enabled, the emitter will only produce 
more smoke or fire if there is space for it in the emitter 
region. Otherwise smoke or fire will always be produced 
and add up. 


Initial Temperature 
Difference between the temperature of emitted smoke 
and the domain’s ambient temperature. This setting’s 
effect on smoke depends on the domain’s Heat 


Buoyancy. 


Density 
Amount of smoke to emit at once. Larger values result in 
more density being produced. 


Fuel 
Amount of “fuel” being burned per second. Larger values 
result in larger flames, smaller values result in smaller 
flames: 


Comparison of flames with varying fuel rates. 


Fuel: 0.5. Fuel: 1.0. 


Vertex Group 


When set, use the specified Vertex Group to control 
where smoke is emitted. 


Flow Source 


Flow Source 
This setting defines the method used to emit fluid. 


Mesh 
Emit fluid directly from the object’s mesh. 


Is Planar 
Defines the effector as either a single dimension 
object i.e. a plane or the mesh is Non-manifold. 
This ensures that the fluid simulator will give the 
most accurate results for these types of meshes. 


Surface Emission 
Maximum distance in Voxels from the surface of 
the mesh in which fluid is emitted. Since this 
setting uses voxels to determine the distance, 
results will vary depending on the domain’s 
resolution. 


Volume Emission Fire or Smoke Only: 
Amount of fluid to emit inside the emitter mesh, 
where 0 is none and 1 is the full amount. Note that 
emitting fluid based on volume can have 
unpredictable results if your mesh is Non-manifold. 


Particle System Fire or Smoke Only: 


Create smoke or fire from a particle system on the 
flow object. which can be select with a Data ID. 


Note that only Emitter type particle systems can add 
smoke. See Particles for information on how to create 


a particle system. 


Set Size 
When this setting is enabled, it allows the Size 
setting to define the maximum distance in voxels 
at which particles can emit smoke, similar to the 
Surface Emission setting for mesh sources. 


When disabled, particles will fill the nearest Voxel 
with smoke. 


Initial Velocity 


When enabled, the fluid will inherit the momentum of the 
flow source. 


Source 
Factor for the inherited velocity. A value of 1 will emit 
fluid moving at the same speed as the source. 


Normal 
This option controls how much velocity fluid is given 
along a face Normal. Note that, initial velocities will 
always be applied along all face normals. Thus with a 
closed flow source mesh, fluid will always be emitted in 
more than one direction. To set initial velocities along 
only one direction all normals need to point in the same 
direction. This is can be achieved when using a plane as 
the flow object. 


Initial X, Y, Z 
Initial velocity along X, Y, Z coordinates in world space. 
This can be used in addition to the initial velocity along 
the Normal. 


Texture 


Reference 
Type: Flow 
Panel: Physics » Fluid >» Settings » Texture 


When enabled, use the specified texture and settings to 
control where on the mesh smoke or fire can be emitted 
from. These settings have no effect on Outflow Flow 
Behavior. 


Texture 
A Data ID selector to choose the Texture. 


Mapping 
Controls whether to use Generated UVs or manual UV 


mapping. 


Size 
Overall texture scale. 


Offset 
Translates the texture along the Z axis. 


Effector 


Effector objects are used to deflect fluids and influence the 
fluid flow. To define any mesh object as an effector object, 
add fluid physics by clicking Fluid in Properties >» Physics. 
Then select Effector as the fluid Type. 


Tip 


Force Fields (Such as wind or vortex) are supported, like in 
most physics systems. The influence individual force types 
have can be controlled per domain object. 


Settings 


Reference 


Panel: Physics » Fluid » Settings 
Type: Effector 


Effector Type 
Collision 
Objects of this type will collide with fluid. 


Guide 


The velocity of objects of this type will be used when 
baking the guiding. So fluid guiding objects should 
move and have some velocity. 


Velocity Factor 


Multiply the guiding object velocities by this factor. 
This is useful when working with multiple guiding 
objects and some of them should have higher or 
smaller velocities. 


Guide Mode 
The mode describes how guiding velocities should 
be written into the global guiding velocity field of 
the domain. 


Maximize 
The guiding object will compare the existing 
velocity in the global velocity field with its own 
velocity. If its absolute value is greater than the 
absolute value in the velocity field the guiding 
velocity will be kept. 


Minimize 
A guiding object will compare the existing 
velocity in the global velocity field with its own 
velocity. If its absolute value is smaller than the 
absolute value in the velocity field the guiding 
velocity will be kept. 


Override 
The most intuitive option. A guiding object will 
always write its own current velocity into the 
global guiding velocity field. Values in the 
velocity field from a previous frame or guiding 
object will be overridden. 


Averaged 
A guiding object will write the average of its own 
current velocity and the existing guiding velocity 
at that cell into the global guiding velocity field. 


Effector Substeps 
Number of substeps used to reduce gaps in collision of 
fluid from fast-moving effectors. 


Surface Thickness 
Additional area around the effector that will be 


considered as an effector. 


Use Effector 
Enables or disables the effector object effect on the fluid, 


this property is useful for animations to selectively 
enable and disable when the effector affects the fluid. 


Is Planar 
Defines the effector as either a single dimension object 
i.e. a plane or the mesh is Non-manifold. This ensures 
that the fluid simulator will give the most accurate 
results for these types of meshes. 


A Manifold mesh can also be declared as planar. The fluid 
solver will then ignore the volume inside the mesh and 
just emit fluid from the mesh sides. 


Materials 


Smoke Material 


Realistic smoke can be rendered with the Principled Volume 
shader. 


Smoke Material Example Animation 
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Introduction 


Particles are lots of items emitted from mesh objects, 
typically in the thousands. Each particle can be a point of 
light or a mesh, and be joined or dynamic. They may react 
to many different influences and forces, and have the notion 
of a lifespan. Dynamic particles can represent fire, smoke, 
mist, and other things such as dust or magic spells. 


Hair type particles are a subset of regular particles. Hair 
systems form curves that can represent hair, fur, grass and 
bristles. 


You see particles as a Particle Modifier, but all settings are 
done in the Particle tab. 


Some fur made from particles. 


Particles generally flow out from their mesh into space. 
Their movement can be affected by many things, including: 


Initial velocity out from the mesh. 

Movement of the emitter (vertex, face or object) itself. 
Movement according to “gravity” or “air resistance”. 
Influence of force fields like wind, vortexes or guided 
along a curve. 

Interaction with other objects like collisions. 

Partially intelligent members of a flock (herd, school, ...), 
that react to other members of their flock, while trying 
to reach a target or avoid predators. 

Smooth motion with soft body physics (only Hair particle 
systems). 

Or even manual transformation with Lattices. 


Particles may be rendered as: 


Halos (for Flames, Smoke, Clouds). 

Meshes which in turn may be animated (e.g. fish, bees, 
...). In these cases, each particle “carries” another 
object. 


e Hair curves, following the path of the particle. These 


hair curves can be manipulated in the 3D Viewport 
(combing, adding, cutting, moving, etc.). 


Every object may carry many particle systems. Each particle 
system may contain up to 10,000,000 particles. Certain 
particle types (Hair and Keyed) may have up to 10,000 
children for each particle (children move and emit more or 
less like their respective parents). The size of your memory 
and your patience are your practical boundaries. 


Particle System Panel 


Reference 


Panel: Particle System » Particle System 
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Emitter 


¥ Emission 
Number 10000000 
Seed 0 
Frame Start 1.000 
End 200.000 
Lifetime 50.000 
Lifetime Randomness 0.000 


Particle System panel. 
These are the basic settings. 


Active Particle System 
The List View of the objects Particle Modifier(s). 


Specials 
Copy Active to Selected Objects 
Copies the active particle system to all selected 
objects. 


Copy All to Selected Objects 
Copies all particle systems from the active object 
to all selected objects. 


Duplicate Particle Systems 
Duplicates the particle system within the active 
object. The Duplicate Settings option (in the Adjust 
Last Operation panel) will duplicate settings as 
well, so the new particle system uses its own 
settings. 


Particle Settings 
The Data-Block menu for settings. 


Type 
Main selector of the system type. 


Emitter 
In such a system, particles are emitted from the 
object. 


Hair 
Use Hair type, rendered as strands. 


Regrow 
Regrows the hair for each frame. This is useful 
when you are animating properties. 


Advanced 
Enables advanced settings which reflect the same 
ones as working in Emitter mode. 


Note 
This manual assumes that this option is enabled. 


Segments 
Controls the number of parts a hair is made of. 
Increasing this value will improve the quality of 
animations. 


Workflow 


The process for working with standard particles is: 


l. 
2. 


Create the mesh which will emit the particles. 

Create one or more Particle Systems to emit from the 
mesh. Many times, multiple particle systems interact or 
merge with each other to achieve the overall desired 
effect. 


. Tailor each Particle System’s settings to achieve the 


desired effect. 


. Animate the base mesh and other particle meshes 


involved in the scene. 


. Define and shape the path and flow of the particles. 
. For Hair particle systems: Sculpt the emitter’s flow (cut 


the hair to length and comb it for example). 


. Make final render and do physics simulation(s), and 


tweak as needed. 


Creating a Particle System 


To add a new particle system to an object, go to the 
Particles tab of the Properties editor and click the small + 
button. An object can have many Particle Systems. 


Each particle system has separate settings attached to it. 
These settings can be shared among different particle 
systems, So one does not have to copy every setting 
manually and can use the same effect on multiple objects. 


Types of Particle Systems 


After you have created a particle system, the Properties fills 
with many panels and buttons. But do not panic! There are 

two different types of particle systems, and you can change 
between these two with the Type selector: Emitter and Hair. 


The settings in the Particle System tab are partially different 
for each system type. 
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Emission 


Reference 


Panel: Particle System » Emission 


The Emitter system works just like its name says: it 
emits/produces particles for a certain amount of time. In 
such a system, particles are emitted from the selected 
object from the Start frame to the End frame and have a 
certain lifespan. These particles are rendered default as 
Halos, but you may also render this kind of particles as 
objects (depending on the particle system’s render settings, 
see Visualization). 


The buttons in the Emission panel control the way particles 
are emitted over time: 


Number 
The maximum amount of parent particles used in the 
simulation. 


Seed 
Blender uses this as starting point to produce random 
numbers during the simulation. 


Frame Start 
The start frame of particle emission. You may set 
negative values, which enables you to start the 
simulation before the actual rendering. 


End 
The end frame of particle emission. 


Lifetime 
The lifespan (in frames) of the particles. 


Lifetime Randomness 
A random variation of the lifetime of a given particle. The 
Shortest possible lifetime is Lifetime x (1 - Random). 
Values above 1.0 are not allowed. For example with the 
default Lifetime value of 50 a Random setting of 0.5 will 
give you particles with a live span ranging from 50 
frames to \(50 x (1.0 - 0.5) = 25\) frames, and with a 
Random setting of 0.75 you will get particles with live 
Spans ranging from 50 frames to \(50 x (1.0 - 0.75) = 
12.5\) frames. 


Source 


Reference 


Panel: Particle System >» Emission >» Source 


Emit From 


Defines how and where the particles are emitted, giving 
precise control over their distribution. 


Tip 


You may use vertex groups to confine the emission, that 
is done in the Vertex Groups panel. 


Vertices 
Emits particles from the vertices of a mesh. 


Faces 
Emits particles from the surface of a mesh’s faces. 


Volume 
Emits particles from the volume of an enclosed mesh. 
Tip 
Your mesh must be Manifold to emit particles from 


the volume. Some modifiers like the Edge Split 


Modifier break up the surface, in which case volume 
emission will not work correctly! 


Use Modifier Stack 


Take any Modifiers above the Particle Modifier in the 


modifier stack into account when emitting particles, else 
it uses the original mesh geometry. 


Note 


Note that particles may differ in the final render if these 
modifiers generate different geometry between the 


viewport and render. 
Distribution 


These settings control how the emissions of particles are 
distributed throughout the emission locations when 
emitting from either Faces or Volume. 


Jittered 


Particles are placed at jittered intervals on the emitter 
elements. 


Particles/Face 
Number of emissions per face (0 = automatic). 


Jittering Amount 
Amount of jitter applied to the sampling. 


Random 
Particles are emitted from random locations in the 
emitter’s elements. 


Grid 
Particles are set in a 3D grid and particles near/in the 
elements are kept. 


Invert Grid 
Invert what is considered the object and what is 
not. 


Hexagonal 
Uses a hexagonal-shaped grid instead of a 
rectangular one. 


Resolution 
Resolution of the grid. 


Random 
Add a random offset to grid locations. 


Random Order 
The emitter element indices are gone through ina 
random order instead of linearly (one after the other). 


Not available for Grid distribution. 


Even Distribution 
Particle distribution is made even based on surface area 
of the elements, i.e. small elements emit less particles 
than large elements, so that the particle density is even. 


Cache 


Reference 


Panel: Particle System >» Cache 


In order to improve real-time response and avoid 
unnecessary recalculation of particles, the particle data can 
be cached in memory or stored on a drive. 


The Emitter particle system uses a unified system for 
caching and baking (together with Soft Body and Cloth). 


See also 


See the General Baking docs for more information. 


Hints 


e The simulation is only calculated for positive frames in 
between the Start and End frames of the Cache panel, 
whether you bake or not. So if you want a simulation 
that is longer than the default frame range, you have to 
change the End frame. 

e When an animation is played, each physics system 
writes each frame to the cache. Note that for the cache 
to fill up, one has to start the playback before or on the 
frame that the simulation starts. 

e The cache is cleared automatically on changes. But not 
on all changes, so it may be necessary to free it 
manually, e.g. if you change a force field. 


The system is protected against changes after baking. If 
for example the mesh changes the simulation is not 
calculated anew. 

The bake result can be cleared by clicking on the Free 
Bake button in the simulation cache settings. 

A simulation can only be edited in Particle Edit Mode 
when it has been baked in memory. And cannot be 
edited if the Disk Cache is used. 

If you are not allowed to write to the required 
Subdirectory caching will not take place, e.g. if your 
blend-file path is very long and your operating system 
has a limit on the path length that is supported. 

Be careful with the sequence of modifiers in the modifier 
stack. You may have a different number of faces in the 
3D Viewport and for rendering (e.g. when using 
Subdivision surface), if so, the rendered result may be 
very different from what you see in the 3D Viewport. 


Velocity 


Reference 


Panel: Particle System » Velocity 


The initial velocity of particles can be set through different 
parameters, based on the type of the particle system. If the 
particle system type is Emitter or Hair, then the following 
parameters give the particle an initial velocity. 


Normal 


The emitter’s surface normals (i.e. let the surface normal 
give the particle a starting speed). 


Tangent 
Let the tangent speed give the particle a starting speed. 


Tangent Phase 
Rotates the surface tangent. 


Object Align 
Give an initial velocity in the X, Y, and Z axes. 


Ke VZ 


Object Velocity 


The emitter objects movement (i.e. let the object give 
the particle a starting speed). 


Randomize 


Gives the starting speed a random variation. You can use 
a texture to only change the value, see Controlling 


Emission, Interaction and Time. 


Rotation 


Reference 


Panel: Particle System » Rotation 


These parameters specify how the individual particles are 
rotated during their travel. To visualize the rotation of a 
particle, display particles as Axis in the Viewport Display 
panel. 


Orientation Axis 


Sets the initial rotation of the particle by aligning the X 
axis in the direction of: 


None 
The global X axis. 


Normal 
Orient to the emitter’s surface normal, the objects Y 
axis points outwards. 


Normal-Tangent 
As with normal, orient the Y axis to the surface 
normal. Also orient the X axis to the tangent for 
control over the objects rotation about the normal. 
requires UV coordinates, the UV rotation effects the 
objects orientation, currently uses the active UV map. 
This allow deformation without the objects rotating in 
relation to their surface. 


Velocity 
The particle’s initial velocity. 


Global X, Y, Z 
One of the global axes. 


Object X, Y, Z 
One of the emitter object axes. 


Random 
Randomizes rotation. 


Phase 
Initial rotation phase. 


Randomize Phase 
Adds a random variation to the Phase. 


Dynamic 
If Dynamic is enabled, only initializes particles to the 


chosen rotation and angular velocity and let the physics 
simulation handle the rest. Particles then change their 
angular velocity if they collide with other objects (like in 
the real world due to friction between the colliding 
surfaces). Otherwise the angular velocity is 
predetermined at all times (i.e. set rotation to 
dynamic/constant). 


Angular Velocity 


Reference 

Panel: Particle System » Rotation >» Angular 
Velocity 

Axis 


The selector specifies the axis of angular velocity to be. 


None 
A zero vector (no rotation). 


Spin 
The particles velocity vector. 


Random 
A random vector. 


Hint 
Curve Guide 


If you use a Curve Guide and want the particles to 
follow the curve, you have to set Angular Velocity to 
Spin and leave the rotation on Constant (i.e. do not turn 
on Dynamic). Curve Follow does not work for particles. 


Amount 
The magnitude of angular velocity. 
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Introduction 


The movement of particles may be controlled in a multitude 
of ways. Here we will discuss only the particle physics in the 
narrower sense, i.e. the settings in the Physics panel. 


Additional ways of moving particles are: 


e By soft body animation (only for Hair particle systems). 
e By force fields and along curves. 
e By lattices. 


Common Physics Settings 


Size 
Sets the size of the particles. 


Random Size 
Give the particles a random size variation. 


Mass 
Specify the mass of the particles. 


Multiply Mass with Particle Size 
Causes larger particles to have larger masses. 


No Physics 


The particles will be given no motion, which makes them 
belong to no physics system. At first a physics type that 
makes the particles to be static could seem a bit strange, 
but it can be very useful at times. None physics make the 


particles stick to their emitter their whole life time. The 
initial velocities here are for example used to give a velocity 
to particles that are affected by a harmonic effector with 
this physics type when the effect of the effector ends. 


Moreover, it can be very convenient to have particles at 
disposal (whose both Unborn and Died are visible on render) 
to groom vegetation and/or ecosystems using Object or 
Group types of visualization. 


Newtonian 


Reference 
Panel: Particle System » Physics 
Type: Newtonian 


The particles will move according to classical (Newtonian) 
mechanics. Particles start their life with the specified initial 
velocities and angular velocities, and move according to 
external forces. The response to environment and to forces 
is computed differently, according to the given integrator 
chosen by the animator. 


Forces 


Reference 
Panel: Particle System » Physics » Forces 


Brownian 
Specify the amount of Brownian motion. Brownian motion 
adds random motion to the particles based ona 


Brownian noise field. This is nice to simulate small, 
random wind forces. 


Drag 


A force that reduces particle velocity in relation to its 


speed and size (useful in order to simulate air drag or 
water drag). 


Damp 


Reduces particle velocity (deceleration, friction, 
dampening). 


Integration 
Reference 
Panel: Particle System » Physics > Integration 


Integrators are a set of mathematical methods available to 
calculate the movement of particles. The following 
guidelines will help to choose a proper integrator, according 
to the behavior aimed at by the animator. 


Integration 
Euler 

Also known as “Forward Euler”. Simplest integrator. 
Very fast but also with less exact results. If no 
dampening is used, particles get more and more 
energy over time. For example, bouncing particles will 
bounce higher and higher each time. Should not be 
confused with “Backward Euler” (not implemented) 
which has the opposite feature, the energy decrease 
over time, even with no dampening. Use this 
integrator for short simulations or simulations with a 
lot of dampening where speedy calculations are more 
important than accuracy. 


Verlet 
Very fast and stable integrator, energy is conserved 
over time with very little numerical dissipation. 


Midpoint 
Also known as “2nd order Runge-Kutta”. Slower than 
Euler but much more stable. If the acceleration is 


constant (no drag for example), it is energy 
conservative. It should be noted that in example of 
the bouncing particles, the particles might bounce 
higher than they started once in a while, but this is 
not a trend. This integrator is a generally good 
integrator for use in most cases. 


RK4 
Short for “4th order Runge-Kutta”. Similar to Midpoint 
but slower and in most cases more accurate. It is 
energy conservative even if the acceleration is not 
constant. Only needed in complex simulations where 
Midpoint is found not to be accurate enough. 


Timestep 
The amount of simulation time (in seconds) that passes 
during each frame. 


Subframes 
The number of simulation steps per frame. Subframes to 
simulate for improved stability and finer granularity in 
simulations. Use higher values for faster-moving 
particles. 


The following options are only available for Fluid type 
physics: 


Adaptive 
Automatically set the number of subframes. 


Threshold 
A tolerance value that allows the number of 
subframes to vary. It sets the relative distance a 
particle can move before requiring more subframes. 


The number of steps per frame will be at least 
Subframes + 1. More subframes may be simulated if 
the fluid becomes turbulent, according to the 


Threshold. 
Deflection 
Reference 
Panel: Particle System » Physics >» Deflection 
Size Deflect 


Use the particle size in deflections. 


Die on Hit 
Kill particle when it hits a deflector object. 


Collision Collection 
If set, particles collide with objects from the collection. 


Keyed 


Reference 
Panel: Particle System » Physics 
Type: Keyed 


The path of Keyed particles is determined between particles 
of any two (or more) particle systems. This allows the 
creation of a chains of systems to create long strands or 
groovy moving particles. Basically the particles have no 
dynamics but are interpolated from one system to the next 
each frame. 


To setup Keyed particles you need at least two particle 
systems in the Keys list. 


Options 


Loops 
Sets the number of times the entire Keys list is repeated. 
Disabled if Use Timing is enabled. 


Use Timing 
Enabling this option allows you to specify the timing for 
each key independently, using the Time and Duration 
options. By default, the Use Timing option is deactivated, 
and the particles will pass through all keys for a time 
equal to its lifetime. A shorter lifetime means faster 
movement. The lifetime will be split equally between the 
keys, this may lead to varying particle speeds between 
the targets. 


Relations 


Reference 


Panel: Particle System » Physics » Relations 


Key Targets 
The list view of keys (target particle systems). 


Object 
The name of a target object for the selected key. If empty 
it uses the current particle system. 


System 
Index of particle system on the target object. 


Time 
The time (frame number) at which the particles will be at 
the position of the selected system. Note also that the 
Start frame of the Keyed system adds an offset to this 
time. 


Duration 
How long (in frames) the particles stay on this system 
before they start moving to the next one. 


Boids 


Reference 
Panel: Particle System » Physics 
Type: Boids 


Boids particle systems are controlled by a limited artificial 
intelligence, which can be programmed to follow basic rules 
and behaviors. They are ideal for simulating flocks, swarms, 
herds and schools of various kind of animals, insects and 
fishes or predators vs. preys simulations. They can react on 
the presence of other objects and on the members of their 
own system. Boids can handle only a certain amount of 
information, therefore the sequence of the Boid Brain rules 
is very important. In certain situations only the first three 
parameter are evaluated. 


Movement 
Reference 
Panel: Particle System » Physics » Movement 


Boids try to avoid objects with activated Collision. They try 
to reach goal objects, and fly from “predators” according to 
the Boid Brain settings. 


Boids can different physics depending on whether they are 
in the air, or on land (on collision object). 


Allow Flight 


Allow boids to move in the air. 


Allow Land 
Allow boids to move on land. 


Allow Climbing 
Allow boids to climb goal objects. 


Max Air Speed 
Set the Maximum velocity in the air. 


Min Air Speed 
Set the Minimum velocity in the air. 


Max Air Acceleration 
Lateral acceleration in air, percentage of the max 
velocity (turn). Defines how fast a boid is able to change 
direction. 


Max Air Angular Velocity 
Tangential acceleration in air, percent 180 degrees. 
Defines how much the boid can suddenly accelerate in 
order to fulfill a rule. 


Air Personal Space 
Radius of boids personal space in air. Percentage of 
particle size. 


Landing Smoothness 
How smoothly the boids land. 


Max Land Speed 
Set the Maximum velocity on land. 


Jump Speed 
Maximum speed for jumping. 


Max Land Acceleration 
Lateral acceleration on land, percent of max velocity 
(turn). Defines how fast a boid is able to change 
direction. 


Max Land Angular Velocity 
Tangential acceleration on land, percent 180 degrees. 
Defines how much the boid can suddenly accelerate in 
order to fulfill a rule. 


Land Personal Space 
Radius of boids personal space on land. Percentage of 
particle size. 


Land Stick Force 
How strong a force must be to start effecting a boid on 
land. 


Collision Collection 
Only collide with objects in this collection. 


Battle 


Reference 


Panel: Particle System » Physics » Battle 


Health 
Initial boid health when born. 


Strength 
Maximum caused damage per second on attack. 


Aggression 
Boid will fight this time stronger than enemy. 


Accuracy 
Accuracy of attack. 


Range 
Maximum distance of which a boid can attack. 


Misc 


Reference 


Panel: Particle System » Physics » Misc 


Banking 
Amount of rotation around velocity vector on turns. 
Banking of 1.0 gives a natural banking effect. 


Pitch 
Amount of rotation around side vector. 


Height 
Boid height relative to particle size. 


Relations 


Reference 


Panel: Particle System » Physics » Relations 


Target 
This list view allows you to set up other particle systems 
to react with the boids. 


Target Object 


A data ID to select an object with a particle system set 
on. 


System 
Index of the Object's particle system as set in the list 
view in the particle panel. 


Mode 
Enemy 
Setting the type to Enemy will cause the systems to 
fight with each other. 


Friend 
Will make the systems work together. 


Neutral 
Will not cause them to align or fight with each other. 


Deflection 


Boids will try to avoid deflector objects according to the 
Collision rule’s weight. It works best for convex surfaces 
(some work needed for concave surfaces). 


Force Fields 


As other physics types, Boids is also influenced by external 
force fields. 


In addition, special Bo/d force fields can be used with the 
Boids physics. These effectors could be predators (positive 
Strength) that boids try to avoid, or targets (negative 
Strength) that boids try to reach according to the 
(respectively) Avoid and Goal rules of the Bold Brain. 


Boid Brain 


Reference 


Panel: Particle System » Physics » Boid Brain 


The Boid Brain panel controls how the boids particles will 
react with each other. The boids’ behavior is controlled by a 
list of rules. Only a certain amount of information in the list 
can be evaluated. If the memory capacity is exceeded, the 
remaining rules are ignored. 


The rules are by default parsed from top-list to bottom-list 
(thus giving explicit priorities), and the order can be 
modified using the little arrows buttons on the right side. 


Rule Evaluation 
There are three ways to control how rules are evaluated: 


Average 
All rules are averaged. 


Random 
A random rule is selected for each boid. 


Fuzzy 
Uses fuzzy logic to evaluate rules. Rules are gone 
through top to bottom. Only the first rule that affect 
above the Rule Fuzziness threshold is evaluated. The 
value should be considered how hard the boid will try 
to respect a given rule (a value of 1 means the Boid 
will always stick to it, a value of O means it will never). 
If the boid meets more than one conflicting condition 
at the same time, it will try to fulfill all the rules 
according to the respective weight of each. 


Note 

A given boid will try as much as it can to comply to 

each of the rules it is given, but it is more than likely 
that some rule will take precedence on other in some 
cases. For example, in order to avoid a predator, a boid 
could probably “forget” about Collision, Separate and 
Flock rules, meaning that “while panicked” it could well 
run into obstacles, e.g. even if instructed not to, most of 
the time. 


In Air 
The current rule affects boids while they are flying. 


On Land 
The current rule affects boids while they are not flying. 


Goal Rule 


Seek goal. 


Object 
Specifies the goal object. If not specified, Boid force fields 
with negative Strength are used as goals. 


Predict 
Predict target’s movements. 


Avoid Rule 


Avoid “predators”. 


Object 
Specifies the object to avoid. If not specified, Boid force 
fields with positive Strength are used as predators. 


Predict 
Predict target’s movements. 


Fear Factor 
Avoid object if danger from it is above this threshold. 


Avoid Collision Rule 


Avoid objects with activated Deflection. 


Boids 
Avoid collision with other boids. 


Deflectors 
Avoid collision with deflector objects. 


Look Ahead 
Time to look ahead in seconds. 


Separate Rule 


Boids move away from each other. 


Flock Rule 


Copy movements of neighboring boids, but avoid each 
other. 


Follow Leader Rule 


Follows a leader object instead of a boid. 


Distance 
Distance behind leader to follow. 


Line 
Follow the leader in a line. 


Queue Size 
How many boids that are allowed to follow in a line. 


Average Speed Rule 


Maintain average velocity. 


Speed 
Percentage of maximum speed. 


Wander 
How fast velocity’s direction is randomized. 


Level 
How much velocity’s Z component is kept constant. 


Fight Rule 


Move toward nearby boids. 


Fight Distance 
Attack boids at a maximum of this distance. 


Flee Distance 
Flee to this distance. 


Fluid 


Reference 
Panel: Particle System » Physics 
Type: Fluid 


Fluid particles are similar to Newtonian ones but this time 
particles are influenced by internal forces like pressure, 
surface tension, viscosity, springs, etc. From liquids to slime, 
goo to sand and wispy smoke the number of possible use 
cases is endless. 


Blender particle fluids use the SPH techniques to solve the 
particles fluid equations. Smoothed-particle hydrodynamics 
(SPH) is a computational method used for simulating fluid 
flows. It has been used in many fields of research, including 
astrophysics, ballistics, vulcanology, and oceanography. It is 
a mesh-free Lagrangian method (where the coordinates 
move with the fluid), and the resolution of the method can 
easily be adjusted with respect to variables such as the 
density. 


Options 


Fluid physics share options with Newtonian Physics. These 
are covered on that page. 


Fluid Properties 


Stiffness 
How incompressible the fluid is. 


Viscosity 
Linear viscosity. Use lower viscosity for thicker fluids. 


Buoyancy 
Artificial buoyancy force in negative gravity direction 
based on pressure differences inside the fluid. 


Advanced 


Reference 


Panel: Particle System » Physics » Advanced 


Repulsion Factor 
How strongly the fluid tries to keep from clustering 
(factor of stiffness). Checkbox sets repulsion as a factor 
of stiffness. 


Stiff Viscosity 
Creates viscosity for expanding fluid. Checkbox sets this 
to be a factor of normal viscosity. 


Interaction Radius 
Fluid’s interaction radius. Checkbox sets this to be a 
factor of 4 x particle size. 


Rest Density 
Density of fluid when at rest. Checkbox sets this to bea 
factor of default density. 


Springs 


Reference 


Panel: Particle System » Physics » Springs 


Force 
Spring force. 


Rest Length 
Rest length of springs. Factor of particle radius. Checkbox 
sets this to be a factor of 2 x particle size. 


Viscoelastic Springs 
Use viscoelastic springs instead of Hooke’s springs. 


Elastic Limit 
How much the spring has to be stretched/compressed in 
order to change its rest length. 


Plasticity 
How much the spring rest length can change after the 
elastic limit is crossed. 


Initial Rest Length 
Use initial length as spring rest length instead of 2 x 
particle size. 


Frames 
Create springs for this number of frames since particle’s 
birth (0 is always). 


Render 


Reference 


Panel: Particle System » Render 


The Render Panel controls how particles appear when they 
are rendered. 


Note 


Cycles supports only Object and Collection render types. 


Common Settings 


Scale 
Todo. 


Scale Randomness 
Todo. 


Material 
Set which of the object’s materials is used to shade the 
particles. 


Coordinates System 
Use a different object’s coordinates to determine the 
birth of particles. 


Show Emitter 
When disabled, the emitter is no longer rendered. 
Activate the button Emitter to also render the mesh. 


Render As 


None 


When set to None, particles are not rendered. This is useful 
if you are using the particles to duplicate objects. 


Halo 


Halos are rendered as glowing dots or a little cloud of light. 
Although they are not really lights because they do not cast 
light into the scene like a light object. They are called Halos 
because you can see them, but they do not have any 
substance. 


Path 


The Path visualization needs a Hair particle system or Keyed 
particles. 


B-Spline 
Interpolate hair using B-splines. This may be an option 
for you if you want to use low Render values. You loose a 
bit of control but gain smoother paths. 


Steps 
Set the number of subdivisions of the rendered paths 
(the value is a power of 2). You should set this value 
carefully, because if you increase the render value by 
two you need four times more memory to render. Also 
the rendering is faster if you use low render values 
(sometimes drastically). But how low you can go with this 
value depends on the waviness of the hair (the value is a 


power of 2). This means O steps give 1 subdivision, 1 
give 2 subdivisions, 2 -> 4,3 -> 8,4->16,...n->n?. 


Timing 

Reference 

Panel: Particle System >» Render > Timing 
Type: Hair 


Absolute Path Time 
Path timing is in absolute frames. 


End 
End time of the practical path. 


Random 
Give the path length a random variation. 


Object 


Reference 


Panel: Particle System >» Render > Object 


Instance Object 
The specified object is instanced in place of each particle. 


Global Coordinates 
Use object’s global coordinates for instancing. 


Object Rotation 
Use the rotation of the object. 


Object Scale 


Use the size of the object. 


Collection 


Reference 


Panel: Particle System » Render >» Collection 


Instance Collection 
The objects that belong to a collection are instanced 
sequentially in the place of the particles. 


Whole Collection 
Use the whole group at once, instead of one of its 
elements, the group being displayed in place of each 
particle. 


Pick Random 
The objects in the group are selected in a random order, 
and only one object is displayed in place of a particle. 
Please note that this mechanism fully replaces old 
Blender particles system using parentage and /nstancing 
Vertices to replace particles with actual geometry. This 
method is fully deprecated and does not work anymore. 


Global Coordinates 
Use object’s global coordinates for instancing. 


Object Rotation 
Use the rotation of the objects. 


Object Scale 
Use the size of the objects. 


Use Count 


Reference 


Panel: Particle System >» Render » Collection > 
Use Count 


Use objects multiple times in the same groups. Specify the 
order and number of times to repeat each object with the 
list view that appears. You can duplicate an object in the list 
with the + button, or remove a duplicate with the - button. 


Extra 


Reference 


Panel: Particle System >» Render » Extra 


Parents Particles 
Render also parent particles if child particles are used. 
Children have a lot of different deformation options, so 
the straight parents would stand between their curly 
children. So by default Parents are not rendered if you 
activate Children. See Children. 


Unborn 
Render particles before they are born. 


Dead 
Render particles after they have died. This is very useful 
if particles die in a collision Die on hit, so you can cover 
objects with particles. 


Viewport Display 


Reference 


Panel: Particle System » Viewport Display 


The Display Panel controls how particles are displayed in the 
3D Viewport. This does not necessarily determine how they 
will appear when rendered. 


Display As 
None 
The particles are not shown in the 3D Viewport and 
are not rendered. The emitter may be rendered 
though. 


Rendered 
Particles are displayed the way they are rendered. 


Point 
Particles are displayed as square points. Their size is 
independent of the distance from the camera. 


Circle 
Particles are displayed as circles that face the view. 
Their size is independent of the distance from the 
camera. 


Cross 
Particles are displayed as 6-point crosses that align to 
the rotation of the particles. Their size is independent 
of the distance from the camera. 


Axis 


Particles are displayed as 3-point axes. This is useful if 
you want to see the orientation and rotation of 
particles in the viewport. Increase the Display Size 
until you can clearly distinguish the axis. 


Note 

Particles visualized like Point, Circle, Cross and Axis do 
not have any special options, but can be very useful 
when you have multiple particle systems at play, if you 
do not want to confuse particles of one system from 
another (e.g. in simulations using Boids physics). 


Color 
The Color Menu allows you to display particle’s color 
according to certain particle properties. 


None 
Particles are black. 


Material 
Particles are colored according to the material they 
are given. 


Velocity 
Color particles according to their speed. The color is a 
ramp from blue to green to red, Blue being the 
slowest, and Red being velocities approaching the 
value of Max or above. Increasing Max allows for a 
wider range of particle velocities. 


Acceleration 
Color particles according to their acceleration. 


Amount 


Specifies the percentage of all particles to show in the 
viewport (all particles are still rendered). 


Show Emitter 
Make instancer visible in viewport. 


Children 


Reference 


Panel: Particle System » Children 


Children are Hair or Emitter particles originating from 
individual particles. They make it possible to work primarily 
with a relatively low amount of Parent particles, for whom 
the physics are calculated. The children are then aligned to 
their parents. The number and visualization of the children 
can be changed without a recalculation of the physics. 


If you activate children, the parents are no longer rendered. 
This can be enabled in the Render panel Parent Particles. By 
default, parent particles are not rendered because the 
Shape of the children can be quite different from that of 
their parents. 


Common Options 


Child Type 
None 
No children are generated. 


Simple 
Children are emitted from the parent position. 


Interpolated 
Children are emitted between the Parent particles on 
the faces of a mesh. They interpolate between 
adjacent parents. This is especially useful for fur, 
because you can achieve an even distribution. Some 


of the children can become virtual parents, which are 
influencing other particles nearby. 


Display Amount 
The number of children in the 3D Viewport. 


Render Amount 
The number of children to be rendered. 


Length 
Length of child paths. 


Threshold 
Amount of particles left untouched by child path length. 


Seed 
Offset in the random number table for child particles, to 
get a different randomized result. 


Clumping 


Reference 


Panel: Particle System » Children » Clumping 


Use Clump Curve 
Use Curve Widget instead of parameters. 


Clump 
Clumping amount along child strands. The children may 
meet at their tip (1.0) or start together at their root 
(-1.0). 


Shape 
Form of Clump. Either inverse parabolic (0.99) or 
exponentially (-0.99). 


Twist 
Todo. 


Use Twist Curve 
Todo. 


Clump Noise 


Creates random clumps around the parent hair. 


Clump Noise Size 
The size of the clumps. 


Roughness 


Reference 


Panel: Particle System » Children » Roughness 


Use Roughness Curve 
Use Curve Widget instead of parameters. 


Uniform, Size 
It is based on children location so it varies the paths ina 
similar way when the children are near. 


Endpoint, Shape 
“Rough End” randomizes path ends (a bit like random 
negative clumping). Shape may be varied from <1 
(parabolic) to 10.0 (hyperbolic). 


Random, Size, Threshold 
It is based on a random vector so it is not the same for 
nearby children. The threshold can be specified to apply 


this to only a part of children. This is useful for creating a 
few stray children that will not do what others do. 


Kink 


Reference 


Panel: Particle System » Children >» Kink 


Child particles with Kink. 
From left to right: Curl, Radial, Wave, Braid, Spiral. 


With Kink you can rotate the children around the parent. See 


Fig. Child particles with Kink. above picture for the different 
types of Kink. 


Kink Type 
Nothing 
Deactivated. 


Curl 


Children grow in a spiral around the parent hairs. 


Radial 
Children form around the parent a wave shape that 
passes through the parent hair. 


Wave 
Children form a wave, all in the same direction. 


Braid 
Children braid themselves around the parent hair. 


Spiral 
Generates a spiral at the end of each hair. 


Radius, Resolution 
Define the overall size. 


Shape 
Makes a the spiral grow in- or outward. 


Note 
Alignment Limitations 


When hair is pointing straight up (along the chosen 
Spiral axis, default Z), spirals may not show up! This is a 
limitation of the projection method used. Giving a slight 
tilt or random orientation to hairs fixes this. 


Amplitude 
The amplitude of the offset. 


Clump 
How much clump effects kink amplitude. 


Flatness 
How flat the hairs are. 


Frequency 
The frequency of the offset (1/total length). The higher 
the frequency the more rotations are done. 


Shape 
Where the rotation starts (offset of rotation). 


Simple 


Size 
A multiplier for children size. 


Random Size 
Random variation to the size of child particles. 


Radius 
The radius in which the children are distributed around 
their parents. This is 3D, so children may be emitted 
higher or lower than their parents. 


Roundness 
The roundness of the children around their parents. 
Either in a sphere (1.0) or in-plane (0.0). 


Interpolated 


Virtual Parents 
Relative amount of virtual parents. 


Long Hair 
Calculate children that suit long hair well. 


Parting 


Parting 
Creates parting in the children based on parent strands. 


Min/Max 


The minimum/maximum root to tip angle (tip 
distance/root distance for long hair). 


Example 


From left to right: Round: 0.0, Round: 1.0, Clump: 
1.0, Clump: -1.0, Shape: -0.99. 


Force Fields 
Field Weights 


Reference 


Panel: Particle System » Field Weights 


The Field Weight panel allows you to control how much 
influence each type of external force field, or effector, has 
on the particle system. Force fields are external forces that 
give dynamic system’s motion. The force fields types are 
detailed on the Force Field Page. 


Effector Group 


Limit effectors to a specified group. Only effectors in this 
group will have an effect on the current system. 


Gravity 


Control how much the Global Gravity has an effect on the 
system. 


All 
Scale all of the effector weights. 


Force Fields Settings 


Reference 


Panel: Particle System » Force Fields Settings 


The Force Field Settings panel allows you to make each 
individual act as a force field, allowing them to affect other 
dynamic systems, or even, each other. 


Self Effect 
Causes the particle force fields to have an effect on other 
particles within the same system. 


Effector Amount 
Set how many of the particles act as force fields. O 
means all of them are effectors. 


You can give particle systems up to two force fields. By 
default they do not have any. Choose an effector type from 
the selector to enable them. Settings are described in the 
Common Settings section. 


Vertex Groups 


Reference 


Panel: Particle System >» Vertex Groups 


The Vertex groups panel allows you to specify vertex groups 
to use for several child particle settings. You can also negate 
the effect of each vertex group with the checkboxes. You 
can affect the following attributes: 


Density 
Defines the density of the particle distribution. 


Length 
Defines the length of the hair. 


Clump 
Controls the amount of clumping. The weight of 1.0 gives 
current Clump value, weight of 0.0 completely removes 
effect. 


Kink 
Controls the frequency of the children Kink. 


Roughness 1 
Adjusts the Uniform roughness parameter. 


Roughness 2 
Adjusts the Random roughness parameter. 


Roughness End 
Adjusts the Endpoint roughness parameter. 


Twist 


Vertex group to control the children’s Twist effect. Gives 
control over the direction of the twist, as well as the 


amount. The weight of 0.5 is neutral, i.e. there is no twist 
effect. 


Hair 


Introduction 
o Growing 
o Styling 
o Animating 
o Rendering 
Emission 
e Hair Dynamics 
o Collisions 
o Structure 
o Volume 
Render 
Shape 
Children 
Viewport Display 


Introduction 


Hair type particle system can be used for strand-like 
objects, such as hair, fur, grass, quills, etc. 


Particle hair systems example. Used for the grass 
and fur. 


Growing 


The first step is to create the hair, specifying the amount of 
hair strands and their lengths. 


The complete path of the particles is calculated in advance. 
So everything a particle does a hair may do also. A hair is as 
long as the particle path would be for a particle with a 
lifetime of 100 frames. Instead of rendering every frame of 
the particle animation point by point there are calculated 
control points with an interpolation, the segments. 


Styling 


The next step is to style the hair. You can change the look of 
base hairs by changing the Physics Settings. 


A more advanced way of changing the hair appearance is to 
use Children. This adds child hairs to the original ones, and 
has settings for giving them different types of shapes. 


You can also interactively style hairs in Particle Edit Mode. In 
this mode, the particle settings become disabled, and you 
can comb, trim, lengthen, etc. the hair curves. 


Animating 


Hair can be made dynamic using the cloth solver. This is 
covered in the Hair Dynamics page. 


Rendering 


With Cycles you can render hair with specialized hair BSDFs 
Hair BSDF or Principled Hair BSDF. 


Hair can also be used as a basis for the Particle Instance 
Modifier, which allows you to have a mesh be deformed 
along the curves, which is useful for thicker strands, or 
things like grass, or feathers, which may have a more 
specific look. 


Emission 


Reference 


Panel: Particle System » Emission 


Number 
Set the amount of hair strands. Use as little particles as 
possible, especially if you plan to use soft body animation 
later. But you need enough particles to have good 
control. For a “normal” haircut | found some thousand 
(very roughly 2000) particles to give enough control. You 
may need a lot more particles if you plan to cover a body 
with fur. Volume will be produced later with Children. 


Hair Length 
Controls how long the hair are. 


See also 


Emitter particles Emission panel 


Hair Dynamics 


Reference 


Panel: Particle System » Hair Dynamics 


Hair particles can have dynamic properties using physics. To 
enable hair physics, click the checkbox beside Hair 
Dynamics. 


Quality Steps 
Quality of the simulation in steps per frame (higher is 
better quality but slower). 


Pin Goal Strength 
Spring stiffness of the vertex target position. 


Warning 
If you use motion blur in your animation, you will need to 


bake one extra frame past the last frame which you will be 
rendering. 


Collisions 


Quality 
A general setting for how fine and good a simulation you 
wish. Higher numbers take more time but ensure less 
tears and penetrations through the hair. 


Distance 


The distance another object must get to the hair for the 
simulation to repel the hair out of the way. Smaller values 
might cause errors but provide some speed-up while 
larger will give unrealistic results if too large and can be 
Slow. It is best to find a good in between value. 


Impulse Clamping 
Prevents explosions in tight and complicated collision 
situations by restricting the amount of movement after a 
collision. 


Collision Collection 
Only objects that are a part of this Collection can collide 
with the hair. Note that these objects must also have 
Collision physics enabled. 


Structure 

Reference 

Panel: Particle System » Hair Dynamics » 
Structure 

Mass 


Value for the mass of the hair. 


Stiffness 
Controls the bending stiffness of the hair strands. 


Random 
Random stiffness of hair. 


Damping 
Damping of bending motion. 


Volume 


Reference 


Panel: Particle System » Hair Dynamics » 
Volume 


Some phenomena of real-world hair can be simulated more 
efficiently using a volumetric model instead of the basic 
geometric strand model. This means constructing a regular 
grid such as those used in fluid simulations and 
interpolating hair properties between the grid cells. 


Air Drag 
Controls how thick the air is around the hair causing the 
hair to flow slower. 


Internal Friction 
Amount of friction between individual hairs. 


Voxel Grid Cell Size 
Size of the voxel grid cells for interaction effects. 


Density Target 
Maximum density if the hair. 


Density Strength 
The influence that the Density Target has on the 
simulation. 


Render 


Reference 


Panel: Particle System » Render 


Hair can be rendered as a Path, Object, or Group. See 
Particle Visualization for descriptions and the Hair Shape 
settings. 


See also 


Blender Hair Basics, a thorough overview of all of the hair 
particle settings. 


Shape 


Reference 


Panel: Particle System >» Hair Shape 


These settings control the shape of hair curves for 
rendering. 


Strand Shape 
A shape parameter that controls the transition in 
thickness between the root and tip. Negative values 
make the primitive rounded more towards the top, the 
value of zero makes the primitive linear, and positive 
values make the primitive rounded more towards the 
bottom. 


Diameter Root 
Multiplier of the hair width at the root. 


Tip 
Multiplier of the hair width at the tip. 


Radius Scale 
Multiplier for the Root and Tip values. This can be used to 
change the thickness of the hair. 


Close Tip 
Sets the thickness at the tip to zero, even when using a 
nonzero tip multiplier. 


Children 


Reference 


Panel: Particle System » Children 


See Children. 


Viewport Display 


Reference 


Panel: Particle System » Display 


Rendered 
Display hair as curves. 


Path 
Display just the end points of the hairs. 


Steps 
The number of segments (control points minus 1) of the 
hair strand. In between the control points the segments 
are interpolated. The number of control points is 
important: 


e For the soft body animation, because the control 
points are animated like vertices, So more control 
points mean longer calculation times. 

e For the interactive editing, because you can only 
move the control points (but you may recalculate the 
number of control points in Particle Edit Mode). 


Hint 
Segments 
Ten Segments should be sufficient even for very long 


hair, five Segments are enough for shorter hair, and two 
or three segments should be enough for short fur. 


Texture Influence 


Reference 


Panel: Texture » Influence 


Defines the settings of a Particle system spatial with a 
texture. 


General 
Time 
Affect the emission time of the particles. 


Lifetime 
Affect the life time of the particles. 


Density 
Affect the density of the particles. 


Size 
Affect the particles size. 


Physics 


Velocity 
Affect the particles initial velocity. 


Damp 
Affect the particles velocity damping. 


Gravity 


Affect the particles gravity. 


Force Fields 
Affect the particles force fields. 


Hair 
Length 
Affect the child hair length. 


Clump 

Affect the child clumping. 
Kink 

Affect the child kink. 


Rough 
Affect the child roughness. 


Particle Edit Mode 


Using Particle Edit Mode you can edit the keyed points 
(keyframes) and paths of Hair, Particle, Cloth, and Soft Body 
simulations. (You can also edit and style hair before baking.) 


Since working in Particle Edit Mode is pretty easy and very 
similar to working with vertices in the 3D Viewport, we will 
show how to set up a particle system and then give a 
reference of the various functions. 


Important 
Particle Edit Mode, specifically for hair is deprecated; 


please use the new Empty Hair object with its associated 
Sculpt Mode instead. 


Usage 


Tip 
Only Frames Baked to Memory are Editable! 


If you cannot edit the particles, check that you are not 
baking to a Disk Cache. 
Setup for Hair Particles 


1. Create a Hair particle system. 
2. Give it an initial velocity in the Normal direction. 


3. Create a simulation. 
4. Check the Hair Dynamics box. 


Weight 


_0.500_) 


Particles 


Y Deflect emitter 
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Editing hair strands in Particle Edit Mode. 


Setup for Particle, Cloth, and Soft Body 
Simulations 


1. Use Emitter particles, or a cloth/soft body simulation. 

2. Create a simulation by setting up objects and or 
emitters, set your time range (use a small range if you 
are just starting out and experimenting), set up the 
Simulation how you want it, using Alt-A to preview it. 


Bake the Simulation 


Once you are happy with the general simulation, bake the 
simulation from Object Mode. The simulation must be baked 
to enable editing. 


Edit the Simulation 


Switch to Particle Edit from the Mode select menu in the 
header of the 3D Viewport to edit the particle’s 
paths/Keyframes. You may need to press T from within the 
3D Viewport to see the Particle Edit panel. Move to the 
frame you want to edit and use the various Particle Edit 
tools to edit your simulation. Work slowly, previewing your 
changes with Alt-A, and save often so that you can go back 
to the previous version should something happen, or that 
you do not like the latest changes you have made. 


Tip 
To be able to clearly see what you are working on: 


1. Open the Options panel in the Toolbar. 

2. Select Point select mode (see below) in the header of 
the 3D Viewport. This will display key points along the 
particle path. 


Selecting 


Single: LMB. 

All: A. 

Linked: Move the mouse over a keypoint and press L. 
Box select: B. 

Circle Select c. 

Lasso Select Ctrl-Alt-LMB. 

Root/Tips: Select » Roots / Tips. 


You may also use the Se/ect Menu. 


Tip 
Selections 


Selections are extremely useful for modifying only the 
particles that you want. Hover over a particle path and 
press L to link-select it, hover over the next and press L to 
add that path to the selection. To remove a path, hold Shift 
and press L. To Deselect all press A. 


The method to select individual points is the same as in 
Edit Mode. RmB to select, Shift-RMB to add/remove a point 
from the selection. 


Select Random 


Randomly selects particles. 


Percent 
Percent of particles to randomly select. 


Random Seed 
Seed value to use for the selection. 


Action 
Select random can be either used to select or deselect 


particles. 


Type 
Selects either hair or points. Here these terms can be 
confusing because hair/point does not refer to the 
particle type but the path/points of the hair/particle. 


Select Modes 


D till» 
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Select Modes. 
Path 
No keypoints are visible, you can select/deselect only all 
particles. 


Point 
You see all of the keypoints. 


Tip 
You can see and edit (including the brushes) only the tip 
of the particles, i.e. the last keypoint. 


Tools 

Reference 
Mode: Particle Edit Mode 
Tool: Toolbar 

Comb 


Moves the keypoints (similar to the Proportional Editing 
tool). 
Deflect Emitter 
Hair particles only - Do not move keypoints through the 
emitting mesh. 


Distance 
The distance to keep from the Emitter. 


Smooth 


Parallels visually adjacent segments. 


Add 


Adds new particles. 


Count 
The number of new particles per step. 


Interpolate 
Interpolate the shape of new hairs from existing ones. 


Steps 
Amount of brush steps. 


Keys 
How many keys to make new particles with. 


Length 


Scales the segments, so it makes the hair longer with Grow 
or shorter with Shrink. 


Grow/Shrink 
Sets the brush to add the effect or reverse it. 


Puff 


Rotates the hair around its first keypoint (root). So it makes 
the hair stand up with Add or lay down with Sub. 


Puff Volume 


Apply puff to unselected end points, (Helps to maintain 
the hair volume when puffing the root.) 


Cut 


Scales the segments until the last keypoint reaches the 
brush. 


Weight 


This is especially useful for soft body animations, because 
the weight defines the soft body Goal. A keypoint with a 
weight of 1 will not move at all, a keypoint with a weight of 
O subjects fully to soft body animation. This value is scaled 
by the Strength Min to Max range of soft body goals... 


Common Options 


Below the brush types, their settings appear: 


Radius F 
Set the radius of the brush. 


Strength Shift-F 
Set the strength of the brush effect (not for Add brush). 


Options 


Reference 


Mode: Particle Edit Mode 
Panel: Tool Settings » Options 


Auto-Velocity Emitter 
Recalculate velocities of particles according to their 
edited paths. Otherwise, the original velocities values 
remains unchanged regardless of the actual distance that 
the particles moves. 


Mirror X 
Enable mirror editing across the local X axis. 


Preserve 
Strand Length 
Keep the length of the segments between the 
keypoints when combing or smoothing the hair. This is 
done by moving all the other keypoints. 


Root Positions 
Keep first key unmodified, so you cannot transplant 
hair. 


Cut Particles to Shape 


Shape Object 
A mesh object which boundary is used by the Shape Cut 
tool. 


Cut 
This grooming tool trims hairs to a shape defined by the 
Shape Object. This is a quicker way of avoiding 
protruding hair sections from lengthening than using the 
Cutting tool. It works especially well for characters with 
extensive fur, where working in a single plane with the 
Cutting tool becomes tedious. 


Shape Cut example. 


Before. After. 


Viewport Display 


Path Steps 


The number of steps used to draw the path; improves the 
smoothness of the particle path. 


Children Hair 


Displays the children of the particles too. This allows to 
fine-tune the particles and see their effects on the result, 
but it may slow down your system if you have many 
children. 


Particles Emitter 
Displays the actual particles on top of the paths. 


Fade Time 
Fade out paths and keys further away from current time. 


Frames 
How many frames to fade. 


Editing 


Moving Keypoints or Particles 


e To move selected keypoints press G, or use one of the 
various other methods to move vertices. 

e To move a particle root you have to turn off Keep Root in 
the Toolbar. 

e You can do many of the things like with vertices, 
including scaling, rotating and removing (complete 
particles or single keys). 

e You may not duplicate or extrude keys or particles, but 
you can subdivide particles which adds new keypoints 
Particle >» Subdivide. 

e Alternatively you can rekey a particle Particle >» Rekey. 


How smoothly the hair and particle paths are displayed 
depends on the Path Steps setting in the Toolbar. Low 
settings produce blocky interpolation between points, while 
high settings produce a smooth curve. 


Mirror 

Reference 

Mode: Particle Edit Mode 
Menu: Particle > Mirror 


If you want to create an X axis symmetrical haircut you have 
to do following steps: 


1. Select all particles with A. 
2. Mirror the particles with Particle >» Mirror. 
3. Turn on X Mirror in Sidebar Region >» Tool » Options. 


It may happen that after mirroring two particles occupy 
nearly the same place. Since this would be a waste of 


memory and render time, you can use Merge by Distance 
from the Particle menu. 


Unify Length 


Reference 
Mode: Particle Edit Mode 
Menu: Particle » Unify Length 


This tool is used to make all selected hair uniform length by 
finding the average length. 


Show/Hide 

Reference 

Mode: Particle Edit Mode 
Menu: Particle » Show/Hide 


Hiding and unhiding of particles works similar as with 
vertices in the 3D Viewport. Select one or more keypoints of 
the particle you want to hide and press H. The particle in fact 
does not vanish, only the key points. 


Hidden particles (i.e. particles whose keypoints are hidden) 
do not react on the various brushes. But: 


If you use Mirror Editing even particles with hidden 
keypoints may be moved, if their mirrored counterpart is 
moved. 


To unhide all hidden particles press Alt-H. 


Dynamic Paint 
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Introduction 


Dynamic paint is a modifier and physics system that can 
turn objects into paint canvases and brushes, creating Color 
Attributes, image sequences, or displacement. This makes 
many effects possible like, for example footsteps in the 
snow, raindrops that make the ground wet, paint that sticks 
to walls, or objects that gradually freeze. 


Activating the Modifier 


@ Cube 


Enable physics for 


3s Force Field Ke Soft Body 
oy Collision Fluid 
1 eh Cloth Smoke 
a Dynamic Paint Rigid Body 
aby Rigid Body Constrai.. 


How to activate the Dynamic Paint. 


Dynamic Paint can be activated from the “Physics” tab of 
the “Properties” editor. 


Types 
Modifier itself has two different types Canvas and Brush. 


Note 


You can also enable brush and canvas simultaneously. In 
that case same object’s “brush” does not influence its 
“canvas”, but can still interact with other objects in the 
scene. 


See also 


e Astep-by step introduction. 
e A detailed guide that covers every setting with images 
and examples (currently not up-to-date). 


Brush 


Reference 
Panel: Physics » Dynamic Paint 
Type: Brush 


The Brush type makes object apply paint on the canvas. 


¥ Dynamic Paint 
Type Brush 
¥ Settings 
Remove Brush 


Paint Color 
Alpha 1.00 
Wetness 1.00 
Absolute Alpha  * 


Erase Paint 


Paint O) Mesh Volume 


» Velocity 


Brush main panel. 


From the first brush panel you can define how brush affects 
canvas color surfaces. 


Paint Color 
Color of the paint. 


Alpha 


Defines brush alpha or visibility. Final wetness is also 
affected by alpha. 


Wetness 
Defines how “wet” new paint is. Wetness is visible on 
“Paint” surface “wetmap”. Speed of “Drip” and “Spread” 
effects also depends on how wet the paint is. 


Absolute Alpha 
This setting limits brush alpha influence. Without it, brush 
is “added” on surface over and over again each frame, 
increasing alpha and therefore influence of brush on 
canvas. In many cases however, it is preferred to not 
increase brush alpha if it already is on brushes level. 


Erase Paint 
Makes brush dissolve existing paint instead of adding it. 


Source 

Reference 

Type: Brush 

Panel: Physics » Dynamic Paint » Source 


Paint Source 


Paint Source setting lets you define how brush 
influence/intersection is defined. 


Mesh Volume 
The Brush affects all surface point inside the mesh 
volume. 


Source: Mesh Volume. 


Proximity 
Only uses defined distance to the closest point on brush 
mesh surface. Note that inside of the volume is not 


necessarily affected because it is not close to the 
Surface. 


Source: Proximity. Brush affects all canvas pixels 
around it. 


Mesh Volume + Proximity 


Same as volume type, but also has influence over 
defined distance. 


Inner Proximity 
Applies proximity inside the mesh volume. 


Negate Volume 
Negates brush alpha within mesh volume. 


The Volume + Inner Proximity. 
Proximity brush Proximity falloff is 
with no additional now visible inside 
settings. the volume. 


Negate Volume. 
Inner side of the 


Inner Proximity and 


volume has 

Negate Volume 
become 

enabled together. 
completely 
transparent. 


Object Center 
Instead of calculating proximity to the brush object mesh, 
which can be quite slow in some cases, only distance to 
only center is calculated. This is much faster and often 
good enough. 


Source: Object Center. 


Particle System 


Brush influence is defined by particles from a selected 
particle system. 


Effect Solid Radius 
Defines the distance, inside 
which paint is solid color. 


Use Particle Radius 
Uses the settings in the 
particle panel to determine 
solid radius size. Solid Radius 
size disabled while Particle Radius enabled. 


Smooth Radius 


An additional radius outside Solid Radius to add a 
smooth falloff. 


If you set “Smooth Radius” to zero, particle will be 
painted as a solid sphere. If you set “Solid Radius” to 
zero, it gets painted as a smooth halo. 


Solid: 0.0 Solid: 0.5 Solid: 1.0 
Smooth: 1.0 Smooth: 0.5 Smooth: 0.0 


Source: Particle System. 


Common Options 


Paint Distance 
The maximum distance to mesh surface to affect paint. 


Project 
Projects brush to the canvas from a defined direction. 
Basically this can be considered as “direction aligned” 
proximity. 


The Project option enabled. See how brush only 
affects canvas in normal direction. 


Falloff 
Sharp 
Paints solid paint within the defined distance. 


Smooth 
Makes paint to linearly fade out until becoming 
completely invisible when it reaches the maximum 


distance. 
Color Ramp 

Allows you to manually make a custom falloff 
behavior. 

Velocity 

Reference 

Type: Brush 

Panel: Physics » Dynamic Paint > Velocity 


This panel shows brush options that are based on object 
velocity. 


On top you have a color ramp and several related settings. 
Basically the color ramp represents brush velocity values: 
left side being zero velocity and right side being the “Max 
velocity”. Speed is measured in “units per frame”. 


Checkboxes above can be used to define color ramp 
influence. 


Multiply Alpha 
Uses color ramp’s alpha value depending on current 
velocity and multiplies brush alpha with it. 


Replace Color 
Replaces the brush color with the values from the Color 
Ramp Widget. 


Multiply Depth 
Multiplies brushes “depth intersection” effect. Basically 
you can adjust displace and wave strength depending on 
brush speed. 


Do Smudge 
Enabling Smudge makes the brush “smudge” (or 
“smear”) existing colors on the surface as it moves. The 
strength of this effect can be defined from the Smudge 
Strength property. 


Even when smudge is enabled brush still does its normal 
paint effect. If you want a purely smudging brush use 
zero alpha. It is also possible to have Erase option 
enabled together with smudge. 


Waves 

Reference 

Type: Brush 

Panel: Physics » Dynamic Paint » Waves 


” 


This panel is used to adjust brush influence to “Wave 
surfaces. 


Wave Type 
Select what effect the brush creates in the wave 
simulation. 


Depth Change 


The brush create waves when the intersection depth 
with the surface is changed on that point. If the brush 
is not moved, it will have no effect. 


Using a negative “Factor” with this type can create a 
nice looking “wake” for moving objects like ships. 


Obstacle 


Constantly affects surface whenever intersecting. 
Waves are also reflected off this brush type. However, 
due the nature of wave simulation algorithm this type 
creates an unnatural “dent” in the surface if the brush 
is not moved. 


Force 


Directly affects the velocity of wave motion. Therefore 
the effect is not one-to-one with brush intersection 
depth, yet the force strength depends on it. 


Reflect Only 


This type has no visible effect on the surface alone 
but reflects waves that are already on the surface. 


Factor 


Adjusts how strongly brush “depth” affects the 
simulation. You can also use negative values to make 
brush pull water up instead of down. 


Clamp Waves 
In some cases the brush goes very deep inside the 
surface messing whole simulation up. You can use this 
setting to “limit” influence to only certain depth. 


Canvas 


Reference 
Panel: Physics » Dynamic Paint 
Type: Canvas 


The Canvas type makes object receive paint from Dynamic 
Paint brushes. 


Paint Surface * Dynamic Paint 
A list of Dynamic Paint Type Canvas 
surfaces. These surfaces 
are basically layers of 
paint, that work 
independently from each 
other. You can define 


¥ Settings 


Remove Canvas 


individual settings for Format °° Vertex 
them and bake them Anti-aliasing 
separate ly. Frame Start 
End 
Is Active Sub-Steps 
The checkbox toggles ” Surface 
whether surface is Surface Type #* Paint 
active at all. If not sesh colecten (75 
selected no mn Colle = 


Scale Influence 


calculations are done. a 
Below you can set surface > Dissolve 
type and adjust quality and > @ Dy 
timing settings. aa 


Format Canvas main panel. 


Each surface has a 
certain format and type. Format determines how data is 
stored and outputted. 


Vertex 
Dynamic Paint operates directly on mesh vertex data. 
Results are stored by point cache and can be 
displayed in viewports. However, using vertex level 
also requires a highly subdivided mesh to work. 


Image Sequences 
Dynamic Paint generates UV wrapped image files of 
defined resolution as output. 


Quality 
Resolution 
You can adjust the output image dimensions for the 
Image Sequences surface type. For example using 256 
will lead to 256x256 image output. Doubling the 
resolution will likely quadruple the baking time and 
vice versa. 


Anti-Aliasing 
Anti-Aliasing to smooth paint edges using a 5x 
multisampling method. 


Frames 


Start, End 
Defines surface processing start and end frame. 


Sub-steps 


Sub-steps are extra samples between frames. They 
are usually required when there is a very fast brush. 


Surface 


Reference 


Type: Canvas 
Panel: Physics » Dynamic Paint » Surface 


From Surface panel you can adjust surface type and related 
settings. 


Surface Type 


Each surface has a “type” that defines what surface is used 
for. 


Paint 


Paint Surface. 


Paint is the basic surface type that outputs color and 
wetness values. In case of vertex surfaces, results are 
outputted as Color Attributes. 


A wetmap is a black-and-white output that visualizes paint 
wetness. White being maximum wetness, black being 
completely dry. It is usually used as mask for rendering. 
Some “paint effects” affect wet paint only. 


Dry 


Completely disable drying is useful for indefinitely 
Spreading paint. 


Color Dry 
It can be used to define wetness level when paint 
colors start to shift to surface “background”. Lower 
values can be useful to prevent spreading paint from 
becoming transparent as it dries, while higher values 
give better results in general. 


Displace 


Displace Surface. 


This type of surface outputs intersection depth from brush 
objects. 


Incremental 
A new displace is added cumulatively on top of an 
existing displace. 


Max Displace 
The maximum level of intersection depth, larger values 
will be clamped to this value. 


Displace Factor 
The multiplier for the intersection depth. You can use it to 
adjust final displace strength or use negative values to 


paint bumps. 
Tip 
If the displace output seems too rough it usually helps to 


add a Smooth Modifier after Dynamic Paint in the modifier 
stack. 


Waves 


Waves Surface. 


This surface type produces simulated wave motion. Like 
displace, wave surface also uses brush intersection depth to 
define brush strength. 


Open Borders 


Allows waves to pass through mesh “edges” instead of 
reflecting from them. 


Timescale 
Directly adjusts simulation speed without affecting 
simulation outcome. Lower values make simulation go 
Slower and otherwise. 


Speed 


Affects how fast waves travel on the surface. This setting 
is also corresponds to the size of the simulation. Half the 
speed equals surface double as large. 


Damping 
Reduces the wave strength over time. Basically adjusts 
how fast wave disappears. 


Spring 
Adjusts the force that pulls water back to “zero level”. 


Smoothness 
Limits the maximum steepness of the wave slope 
between simulation points. This greatly helps getting rid 
of the “noise” that occurs when using objects with sharp 
edges (like cubes) as a brush. The default value should 
be enough to only get rid of the sharpest spikes, in order 
to get even smoother waves use higher values at the 
expense of reduced detail. 


Tip 
In some cases the wave motion gets very unstable around 


brush. It usually helps to reduce wave speed, brush “wave 
factor” or even the resolution of mesh/surface. 


Weight 


Weight Surface. 


This is a special surface type only available for vertex 
format. It outputs vertex weight groups that can be used by 
other Blender modifiers and tools. 


Tip 


It is usually preferred to use “proximity” based brushes for 
weight surfaces to allow smooth falloff between weight 
values. 


Common Options 


For each surface type there are special settings to adjust. 
Most types have the settings Dissolve and Brush: 


Dissolve 
Used to make the surface smoothly return to its original 
state during a defined Time period. 


Brush Collection 
Used to define a specific collection to pick brush objects 
from. 


Influence Scale, Radius Scale 


For tweaking brush settings individually for each surface. 


Output 

Reference 

Type: Canvas 

Panel: Physics » Dynamic Paint » Output 


From Output panel you can adjust how surface outputs its 
results. 


Vertex 


For Vertex format surfaces, you can select a mesh data 
layer (color/weight depending on surface type) to generate 
results to. You can use the “+”/”"-” icons to add/remove a 
data layers of given name. If layer with given name is not 
found, it is shown as red. 


Image Sequence 


For Image Sequence surfaces, you can define used UV maps 
and output file saving directory, filenames and image 
format. 


Initial Color 


Reference 


Type: Canvas 
Panel: Physics » Dynamic Paint » Initial Color 


Allows you to define the initial color of the canvas. (Todo 
2.62) 


e None 

e Color 

e UV Texture 
e Vertex Color 


Effects 

Reference 

Type: Canvas 

Panel: Physics » Dynamic Paint » Effects 


This is a special feature for “Paint” type surface. It 
generates animated movement on canvas surface. 


Effects 
Spread 
Paint slowly spreads to surrounding points eventually 
filling all connected areas. 


Drip 
Paint moves in specific direction specified by Blender 
force fields, gravity and velocity with user-defined 
influences. 


Shrink 
Painted area slowly shrinks until disappears 
completely. 


For spread and drip effects, only “wet paint” is affected, so 
as the paint dries, movement becomes slower until it stops. 


Cache 


Reference 
Type: Canvas 
Panel: Physics » Dynamic Paint » Cache 


This panel is currently only visible for Vertex format 
surfaces. You can use it to adjust and bake point cache. 


Forces 


e Gravity 
e Force Fields 
o Introduction 


o Types 


Gravity 


Reference 


Panel: Scene » Gravity 


Gravity is a global setting that is applied to all physics 
systems in a scene. It can be found in the scene tab. This 
value is generally fine left at its default, -9.810 on the Z 
axis, which is the force of gravity in the real world. Changing 
this value would simulate a lower or higher force of gravity. 
Gravity denoted g, measurement m x s%. 


Gravity is applied in the same way to all physics systems. 


Gravity is practically the same around the entirety of planet 
Earth. For rendering scenes from the Moon, use a value six 
times smaller, i.e. 1.622 m x s. The planet Mars has a 
gravity value of 3.69. 


Note 


The gravity value per physics system can be scaled down 
in the Field Weights tab. 


Force Fields 


Introduction 
o Creating_a Force Field 
o Common Field Settings 


Charge 

Curve Guide 
Drag, 

Fluid Flow 
Force 
Harmonic 
Lennard-Jones 
Magnetic 
Texture 
Turbulence 


Introduction 


Force fields offer a way to influence a simulation, in example 
to add extra movement. Particles, Soft Bodies, Rigid Bodies, 
and Cloth objects can all be affected by forces fields. Force 
fields automatically affect everything. To remove a 
simulation or particle system from their influence, simply 
turn down the influence of that type of force field in its Field 
Weights panel. 


e All types of objects and particles can generate fields, 
but only curve object can bear a Curve Guide field. 

e Force fields can also be generated from particles. See 
Particle Physics. 

e The objects need to share at least one common layer to 
have an effect. 


You may limit the effect on particles to a group of objects 
(see the Particle Physics page). 


Creating a Force Field 


Reference 

Mode: Object Mode 

Menu: Add » Force Field 
Panel: Physics » Force Field 


To create a single force field, you can select Add » Force 
Field and select the desired force field. This method creates 
an empty with the force field attached. 


Examples of an empty with the force field attached. 


Vortex Wind force Force force 
force field. field. field. 


To create a field from an existing object you have to select 
the object and change to the Physics tab. Select the field 
type in the Fields menu. 


Note 


After changing the fields Fields panel or deflection Collision 
panel settings, you have to recalculate the particle, soft 
body or cloth system by Free Cache, this is not done 
automatically. 


Particles react to all kinds of force fields, soft bodies only 
to Force, Wind, Vortex (they react on Harmonic fields but 
not in a useful way). 


Common Field Settings 


Most fields have the same settings, even though they act 
very differently. Settings unique to a field type are described 
below. Curve Guide and Texture fields have very different 
options. 


Shape 
Sets the direction which is used to calculate the effector 
force. For force fields from an empty object only Point, 
Line and Plane shapes are available, as for a field from a 


3D object there are additional Surface and Every Point 
options, and Curve for a field from a curve. 


Point: Point with omni-directional influence. 
Uses the object origin as the effector 
point. 

Line: The force only acts in the local XY 
plane, using the Z axis line as the 
effector. 

Plane: The force only acts in the local Z 
direction, using the XY axis plane as 
the effector. 

Surface: The force field acts on a 3D object’s 
surface. In this case, the Z axis is the 
surface normal. 

Every Point: Uses every vertex in the mesh object 
as an effector point. 


Strength 
The strength of the field effect. This can be positive or 
negative to change the direction that the force operates 
in. A force field’s strength is scaled with the force object’s 
scale, allowing you to scale up and down the scene, 
keeping the same effects. 


Flow 


If nonzero, this adds a drag force proportional and 
opposite to the point velocity. 


This effectively re-interprets the force field so that the 
Strength to Flow ratio at a certain point defines the 
velocity of an “air flow” field, and objects are encouraged 
to follow the flow by the resistance caused by the Flow 
drag force. 


Affect 


Location 
Influence the location of particles and other physics 
entities. 


Rotation 
Influence the rotation of particles with Dynamic 
Rotation. The option is not relevant for other types of 
physics systems. 


Disabling both options completely deactivates the force 
field. 


Noise Amount 
Adds noise to the strength of the force. 


Seed 
Changes the seed of the random noise. 


Absorption 
Force gets absorbed by collision objects. 


Wind Factor 
Specifies how much the force is reduced when acting 
parallel to a surface, e.g. cloth. If set to 1, only the 
normal component of the force is taken into account. 


Falloff 


Here you can specify the shape of the force field (if the 
falloff Power is greater than 0). 


Shape 
Cone: The falloff results in a cone-shaped 
force field. Additional options are the 
same as those of Tube options. 
Sphere: 


The falloff is uniform in all directions, as 
in a sphere. 

Tube: The falloff results in a tube-shaped 
force field. The field’s Radial Power can 
be adjusted, as well as the Minimum 
and Maximum distances of the field. 


Z Direction 
The direction the force affects on the Z axis. 


+Z: The force only has an affect on the 
positive Z axis. 

-Z: The force only has an affect on the 
negative Z axis. 

Both Z: The force has an affect on the positive 


and negative Z axis. 


Power 
How the power of the force field changes with the 
distance from the force field. If ris the distance from the 
origin of the object, the force changes with 1/(r - min + 
1)Power A falloff of 2 changes the force field with 1/(r - 
min + 1)2, which is similar to the falloff of gravitational 
pull. 


Min Distance 
The distance from the object’s origin, up to where the 
force field is effective with full strength. If you have a 
falloff of O, this parameter will have no effect, because 
the field is effective with full strength up to Max Distance 
(or infinite). Shown by an additional circle around the 
object. 


Max Distance 
Specifies the maximum radius in which the force field 
affects other objects (shown by an additional circle 


around the object). 


Boid 


Reference 
Panel: Physics » Force Fields 
Type: Boid 


The Boid force fields do not affect physics, and are used 


together with the Boids Particles to define boid predators 
and goals for the Boid Brain rules. 


Charge 


Reference 
Panel: Physics » Force Fields 
Type: Charge 


A Charge force field is similar to a Force field except it 
changes it’s behavior (attract/repulse) based on the effected 
particles charge field (negative/positive), like real particles 
with a charge. Which means that this field has only an effect 
on particles that have also a Charge field (else, they have 
no “charge”, and hence are unaffected)! 


Example 


Curve Guide 


Reference 
Panel: Physics » Force Fields 
Type: Curve Guide 


The Curve Guide is used to force particles to follow a certain 
path defined by a Curve Object. A typical scenario would be 
to move a red blood cell inside a vein, or to animate the 
particle flow in a motor. You can also use Curve Guide to 
Shape certain hair strands. 


Note 


You can also use the Particle Edit Mode to define a path. 


Since you can animate curves as a soft body or any other 
usual way, you may build very complex animations while 
keeping great control and keeping the simulation time to a 
minimum. 


The option Curve Follow does not work for particles. Instead 
you have to set Angular Velocity (Particle system tab) to 
Spin and leave the rotation constant (i.e. do not turn on 
Dynamic). 


A Curve Guide force affects all particles on the same layer, 
independently from their distance to the curve. If you have 
several guides in a layer, their fields add up to each other 
(the way you may have learned it in your physics course). 


But you can limit their influence radius by changing the 
Minimum Distance (see below). 


A particle follows a Curve Guide during its lifetime, the 
velocity depends on its lifetime and the length of the path. 


Note 


The Curve Guide does not affect soft bodies. 


Options 


Free 
Fraction of particle life time, that is not used for the 
curve. 


Falloff Power 
This setting governs the strength of the guide between 
Min Distance and Max Distance. A falloff of 1 means a 
linear progression. 


Additive 
If you use Additive, the speed of the particles is also 
evaluated depending on the falloff. 


Weights 
Use Curve weights to influence the particle influence 
along the curve. 


Clumping Amount 
The particles come together at the end of the curve (1) 
or they drift apart (-1). 


Shape 


Defines the form in which the particles come together. 
+0.99: the particles meet at the end of the curve. 0: 
linear progression along the curve. -0.99: the particles 
meet at the beginning of the curve. 


Min Distance 
The distance from the curve, up to where the force field 
is effective with full strength. If you have a falloff of 0, 
this parameter will have no effect, because the field is 
effective with full strength up to Max Distance (or the 
infinity). Min Distance is shown with a circle at the 
endpoints of the curve in the 3D Viewport. 


Max Distance 
The maximum influence radius. Shown by an additional 
circle around the curve object. 


Kink 


Warning 


This feature is broken in the current version, see T46776. 


Type 

Changes the shape that the particles can take. 

None: Todo. 

Braid: Braid. 

Curl: The radius of the influence depends on 
the distance of the curve to the 
emitter. 

Radial: A three-dimensional, standing wave. 

Roll: A one-dimensional, standing wave. 


Rotation: Todo. 


Wave: A two-dimensional, standing wave. 


It is not so easy to describe the resulting shapes, so have 
a look at the example below. 


Kink options of a curve guide. From left to right: 
Radial, Wave, Braid, Roll. Animation. 


Axis 
Which axis to use for the offset. 


Frequency 
The frequency of the offset. 


Shape 
Adjust the offset to the beginning/end. 


Amplitude 
The Amplitude of the offset. 


Examples 


Curve Guide force field. 


Drag 


Reference 
Panel: Physics » Force Fields 
Type: Drag 


A Drag force field resists particle motion by slowing it down. 
Options 


Linear 
Drag component proportional to velocity. 


Quadratic 
Drag component proportional to the square of the 
velocity. 


Fluid Flow 


Reference 
Panel: Physics » Force Fields 
Type: Fluid Flow 


The Fluid Flow force field creates a force based on a Fluid 
Simulation air flow. It applies the smoke simulation air flow 
velocity as a force to other simulations that use force fields. 
To use it you need to add a Fluid Flow force field and select 
a domain object for it. For example fire sparkles can 
realistically flow along the air turbulence near the simulated 
fire. 


Options 


Domain Object 
An object that is used as a domain for the smoke 
Simulation. 


Apply Density 
Adjust the force strength based on the smoke density. 


Force 


Reference 
Panel: Physics » Force Fields 
Type: Force 


Force force field visualization. 


The Force field is the simplest of the fields. It gives a 
constant force towards (positive strength) or away from 
(negative strength) the object’s origin. Newtonian particles 
are attracted to a field with negative strength, and are 
blown away from a field with positive strength. 


Example 


Harmonic 


Reference 
Panel: Physics » Force Fields 
Type: Harmonic 


In a Harmonic force field, the source of the force field is the 
zero point of a harmonic oscillator (spring, pendulum). If you 
set the Damping parameter to 1, the movement is stopped 
in the moment the object is reached. This force field is really 
special if you assign it to particles. 


Options 


Rest Length 
Controls the rest length of the harmonic force. 


Multiple Springs 
Causes every point to be affected by multiple springs. 


Normally every particle of the field system influences every 
particle of the target system. Not with Harmonic! Here every 
target particle is assigned to a field particle. So particles will 
move to the place of other particles, thus forming shapes. 


Example 


Lennard-Jones 


Reference 
Panel: Physics » Force Fields 
Type: Lennard-Jones 


The Lennard-Jones force field is a very short range force 
with a behavior determined by the sizes of the effector and 
effected particle. At a distance smaller than the combined 
sizes, the field is very repulsive and after that distance it is 
attractive. It tries to keep the particles at an equilibrium 
distance from each other. Particles need to be at a close 
proximity to each other to be effected by this field at all. 


Particles can have for example both a charge anda 


Lennard-Jones potential, which is probably something for the 
nuclear physicists among us. 


Example 


Magnetic 


Reference 
Panel: Physics » Force Fields 
Type: Magnetic 


This field depends on the speed of the particles. It simulates 
the force of magnetism on magnetized objects. 


Example 


Texture 


Reference 
Panel: Physics » Force Fields 
Type: Texture 


You can use a Texture force field to create an arbitrarily 
complicated force field, which force in the three directions is 
color coded. Red is coding for the X axis, green for the Y 
axis and blue for the Z axis (like the color of the coordinate 
axes in the 3D Viewport). A value of 0.5 means no force, a 
value larger than 0.5 acceleration in negative axis direction 
(like -Z), a value smaller than 0.5 acceleration in positive 
axis direction (like +Z). 


Options 


Texture Mode 
This sets the way a force vector is derived from the 
texture. 


Curl: Calculates the force vector from the 
curl of the 3D-RGB texture (rotation of 
RGB vectors). This also works only with 
a color texture. It can be used for 
example to create a nice looking 
turbulence force with a color clouds 
texture with Perlin noise. 

Gradient: 


Calculates the force vector as the 3D 
gradient of the intensity (grayscale) of 
the texture. The gradient vector always 
points to the direction of increasing 
brightness. 

RGB: Uses the color components directly as 
the force vector components in the 
color encoded directions. You need an 
RGB texture for this, e.g. an image ora 
color ramp. So a Blend texture without 
a color ramp would not suffice. 


Nabla 
It is the offset used to calculate the partial derivatives 
needed for Gradient and Curl texture modes. 


Use Coordinates 
Uses the emitter object coordinates (and rotation & 
scale) as the texture space the particles use. Allows for 
moving force fields, that have their coordinates bound to 
the location coordinates of an object. 


Root Texture Coordinates 
This is useful for hair as it uses the texture force 
calculated for the particle root position for all parts of the 
hair strand. 


2D 
Disregards the particles Z coordinate and only uses 
particles X & Y as the texture coordinates. 


Remember that only procedural texture are truly 3D. 


Examples 


e A single colored texture (0.5, 0.0, 0.5) creates a force in 
the direction of the positive Y axis, e.g. hair is orientated 
to the Y axis. 

e A blend texture with color ramp can be used to created 
a force “plane”. E.g. on the left side (0.5, 0.5, 0.5), on 
the right side (1.0, 0.5, 0.5) you have a force plane 
perpendicular to XY (i.e. parallel to Z). If you use an 
object for the coordinates, you can use the object to 
push particles around. 

e An animated wood texture can be used to create a wave 
like motion. 


Turbulence 


Reference 
Panel: Physics » Force Fields 
Type: Turbulence 


A Turbulence force field creates a random & chaotic 3D 
noise effect, similar to jets of water or geysers under the 
ocean. 


Options 


Size 
Indicates the scale of the noise. 


Global 
Makes the size and strength of the noise relative to the 
world, instead of the object it is attached to. 


Example 


Turbulence force field affecting a particle system. 


Vortex 


Reference 
Panel: Physics » Force Fields 
Type: Vortex 


Vortex force field visualization. 


The Vortex force field gives a spiraling force that twists the 
direction of points around the force object’s local Z axis. 
This can be useful for making a swirling sink, or tornado, or 
kinks in particle hair. 


Options 


Inflow 
Inwards component of the vortex force. 


Example 


Wind 


Reference 
Panel: Physics » Force Fields 
Type: Wind 


Wind force field visualization. 


The Wind force field gives a constant force in a single 
direction, along the force object’s local Z axis. The strength 
of the force is visualized by the spacing of the circles shown. 


Example 


Collision 


Reference 
Mode: Object Mode 
Panel: Physics >» Collision 


Particles, Soft Bodies and Cloth objects may collide with 
mesh objects. Boids try to avoid Collision objects. 


e You may limit the effect on particles to a group of 
objects (in the Field Weights panel). 

e Deflection for soft body objects is difficult, they often 
penetrate the colliding objects. 

e Hair particles ignore deflecting objects (but you can 
animate them as soft bodies which take deflection into 
account). 


If you change the deflection settings for an object you have 
to recalculate the particle, soft body or cloth system by 
Delete Bake, this is not done automatically. 


A collider object can be temporarily x Collision |® 
disabled via an animatable toggle to the 

right of the button that permanently 

activates or deactivates it. 


Options 


¥ Collision 
Field Absorption 


Y Particle 


Permeability 


Stickiness 


Damping 
Randomize 
Friction 
Randomize 


¥ Softbody And Cloth 


Damping 
Thickness Outer 
Inner 


Friction 


Collision panel. 


Collision 


Field Absorption 


A deflector can also deflect effectors. You can specify 
some collision/deflector objects which deflect a specific 
portion of the effector force using the Field Absorption 
value. 100% absorption results in no force getting 
through the collision/deflector object at all. If you have 
three collision object behind each other with e.g. 10%, 
43% and 3%, the absorption ends up at around 50% \ 
(100 x (1 - 0.1) x (1 - 0.43) x (1 - 0.03)\). 


Particle 


0.000 
0.000 
Kill Particles 
0.000 
0.000 
0.000 
0.000 


0.100 
0.020 
0.200 
5.000 


Single Sided @ 


Override Normals 


Permeability 
Fraction of particles passing through the mesh. 


Stickiness 
How much particles stick to the object. 


Kill Particles 
Deletes Particles upon impact. 


Damping 
Damping during a collision (independent of the velocity 
of the particles). 


Randomize 
Random variation of damping. 


Friction 
Friction during movements along the surface. 


Randomize 
Random variation of friction. 


Soft Body and Cloth 


It is also important to note that this collision panel is used to 
tell all simulations that this object is to participate in 
colliding/deflecting other objects on a shared layer 
(particles, soft bodies, and cloth). 


Note 


The object’s shape deforms the cloth, so the cloth 
simulation must be inputted the “true” shape of that mesh 
object at that frame. This true shape is the basis shape as 
modified by shape keys or armatures. Therefore, the 
Collision Modifier must be after any of those. The image to 


the right shows the Modifiers panel for the Character mesh 
object (not the cloth object). 


Damping 
Damping during a collision. The amount of bounce that 
the surfaces will have. 


e 0.0 - No damping, soft bodies will have a maximum 
bounciness. 

e 1.0 - Maximum damping, soft bodies will not bounce 
at all. 


Thickness 
A padding distance is added to the inside and outside of 
each face, to help to prevent intersections. The soft body 
will come to rest at this distance away from the face of 
the colliding object. Outside and inside is defined by the 
face normal, depicted as blue arrow in Fig. A soft body 
vertex colliding_with a plane.. 


Outer 
Size of the outer collision zone. 


Inner 
Size of the inner collision zone (padding distance). 


A soft body vertex colliding with a plane. 


Friction 


A coefficient for how slippery the cloth is when it collides 
with itself. For example, silk has a lower coefficient of 
friction than cotton. 


Single Sided 
When enabled, the collider is considered to represent the 
boundary of a solid object rather than a thin surface, and 
ejects intersecting cloth in the direction of its normal. 


Override Normals 
When enabled, cloth collision impulses act in the 
direction of the collider normals. 


Note 
Soft body collisions are difficult to get perfect. If one of the 


objects move too fast, the soft body will penetrate the 
mesh. See also the section about Soft Bodies. 


Examples 


Deflected particles. 


Here is a Meta object, using Instancing Vertices to a particle 
system emitting downwards, and deflected by a mesh cube. 


Hints 


e Make sure that the normals of the mesh surface are 
facing towards the particles/points for correct deflection. 
Negative scales on the object can have a similar effect. 
Make sure to recalculate the normals after applying the 
scale. 

Hair particles react directly to force fields, so if you use 
a force field with a short range you do not need 
necessarily collision. 

Hair particles avoid their emitting mesh if you edit them 
in Particle Edit Mode. So you can at least model the hair 
with collision. 


Baking Physics 
Simulations 


Baking refers to the act of storing or caching the results of a 
calculation. The result of a simulation is automatically 
cached to memory when the animation is played, so that 
the next time it runs, it can be replayed more quickly by 
reading the results from the memory. 


If you bake the simulation the cache is protected, and you 
will be unable to change the simulation settings until you 
clear the baked frames by clicking Free Bake. 


It is generally recommended to bake your physics 
simulations before rendering. Aside from no longer needing 
to go through the time-consuming process of simulating 
again, baking can help prevent potential glitches and ensure 
that the outcome of the simulation remains exactly the 
same every time. 


Note 


Most physics simulators in Blender use a similar system, 
but not all have exactly the same settings available. All the 
settings are covered here, but individual physics types 
may not provide all these options. 


Options 


Caches List 


Blender 
allows for File Format Point Cache 
storing and Compression Lite 
managing 
multiple 
caches at . i 

once for Use Library Path @ 
the same External 

p hysics Simulation Start 

object. You 
can 
manage Two different caches stored simultaneously. 
the caches 

with this 

list view. Double-click the cache entry to give ita name. 


(@ My First Cache 


— 
@ Cache 2 


Each cache can have a name. Double-click the cache 
entry to give it a name. If this name is given, any disk 
cache will be stored in files starting with that name. For 
example, a cache named ‘MyCache’ will be stored in 
MyCache xxxxxx_yy.bphys. 


If the cache does not have a name (which is the default), 
the filename of the cache will depend on the object it is 
attached to, although this is not immediately obvious. For 
example, a cache on an object Cube will be stored in 
43756265 xxxxxx_yy.bphys, where 43756265 is determined by 
the object name. 


Warning 


When there are multiple caches on one object, always 
specify a Cache Name. As described above, the 
filename of an unnamed cache is determined by the 
name of the object it is attached to. As a result, an 
object with multiple physics systems that all have an 


unnamed cache will cause conflict and can result in 
losing cache files. 


External 


Allows you to read the cache from a drive using a user- 
specified file path. 


Note 


The cache name in Caches List and the Index has to 
exactly match the external cache files name in order to 
work. The cache files name format is 
name_frame_index.bphys. 


Index 


The index number of cache files. (The last two digits 
of the files name.) 


Path 
Select the directory path to the cache files. 


Disk Cache 


The cache of a baked simulation will be stored inside the 
blend-file when you save it. When Disk Cache is checked, 
Blender will save the cache separately to the drive ina 
folder named blendcache [filename] alongside the blend- 
file. (The blend-file must be saved first.) 


Note 


When using Library Overrides, data-blocks only support 
Disk Cache storage. 


Use Library Path 


Share the disk cache when the physics object is linked 
into another blend-file. When this option is enabled, 
linked versions of the object will reference the same disk 
cache. Otherwise linked versions of the object will use 
independent caches. 


Compression 
The compression level for cache files. Some physics 
caches can be very large, Blender can compress these 
caches in order to save space. 


None 
Do not compress the cache. 


Light 
Compression will optimize the speed of 
compressing/decompressing operations over file size. 


Heavy 
Compression will result in smaller cache files more 
than Light, however, requires more CPU time to 
compress/decompress. 


Start 
Frame on which to start the simulation. 


End 
Frame on which to stop the simulation. 


Note 


The simulation is only calculated for positive frames in 
between the Start and End frames of the Cache panel, 
whether you bake or not. So if you want a simulation 
that is longer than the default frame range you have to 
change the End frame. 


Cache Step 
Interval for storing simulation data. 


Note 

Some physics systems (such as particles) allow for 
positions to be stored only on every nth frame, letting 
the positions for in-between frames be interpolated. 
Using a cache step greater than one will result in a 
smaller cache, but the result may differ from the 
original simulation. 


Baking 


Bake 
Start baking. Blender will become unresponsive during 
most baking operations. The cursor will display as a 
number representing the progress of the baking. You 
need to be in Object Mode to bake. 


Free Bake 
Mark the baked cache as temporary. The data will still 
exist, but will be removed with the next object 
modification and frame change. This button is only 
available when the physics system has been baked. 


Calculate to Frame 
Bake only up to the current frame. Limited by End frame 
set in the cache settings. 


Current Cache to Bake 
Store any temporarily cached simulation data as a bake. 
Note that playing the animation will try to simulate any 
visible physics simulations. Depending on the physics 


type, this data may be temporarily cached. Normally 
such temporary caches are cleared when an object or 
setting is modified, but converting it to a bake will “save” 
it. 

Bake All Dynamics 


Bake all physics systems in the scene, even those of 
different types. Useful for baking complex setups 
involving interactions between different physics types. 


See Bake. 


Free All Bakes 
Free bakes of all physics systems in the scene, even 
those of different types. 


See Free Bake. 


Update All to Frame 


Bake all physics systems in the scene to the current 
frame. 


See Calculate To Frame. 
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Introduction 


Rendering is the process of turning a 3D scene into a 2D 
image. Blender includes three render engines with different 
strengths: 


e Eevee is a physically based realtime renderer. 

e Cycles is a physically based path tracer. 

e Workbench is designed for layout, modeling and 
previews. 


More renderers from third-party developers are available as 
add-ons. Each renderer has its own render settings to 
control render quality and performance. 


What the render looks like is defined by cameras, lights and 
materials. These are shared between Eevee and Cycles, 
however some features are only supported in one or the 
other. 


Renders can be split up into layers and passes, which can 
then be composited together for creative control, or to 
combine with real footage. Freestyle can be used to add 
non-photorealistic line rendering. 


Blender supports interactive 3D viewport rendering for all 
render engines, for quick iteration on lighting and shading. 
Once this is done, the final quality image or animation can 
be rendered and output. 
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Introduction 


Eevee is Blender’s realtime render engine built using 
OpenGL focused on speed and interactivity while achieving 


interactively in the 3D Viewport but also produce high 
quality final renders. 


Eevee in the 3D Viewport - “Tiger” by Daniel 
Bystedt. 


Eevee materials are created using the same shader nodes 
as Cycles, making it easy to render existing scenes. For 
Cycles users, this makes Eevee work great for previewing 
materials in realtime. 


Unlike Cycles, Eevee is not a raytrace render engine. 

Instead of computing each ray of light, Eevee uses a process 
called rasterization. Rasterization estimates the way light 
interacts with objects and materials using numerous 


is not perfect and Cycles will always provide more physically 
accurate renders. Because Eevee uses rasterization it has a 
large set of limitations. 


Eevee final render - “Temple” by Dominik Graf. 


Render Settings 


Sampling 

Grease Pencil 
Ambient Occlusion 
Bloom 

Depth of Field 
Subsurface Scattering 
Screen Space Reflections 
Motion Blur 
Volumetrics 
Performance 

Curves 

Shadows 

Indirect Lighting 

Film 


Sampling 


Eevee uses a process called Temporal Anti-Aliasing (TAA) 
which reduces Aliasing. TAA is sample based so the more 
samples the more aliasing is reduced at the cost of 
performance. 


Reference 


Panel: Render > Sampling 


Viewport 
The number of samples to use in the 3D Viewport. When 
setting this to zero the viewport will be resampled 
continuously. 


Render 
The number of samples to use in the final render. 


Viewport Denoising 
Reduces noise while moving the viewport or during 
animation playback. 


Grease Pencil 


Reference 


Panel: Render > Grease Pencil 


This panel is comprised of settings to control the rendering 
of Grease Pencil Lines. 


Anti-Aliasing Threshold 
Threshold for the edge detection algorithm used to 
correct aliasing, higher values might over blur some part 
of the image. 


Ambient Occlusion 


indirect lighting. The bent normal option will make the 
diffuse lighting come from only the least occluded direction. 


Ambient occlusion can be rendered as a separate pass in 
the Render Layers panel. 


Note 


This effect needs to be enabled for the Ambient Occlusion 
node to work. 


Reference 


Panel: Render > Ambient Occlusion 


Distance 
Distance of object that contributes to the ambient 
occlusion effect. 


Factor 
Blend factor for the ambient occlusion effect. 


Trace Precision 
Increases precision of the effect but introduces more 
noise and lowers the maximum trace distance. Increased 
precision also increases the performance cost. Lower 
precision will also miss occluders and lead to 
undershadowing. 


Bent Normals 


Compute the least occluded direction. This direction can 
be used to sample the diffuse irradiance in a more 
realistic way. 


Bounce Approximation 
An approximation to simulate light bounces giving less 
occlusion on brighter objects. It only takes into account 
the surface color and not its surroundings. This is not 
applied to the ambient occlusion pass. 


See also 


Limitations. 


Bloom 


Bloom is a post-process effect that diffuses very bright 
pixels. This mimics lens artifacts of real cameras. This allows 
a better sense of what the actual intensities of the pixels 
are. 


Reference 


Panel: Render > Bloom 


Threshold 
Filters out pixels under this level of brightness. 


Knee 
Makes transition between under/over-threshold gradual. 


Radius 
Bloom spread distance. 


Color 
Color applied to the bloom effect. 


Intensity 
Blend factor. 


Clamp 
Maximum intensity a bloom pixel can have. 


Depth of Field 


To render a scene, Eevee uses a pinhole camera model 
which produces a perfectly focused image of the scene. For 
an enhanced realism, Eevee can simulate the optical Depth 
of Field using a post-process filter, and a sample-based 
method. The optical settings are located in the camera 
settings properties. Whereas the quality of the effect can be 
controlled by the settings found in the present section. 


Note 


In the 3D Viewport, depth of field only works while in 
Camera View. 


The post-process method is computed in two passes. The 
first pass is using a blur that fails to produce quality bokeh 
for highlights but works for the general case. Followed by a 
second pass which is sprite-based and improves only the 
quality of very bright highlights. That is because it is too 
Slow to be applied on every part of the image. So it just 
includes very bright isolated parts of the image such that 
are different from their surroundings. Which pixels are being 
processed by second pass can be control with the Sprite 
Threshold and Neighbor Rejection options. 


Secondly the sample-based method works by randomizing 
the camera position for every sample. It is more accurate 
but needs many samples to achieve a smooth result. 
Accordingly the post-process blurring radius is scaled down 
to remove undersampling. Yet some scenes might still need 
more post-process blur in order to remove the noticeable 


sample pattern. This is exactly what the Overblur option 
does, but it will also reduce the bokeh shape sharpness. 


Reference 


Panel: Render >» Depth of Field 


Max Size 
Maximum size in pixels of the depth of field post-process 
effect (lower is faster). A value of 0 will disable the post- 
process effect but not the sample-based method. 


Sprite Threshold 
Minimum brightness a pixel needs to have to be 
considered by the sprite-based depth of field. Higher 
values will improve the performance but will also reduce 
the quality of highlights. Brightness is in the scene’s 
referred color space. 


Neighbor Rejection 
Maximum intensity to consider when doing sprite 
neighborhood rejection. This should be set toa 
brightness value above which there is small visual 
differences to be noticeable after color management. 
Lower values will improve the performance but will also 
reduce the quality of highlights. Brightness is in the 
scene’s referred color space. 


Denoise Amount 
This will reduce the flickering by clamping the color of 
each pixels to their neighborhood’s average instead of 
their maximum. Higher values gives more stable results 
but may darken the scene. 


High Quality Slight Defocus 


Increase the quality of almost in-focus regions. 


Jitter Camera 
Randomize the camera position for every scene render 
Sample to increase precision. Enabling this option can 
change the scene’s actual sample count. 


Note 
Be aware that the actual sample count can grow quite 
rapidly. 


Hint 
The actual number of samples is computed by the 
following formula: 


\[sample\_count = (ring\_count* {2} + ring\_count) * 3 
+ 1\] 

where \(ring\_count\) is the number of ring in the 
hexaweb pattern. The \(ring\_count\) is chosen so that 
the entire pattern contains at least the number of 
samples set in the Render Settings. 


Overblur 
Scales the post-process depth of field radius to reduce 
artifacts. Higher values will soften the bokeh shape. 


See also 


Limitations. 


Subsurface Scattering 


This effect mimics real subsurface scattering by blurring the 
diffuse lighting in screen space. 


Reference 


Panel: Render > Subsurface Scattering 


Samples 
Number of samples to compute the scattering effect. 


Jitter Threshold 
For the effect to be efficient, samples need to be 
coherent and not random. This can lead to a cross- 
Shaped pattern when the scattering radius is high. 
Increasing the Jitter Threshold will rotate the samples 
below this radius percentage in a random pattern in 
order to hide the visible pattern. This affects the 
performance if the scattering radius is large. 


Note 


Subsurface Translucency needs to be enabled in order to 
make the light go through an object (like simulating a 
human ear lit from behind). 


This option only works with shadowed lights and does not 
work with indirect lighting. 


See also 


Limitations. 


Screen Space Reflections 


If this effect is enabled, all Materials will use the depth 
buffer and the previous frame color to create more accurate 
reflection than reflection probes. 


If a Reflection Plane is near a reflective surface, it will be 
used as the source for tracing rays more efficiently and fix 
the partial visibility problem. 


However, the reflected color will not contain the following 
effects: Subsurface scattering, volumetrics, screen space 
reflections, screen space refractions. 


Reference 


Panel: Render » Screen Space Reflections 


Refractions 
Screen space refractions work the same way as screen 
space reflections and use the same parameters. But they 


are not enabled by default on all surfaces. Enabling it will 
have a small performance cost. You need to enable them 
in Material Properties >» Settings. Materials using screen 
space refractions will not cast screen space reflections. 


Half Resolution Trace 
Use half resolution ray tracing. Only cast a ray for every 
fourth pixel. Enabling this option drastically reduces 
video memory usage and increases performance at the 
cost of quality. 


Trace Precision 
Increases precision of the ray tracing but introduces 
more noise and lowers the maximum trace distance. 
Increased precision also increases performance cost. 


Thickness 
How thick to consider the pixels of the depth buffer 
during the tracing. Higher values will stretch the 
reflections and add flickering. Lower values may make 
the ray miss surfaces. 


Edge Fading 
Smoothly fade out the reflected and refracted pixels if 
they are close to a screen edge. The unit is in screen 
percentage. 


Clamp 
Clamp the reflected color intensity to remove noise and 
Fireflies. 


See also 


Limitations. 


Motion Blur 


Reference 


Panel: Render > Motion Blur 


Blender’s animations are by default rendered as a sequence 
of perfectly still images. While great for stop-motion and 
time-lapses, this is unrealistic, since fast-moving objects do 
appear to be blurred in the direction of motion, both ina 
movie frame and in a photograph from a real-world camera. 


Note 


Motion blur is only available in final renders and is not 
shown in the 3D Viewport and thus Viewport Renders. 


Position 
Controls at what point the shutter opens in relation to the 
current frame. 


Start on Frame 
Shutter is starting to open at the current frame. 


Center on Frame 
Shutter is fully opened at the current frame. 


End on Frame 
Shutter is fully closed at the current frame. 


Shutter 
Time (in frames) taken between shutter open and close. 


Background Separation 
Used by the post-process blur to avoid blurring the 
background over the foreground. Lower values will 
reduce background bleeding onto foreground elements. 


Max Blur 
Maximum blur distance a pixel can spread over. A value 
of 0 will disable the post-process blur and only use the 
accumulation blur. 


Note 
High maximum blur values may also reduce the quality. 


Eevee uses a fast post-process vector blur using a vector 
motion pass. This blurs the image between three time 
steps using pixel velocity. This technique is fast and 
produces clean gradients, but issues can occur at object 
borders or if the motion is locally too complex; for 
example, if there are many vector variations in a small 
area. 


This technique is fast and produce clean gradients but 
issues can occur at object borders or if the motion is 
locally too complex (many vector variations in a small 
area). 


This technique uses random sampling and the noise 
amount is proportional to the sample count found in 
Properties » Render > Sampling » Render Samples. 


Note 

Memory usage (VRAM) will be three times higher for 
objects using deformation motion blur if using post- 
process blur. 


Note 

Alpha blended surface or volumetric effects will not 
have the correct velocity and will not be correctly 
blurred by this technique. Use the accumulation blur for 


that. 


Steps 
This controls the number of steps used by the 
accumulation blur and thus its accuracy. More steps 
means longer render time. 


Note 

When using multiple time steps, the render sample 
count is rounded up to the next multiple of steps to 
ensure even distribution of samples across steps. 


Eevee splits the render into multiple time steps and 
accumulates the result which is known as Accumulation 
Motion Blur. This technique is precise but requires many 
steps for clean gradients. This is used in combination 
with the post-process blur to handle the inter-step gaps. 
Each step corresponds to a full scene re-evaluation and 
can add a lot of overhead to the render time. By adding 
more steps you can also reduce the Max Blur options 
because the post-process blur has to cover a smaller 
distance. 


Example 


No motion blur. Only post-process 
blur. 


4 time steps without 4 time steps with 
post-process blur. post-process blur. 


32 time steps 


tes Bert Piece? post-process blur. 


32 time steps with 


Volumetrics 


Eevee simulates volumetric scattering by evaluating all 
volume objects inside the view frustum. 


To achieve this, Eevee uses several 3D textures which have 
a high video memory usage. The texture dimensions can be 
tweaked using the Tile Size and Samples parameters. 


Object volumes have some limitations. 


Reference 


Panel: Properties » Render > Volumetrics 


Start 
Start distance of the volumetric effect. 


End 
End distance of the volumetric effect. 


Tile Size 
Controls the quality of the volumetric effects. Lower size 
increases video memory usage and quality. This is the 
size in pixels of a volumetric cell. 


Samples 
Number of samples to compute volumetric effects. 
Higher count increases video memory usage and quality. 
These samples are distributed along the view depth 
(view Z axis). 


Distribution 


Blend between linear and exponential sample 
distribution. Higher values puts more samples near the 
camera. 


Volumetric Lighting 


Let the volume scattering scatter light in the scene. 
Unnecessary if no Volume Scatter is present in the scene. 


Light Clamping 
Clamp light contribution of the volume scattering effect. 
Reduces flickering and noise. Set to 0.0 to disable 
clamping. 


Volumetric Shadows 


Approximate light absorption of the surrounding volume 
objects. This makes the volumes more opaque to light. This 
iS a very computationally expensive option and has 
limitations. 


Samples 
Number of samples to compute volumetric shadowing. 


See also 


Limitations. 


Performance 


Reference 


Panel: Properties » Render >» Performance 


High Quality Normals 
Uses higher precision normals and tangents which can 
improve visual quality for dense meshes with high 
frequency textures at the cost of memory. 


Curves 


Reference 
Panel: Render > Curves 
Shape 
Strand: Render curves as a thin strand roughly 
a pixel wide. Curve diameter 
parameters are ignored with this 
setting. 
Strip: Render curves as a flat ribbon with 


rounded normals. 


Additional Subdivisions 
Additional subdivisions to be applied on top of the curve 
resolution set in the hair system settings. Increasing this 
value will smooth out the curves of the strands. 


Shadows 


These settings influence shadows which appear on objects 
because there is another object (the occluder) between 
them and a Light. Eevee uses a technique called Shadow 
Mapping to calculate these shadows. A shadow map is 
calculated by looking around from the position of each Light 
and finding the objects which are closest to the Light. These 
objects are called the nearest occluders. Everything which is 
behind (or, you can say, covered by) the nearest occluders 
will be in shadow. 


The shadow map is a cube (hence the term “cubemap”) and 
the Light is in the middle of this cube. The cube has six 
sides and each side is divided into a grid. You can set the 
resolution of the grid (for example, 512 x 512 pixels) with 
the Cube Size setting below. During shadow calculation, the 
nearest occluders are only searched at grid points but not 
between grid points. Because of this, the edge of the 
calculated shadow will appear pixelated at low Cube Size 
settings. 


Note 

Settings for the shadows and illumination caused by light 
bouncing between objects (indirect lighting) can be found 
on the Indirect Lighting tab. 


Reference 


Panel: Render >» Shadows 


Cube Size 


Number of pixels on one side of the shadow cube-map 
(see above) used to calculate the shadow of Point, Area 
and Spot lights. If you want to make the edge of shadows 
less pixelated, then increase this value. But be aware 
that this increases memory usage and decreases 
performance since a 512 px cube-map has 6 x 512 x 
512 pixels in it. 


Cascade Size 


Size of one cascade used by Cascaded Shadow Maps. 
This is only for Sun lights. 


High Bitdepth 
This option can help reduce some artifacts due to float 
imprecision inside the shadow maps. This option 
effectively doubles the memory usage of shadow maps 
and will slow down their update. 


Soft Shadows 
Randomize the shadow map’s origin to create soft 
shadows. It needs a lot of samples to get rid of the 
banding. 


Light Threshold 


The minimum amount of light for a light to contribute for 
lighting. This light threshold does not take the light shape 
into account and may not suit every case. That is why 
Blender provides a per-light override where you can just 
set the cut off distance. 


The influence distance is also used as shadow far clip 
distance, which might affect how shadows look. This 

influence distance does not affect sun lights that still 
have a far clip distance. 


See also 


Custom Distance. 


Note 


The Soft Shadows method is not physically based and will 
not match Cycles for very large lights. 


Indirect Lighting 


While not strictly correct, all lighting that is not coming 
straight out from a light object is considered as indirect 
lighting in Eevee. That means distant HDRI lighting (or 
World) is considered as indirect lighting. Mesh objects using 
an Emission node are also considered as indirect lighting. 


In Eevee, indirect lighting is separated into two component: 
Diffuse and Specular. Both have different needs and 
representation. For efficiency, the indirect lighting data is 
precomputed on demand into a static lighting cache. 


As of now the light cache is static and needs to be 
computed before rendering. It cannot be updated per frame 
(unless via scripting). This limitation is being worked on and 
will be removed in future versions. 


Only view independent lighting can be baked. This is why 
Reflection Planes are not stored inside the light cache. 


The visibility and collections used during the baking process 
are the ones in the current Active View Layer. 


To enable light bounces through large environments, the 
light baking process can be run multiple times while 
injecting the previous bake result into the bake. 


Light bounces only concerns diffuse lighting. 


Reference 


Panel: Render >» Indirect Lighting 


Auto Bake 
Enabling this option will trigger baking when a probe is 
changed; useful when positioning probes objects. 


Diffuse Bounces 
Number of bounces to compute when baking the diffuse 
irradiance. Total baking time is more or less multiplied by 
the number of bounce. 


Cubemap Size 
Size of the reflection cubemaps. 


Diffuse Occlusion 
Each irradiance sample also stores a shadow map that is 
used to minimize indirect light leaking. This parameter 
defines the size of this shadow map. 


Irradiance Smoothing 
Smooths irradiance interpolation but introduces light 
bleeding. The irradiance visibility term can make the 
lighting not interpolate smoothly on some surfaces. This 
setting relaxes the weight of that interpolation. 


Clamp Glossy 
Clamp pixel intensity to reduce noise inside glossy 
reflections from reflection cubemaps (0 is disabled). 


Filter Quality 
Takes more samples during cubemap filtering to remove 
artifacts. For now, this only has an effect on cubemaps. 


Display 


Cubemap Size 
Display the Reflection Cubemaps present in the cache 
directly in the 3D Viewport. 


Irradiance Size 
Display the Irradiance Samples present in the cache in 
the 3D Viewport. 


Note 


Cache data display only works in the 3D Viewport and only 
if the viewport uses world lighting in Material Preview or 
Rendered mode. 


Film 


Filter Size 
Due to limited resolution of images and computer 
screens, pixel filters are needed to avoid Aliasing. This is 
achieved by slightly blurring the image to soften edges. 


This Setting controls home much the image is softened; 
lower values give more crisp renders, higher values are 
softer and reduce aliasing. 


Transparent 
Render the background transparent, for compositing the 
image over another background after rendering. 


Overscan 
Percentage of the render size to add to the internal 
render buffer. This will have a serious impact on 
performance but can fix render glitches around the 
perimeter of the rendered image. 
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Introduction 


Eevee’s materials system uses the same node based 
approach as Cycles. 


Nodes Support 


Due to realtime constraints, not all Cycles features are 
available in Eevee. See Supported Nodes. 


Performance 


Performance is highly dependent on the number of BSDF 
nodes present in the node tree. 


Tip 


Prefer using the Principled BSDF instead of multiple BSDF 
nodes because Eevee is optimized for it. 


See also 


Limitations. 


Supported Nodes 


Most nodes are taken from Cycles. However, some features 
are missing and may (or may not) be implemented in Eevee 
in the future. 


See also 


Shader Nodes. 


Eevee only Nodes 


These nodes are only available if Eevee is the active render 
engine. These nodes will not work in Cycles. 


Shader to RGB 


Eevee supports the conversion of BSDF outputs into color 
inputs to make any kind of custom shading. This is 
supported using the Shader to RGB node. 


Specular BSDF 


This node implements the specular workflow found in other 
render engines. 


Other Nodes Support 


If something is not listed here, it is supported. 


Shader Nodes 


In the general case, shader nodes should behave more or 
less like in Cycles. So be sure to check out the Cycles 
section of this manual for that. 


See also 


Materials. 


Although most BSDFs are supported, many of them are 
approximations and are not feature complete. 


Diffuse BSDF 
Roughness is not supported. Only Lambertian diffusion is 
supported. 


Emission 


and Probes. 


Glass / Refraction BSDF 
Does not refract lights. Does not support Beckmann 
distribution. See Refraction limitations. 


Glossy BSDF 
Does not support Beckmann and Ashikhmin-Shirley 
distributions. 


Subsurface Scattering 
Random Walk sampling is not supported. Per color 
channel Radius is specified by the default socket value. 
Any link plugged into this socket gets ignored. Texture 
Blur is not accurate for any value other than 0.0 and 1.0. 


Transparent BSDF 
Transparency will only have an effect if the Material blend 
mode is not Opaque. Colored and additive transparency 
are only compatible with “Alpha Blend” mode. 


Translucent BSDF 
Does not diffuse the light inside the object. It only lights 
the object with reversed normals. 


Principled BSDF 
Cumulative limitations from Diffuse BSDF, Glossy BSDF, 
Refraction BSDF and Subsurface Scattering. Anisotropy is 
not supported. Transmission Roughness is not supported. 
The Sheen layer is a crude approximation. 


Volume Absorption 
See Volume Limitation. 


Volume Scatter 
The anisotropy parameter will be mixed and averaged for 
all overlapping volumetric objects, which is not physically 
correct and differs from Cycles. Also see Volume 
Limitation. 


Principled Volume 
Same as Volume Scatter. See Volume Limitation. 


Holdout 
Partially supported, using Blend Modes other than Alpha 
may give incorrect results. 


Anisotropic BSDF 
Not supported. 


Toon BSDF 
Not supported. 


Hair BSDF 
Not supported. 


Velvet BSDF 
Not supported. 


Principled Hair BSDF 
Not supported. 


Input Nodes 


Ambient Occlusion 
The sample count is not used. 


Camera Data 
EveHair Inforything is compatible. 


Geometry 
Pointiness is not supported. 


Random per Island 
Random per Island is not supported. 


Attribute 
Defaults to active UV layer. Only “density”, “color”, 
“flame” and “temperature” built-in Geometry attributes 
are supported. UVs and Color Attributes are supported. 
Only up to 8 Object or Instancer attributes per material 
(both types share the same limit), and 512 View Layer 
attributes per scene are supported. 


Bevel 
Not supported. 


Fresnel 
Everything is compatible. 


Curves Info 


the same but the values will be different. 


Layer Weight 
Everything is compatible. 


Light Path 
Eevee has no real concept of rays. But in order to ease 
the workflow between Cycles and Eevee some of the 
outputs are only supported in particular cases. This node 
makes it possible to tweak indirect lighting in the shader. 


Only a subset of the outputs are supported and the ray 
depth does not exactly have the same meaning. In order 
for the Is Camera, Is Shadow, Is Diffuse, and Is Glossy 
outputs to work, the object must be inside an |rradiance 
Volume and Indirect Lighting must be baked. 


ls Camera: Supported. 

Is Shadow: Supported. 

Is Diffuse: Supported. 

Is Glossy: Supported. 

Is Singular: Not supported. Same as Is Glossy. 

Is Reflection: Not Supported. Same as Is Glossy. 
Is Transmission: Not supported. Same as Is Glossy. 
Ray Length: Not supported. Defaults to 1.0. 

Ray Depth: Indicates the current bounce when 
baking the light cache. 

Diffuse Depth: Same as Ray Depth but only when 
baking diffuse light. 

Glossy Depth: Same as Ray Depth but only when 
baking specular light. 

Transparent Depth: Not supported. Defaults to 0. 


e Transmission Depth: Not supported. Same as Glossy 
Depth. 


Note 


Is Glossy does not work with Screen Space 
Reflections/Refractions but does work with reflection 
planes (whether used with SSR or not). 


Object Info 
Everything is compatible. 


Particle Info 
Not supported. 


Tangent 
Everything is compatible. 


Texture Coordinate 
From Instancer is not supported. 


UV Map 
From Instancer is not supported. 


Wireframe 


Pixel size option does not give exactly the same output 
as Cycles. The width can be a bit different. 


Texture Nodes 


Most texture nodes are supported except for the exceptions 
listed below: 


IES Texture 


Not supported. 


Image Texture 
Smart Interpolation always uses Cubic interpolation. 
Artifact present using Tube or Sphere projection with 
linear interpolation. This is due to hardware mip-mapping 
and Anisotropic filtering. This kind of artifact will be also 
visible if the texture coordinates provided are not 
continuous. Using Box projection with Extend type set to 
Clip or Extend is not supported. Instead, it will always use 
Repeat. 


Point Density 
Not supported. 


Sky Texture 
In Nishita mode, the Sun Disc property is not supported. 


Other Nodes 


Light Falloff 
Not supported. 


Bump 
Imprecision due to less precise derivatives. 


Displacement/Vector Displacement 
Not supported. 


Material Output 
Displacement output behavior is broken compared to 
Cycles. 


Material Settings 


Reference 


Panel: Properties » Material » Settings 


Backface Culling 


Backface Culling hides the back side of faces in the final 
render. 


Blend Mode 


After calculating the color of a surface, the blend mode 
defines how it is added to the color buffer. Depending on 
this, the final color will be different. 


Note 


Alpha Blending is considered a “Transparent” blend mode 
and has implications regarding screen space effects. 


Opaque 
The previous color will be overwritten by the surface 
color. The alpha component is ignored. This is the fastest 


option. 


Alpha Clip 
The previous color will be overwritten by the surface 


color, but only if the alpha value is above the clip 


threshold. 


Alpha Hashed 
The previous color will be overwritten by the surface 
color, but only if the alpha value is above a random clip 
threshold. This statistical approach is noisy but is able to 
approximate alpha blending without any sorting problem. 
Increasing the sample count in the render settings will 
reduce the resulting noise. 


Alpha Blending 
Use alpha blending to overlay the surface color on top of 
the previous color. 


Sorting Problem 


When writing to the color buffer using transparent blend 
modes, the order in which the color blending happens is 
important as it can change the final output color. As of now 
Eevee does not support per-fragment (pixel) sorting or per- 
triangle sorting. Only per-object sorting is available and is 
automatically done on all transparent surfaces based on 
object origin. 


Note 


Per-object sorting has a performance cost and having 
thousands of these objects in a scene will greatly degrade 
performance. 


Show Backside 
If enabled, all transparent fragments will be rendered. If 
disabled, only the front-most surface fragments will be 
rendered. Disable this option to ensure correct 
appearance of transparency from any point of view. 


When using Alpha Blending this option should be 
disabled because with Alpha Blending, the order in which 
triangles are sorted is important. 


Shadow Mode 


Type of shadows used for a transparent surface. Eevee does 
not support colored shadow maps. 


Half transparent shadows can be produced by using hashed 
transparent shadows and a larger Soft value on the shadow 
map. 


Note 


This option does not change the behavior of contact 
Shadows which are traced using the depth buffer. If the 
material is writing to the depth buffer (in other words, if 
the blend mode is set to either Opaque, Alpha Clip or 
Alpha Hashed), contact shadows will be casted by the 
surface material regardless of the Transparent Shadow 


type. 


None 
The surface will not cast any shadow. 


Opaque 
The surface will cast shadows like an opaque surface. 


Clip 
The surface will cast shadows like an opaque surface, but 
only areas where the alpha value is above the clip 
threshold. 


Hashed 
The surface will cast shadows like an opaque surface, but 
only areas where the alpha value is above a random 
threshold. 


Screen Space Refraction 


Enabling Screen Space Refraction on a surface means that 
refraction BSDFs will do a ray trace against the depth buffer 
to find the most accurate refracted color. This has a big 
performance cost if the surface covers a lot of pixels. 


Screen Space Reflections and Ambient Occlusion are not 
compatible with Screen Space Refraction. They will be 
disabled on the surfaces that use it. Surfaces that use 
Screen Space Refraction will not appear in Screen Space 
Reflections at the right place. Surfaces that use Screen 
Space Refraction will not cast Ambient Occlusion onto other 
Surfaces. 


If this option is disabled or if the Screen Space Refraction 
ray tracing fails, the refracted ray will use the color of the 
nearest probe. 


Screen Space Refraction 
Enables screen space refraction. 


Refraction Depth 
If Refraction Depth is not 0.0, all refraction BSDFs in the 
shader will act as if the object is a thin slab of the 
refraction material having this thickness. This will model 
a second refraction event that will double the absorption 
color and start the refraction ray after this second event. 


This option greatly increases the quality of thin glass 
objects. 


Subsurface Translucency 


Eevee’s Subsurface Scattering algorithm works by blurring 
the irradiance in screen space. This means that if no visible 
part of the surface is lit, the effect disappears. 


However, true Subsurface Scattering goes beneath the 
surface and can travel a large distance. This is why a human 
ear lit from behind appears red on the front side. 


That is what this effect mimics. This translucency 
approximation only works with lights that have shadow 
maps and only on Subsurface BSDFs (not the Translucency 
BSDFs). It does not work with indirect lighting. The soft 
parameter of the shadow maps also affects this effect. 


Pass Index 


Index number for the Material Index render pass. This can 
be used to give a mask to a material which then can be read 
with the ID Mask Node in the Compositor. 


Note 


Volume Objects are not supported. 


World 


The world environment can emit light, ranging from a single 
solid color to arbitrary textures. 


In Eevee, the world lighting contribution is first rendered 
and stored in smaller resolution textures before being 
applied to the objects. This makes the lighting less precise 
than Cycles. 


See also 


Indirect Lighting. 


Light Settings 


Reference 


Panel: Properties » Light Shader Editor > 
Sidebar > Options 


Next to lighting from the background and any object with an 
emission shader, lights are another way to add light into the 
scene. The difference is that they are not directly visible in 
the rendered image, and can be more easily managed as 
objects of their own type. 


Common 


Light settings for all renderers. 


Eevee 


Specular 
Specular Light intensity multiplier. Use it for artistic 
control. Defines the intensity with which the light object 
will be visible in reflections on the surface of specular 
objects, like metals or mirrors. Setting this to 0 will make 
the light object disappear from specular reflections. Keep 
it exactly at 1.0 for photo-realistic results. 


Custom Distance 
If enabled, uses Distance as the custom attenuation 
distance instead of global Light Threshold. In order to 
avoid long setup times, this distance is first computed 


automatically based on a light threshold. The distance is 
computed at the light origin and using the inverse square 
falloff. 


Distance 
Specifies where light influence will be set to 0. 


See also 
Global Light Threshold. 


Note 


The light’s Power/Strength affect both specular and diffuse 
light. 


Shadows 


Common Parameters 


Clip Start 
Distance from the light object at which the shadow map 


starts. Any object which is closer to the light than Clip 
Start will not cast shadows. Clip Start is only available for 
point, spot and area lights. 


Bias 
Bias applied to the depth test to reduce self-shadowing 
artifacts. This determines, what size of surface details 
(for example, bumps) will cast shadows on the object 
itself. If this value is low, small bumps will cast shadows 
on the object’s surface. This might cause jagged shadow 


edge between the sunny and shadowy side of the object, 
but it can be smoothed out by turning on Soft Shadows 


Contact Shadows 


This type of shadow exists to fix light leaking caused by bias 
or shadow map undersampling. It uses the depth buffer to 
find occluders (just like Screen Space Reflections). However, 
just like Screen Space Reflections it has the same 
limitations, namely, unknown object thickness and effect 
disappearing at screen edges. 


Tip 


The distance of action of Contact Shadows should remain 
quite small. They are not accurate enough to shadow the 
entire scene. 


Distance 
World space distance in which to search for screen space 
occluder. 


Bias 
Bias applied to the ray tracing to reduce self-shadowing 
artifacts. 


Thickness 
Pixel thickness used to detect occlusion, treating any 
potential occluder as this thick. 


Cascaded Shadow Map 


Sun lights usually illuminate a large scene with many 
objects, some close, some far away. To optimize shadow 


calculation in this situation, a technique called Cascaded 
Shadow Maps is used. The distance between the camera’s 
near clip and far clip point is divided into as many equal 
intervals (called cascades) as you set the Count parameter 
below. For each cascade a different resolution shadow will 
be displayed: higher resolution for closer cascades and 
lower resolution for distant ones. Do note that cascade 
Shadow maps are always updated because they depend on 
the camera position or your view origin in the 3D-Viewport. 
This means they have a high performance impact. 


Note 


In orthographic view the cascades cover the whole depth 
range of the camera with an evenly distributed shadow 
precision. 


Count 
Number of cascades to use. More cascades means better 
Shadow precision but a lower update rate. 


Fade 
When the Fade is greater than O, the size of each 
cascade (distance interval) is increased so that 
neighboring cascades overlap. Then a fade is applied in 
the overlapping region to provide a smooth transition 
between cascades. Higher values mean the cascade’s 
size is increased more, which decreases the available 
shadow resolution inside the cascade since some of it is 
used in the overlapping region. 


Max Distance 
Distance away from the view origin (or camera origin if in 
camera view) to cover by the cascades. If the view far 


clip distance is lower than Max Distance, the view far clip 
distance will be used. Only works in perspective view. 


Distribution 
Puts more resolution towards the near clip plane. Only 
works in perspective view. 


See also 


Limitations. 


Limitations 


e Unlike in Cycles, the Size of spot lights does not change 
the softness of the cone. 


Light Probes 


Introduction 
e Irradiance Volumes 
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o Blending 
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o Viewport Display 
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o Placement 
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Introduction 


Probe objects are used by Eevee as support objects. They 
record lighting information locally in order to light the scene 
using indirect lighting. 


There are three different probe types. One for diffuse 
lighting, two for specular lighting. 


These types of objects are only useful for Eevee (and by 
extension, the Material Preview mode). They are meant to 
guide the engine to compute better lighting quickly. 


Irradiance Volumes 


Diffuse indirect lighting is stored in volumetric arrays. These 
arrays are defined by the user using Irradiance Volume 
objects. They control how arrays are placed in the world as 
well as their resolution. 


Lighting is computed at the dot positions visible when the 
Irradiance Volume object is selected. 


See also 


Indirect Lighting. 


If Ambient Occlusion is enabled, it will be applied onto 
diffuse indirect lighting. If both Ambient Occlusion and “Bent 
Normals” are enabled the indirect lighting will be sampled 
from the least occluded direction and appear more correct. 


Reference 


Panel: Object Data > Probe 


Distance 
A probe object only influences the lighting of nearby 
surfaces. This influence zone is defined by the Distance 
parameter and object scaling. The influence distance 
varies a bit, depending on the probe type. 


For Irradiance Volumes, the influence inside the volume is 
always 100%. The influence decays only outside of the 


volume until the distance to the volume reaches the 
Distance parameter value (in local space). 


Falloff 
Percentage of the influence distance during which the 
influence of a probe fades linearly. 


Intensity 
Intensity factor of the recorded lighting. Making this 
parameter anything other than 1.0 is not physically 
correct. Use it for tweaking or artistic purposes. 


Resolution 
Spatial resolution for Irradiance Volumes is determined 
per probe. The local volume is divided into a regular grid 
of the specified dimensions. One irradiance sample will 
be computed for each cell in this grid. 


Clipping 
Defines the near and far clip distances when capturing 
the scene. 


Warning 


Clipping distances are applied at the samples positions 
and not at the grid origin. 


Visibility Collection 
In some cases, it is useful to limit which objects appear in 
the light probe’s captured lighting. For instance, an 
object that is too close to a capture point might be better 
excluded. This is what the visibility collection does. Only 
objects that are in this collection will be visible when this 
probes captures the scene. 


There is also an option to invert this behavior and 
effectively hide the objects in this collection. 


Note 

This is only a filtering option. That means that if an 
object is not visible at render time it won’t be visible 
during the probe render. 


Visibility 


For every grid point a small Variance Shadow Map is 
rendered. This visibility cubemap is used to reduce light 
leaking behind occluders. You can tweak the size of this map 
inside the render settings and tweak the bias and blur 
factors per grid inside the Probe Properties tab. 


Bias 
Reduces self-shadowing. 


Bleed Bias 
Increases the “contrast” of the depth test result. 


Blur 
Amount of blur to apply when filtering the visibility 
shadow map. Does not increase runtime cost but has 
a small effect on baking time. 


Blending 


The lighting values from an Irradiance Volume will fade 
outwards until the volume bounds are reached. They will 
fade into the world’s lighting or another Irradiance Volume’s 
lighting. 


If multiple Irradiance Volumes overlap, smaller (in volume) 
ones will always have more priority. 


If an object is not inside any Irradiance Volume, or if the 
indirect lighting has not been baked, the world’s diffuse 
lighting will be used to shade it. 


Tip 


e When lighting indoor environments, try to align grids 
with the room shape. 

e Try not to put too much resolution in empty areas or 
areas with a low amount of lighting variation. 

e You can fix bad samples by adding a smaller grid near 
the problematic area. 


Viewport Display 


Influence 
Show the influence bounds in the 3D Viewport. The inner 
sphere is where the falloff starts. 


Clipping 
Show the clipping distance in the 3D Viewport. 


Reflection Cubemaps 


Specular Indirect Lighting is stored in an array of cubemaps. 
These are defined by the Reflection Cubemap objects. They 
specify where to sample the scene’s lighting and where to 


apply it. 
See also 


Indirect Lighting. 


Screen Space Reflections are much more precise than 
reflection cubemaps. If enabled, they have priority and 
Ccubemaps are used as a fall back if a ray misses. 


If Ambient Occlusion is enabled, it will be applied ina 
physically plausible manner to specular indirect lighting. 


Note 


The cube probes are encoded into tetrahedral maps. Some 
distortions may occur on the negative Z hemisphere. 
Those are more visible with higher roughness values. 


Blending 


The lighting values from a Reflection Cubemap will fade 
outwards until the volume bounds are reached. They will 
fade into the world’s lighting or another Reflection 
Cubemap’s lighting. If multiple Reflection Cubemaps 
overlap, smaller (in volume) ones will always have more 


priority. If an object is not inside any Reflection Cubemap 
influence, or if the indirect lighting has not been baked, the 
world’s cubemap will be used to shade it. 


Reference 


Panel: Object Data > Probe 


Distance 
A probe object only influences the lighting of nearby 
surfaces. This influence zone is defined by the Distance 
parameter and object scaling. The influence distance 
varies is a bit, depending on the probe type. 


For Reflection Cubemaps the influence volume can either 
be a box or a sphere centered on the probe’s origin. 


Falloff 


Percentage of the influence distance during which the 
influence of a probe fades linearly. 


Intensity 
Intensity factor of the recorded lighting. Making this 
parameter anything other than 1.0 is not physically 
correct. Use it for tweaking or artistic purposes. 


Clipping 
Define the near and far clip distances when capturing the 
scene. 


Visibility Collection 
Sometimes, it is useful to limit which objects appear in 
the light probe’s captured lighting. For instance, an 
object that is too close to a capture point might be better 
excluded. This is what the visibility collection does. Only 


objects that are in this collection will be visible when this 
probe will capture the scene. 


There is also an option to invert this behavior and 
effectively hide the objects inside this collection. 


Note 


This is only a filtering option. That means if an object is 
not visible at render time it won’t be visible during the 
probe render. 


Custom Parallax 


Reference 


Panel: Object Data » Custom Parallax 


By default, the influence volume is also the parallax volume. 
The parallax volume is a volume on which is projected the 
recorded lighting. It should roughly fit it surrounding area. In 
some cases it may be better to adjust the parallax volume 
without touching the influence parameters. In this case, just 
enable the Custom Parallax and change the shape and 
distance of the parallax volume independently. 


Viewport Display 


Influence 
Show the influence bounds in the 3D Viewport. The inner 
sphere is where the falloff starts. 


Clipping 


Show the clipping distance in the 3D Viewport. 


Parallax 
Show the Custom Parallax shape in the 3D Viewport. 


Reflection Planes 


These special types of Probe object are suited to smooth 
planar surfaces. They basically capture the whole scene 
with a flipped camera. 


Using reflection planes is really heavy on the render time 
because the scene needs to be rendered as many times as 
there is Reflection Planes in the view. 


Unless Screen Space Reflection is enabled, Reflection Planes 
only work on specular surfaces that have their roughness 
around 0. 


If Screen Space Reflection is enabled, Reflection Planes will 
serve as support buffers. This accelerates the tracing 
process and completes the missing data from the view 
space. This also make reflection more correct for the 
affected surfaces that have medium roughness and 
disturbed normals (i.e. normal maps). 


Note 


Subsurface Scattering, Screen Space Reflections and 
Volumetrics are not supported inside Reflection Plane’s 
reflection. 


Placement 


If Backface Culling is not enabled, snapping the Reflection 
Plane to the planar surface will effectively capture the 
underside of the surface. 


You can manually move the Reflection Plane above the 
surface enough for it to not appear in the capture. 
Alternatively you can put a floor object inside a collection 
and use this collection as a Visibility Collection (inverted) 
inside the Reflection Plane’s probe settings. 


Reference 


Panel: Object Data > Probe 


Distance 


A probe object only influences the lighting of nearby 
surfaces. This influence zone is defined by the Distance 
parameter and object scaling. The influence distance 
varies is a bit, depending on the probe type. 


For Reflection Planes the influence distance is the 
distance from the plane. Only surfaces whose normals 
are aligned with the Reflection Plane will receive the 
captured reflection. 


Falloff 


Percentage of the influence distance during which the 
influence of a probe fades linearly. Also defines how 
much shading normals needs to be aligned with the 
plane to receive reflections. 


Clipping Offset 


Define how much below the plane the near clip is when 
capturing the scene. Increasing this can fix reflection 
contact problems. 


Visibility Collection 
In some cases, it is useful to limit which objects appear in 
the light probe’s captured lighting. For instance, an 
object that is too close to a capture point might be better 


excluded. This is what the visibility collection does. Only 
objects that are in this collection will be visible when this 
probe will capture the scene. 


There is also an option to invert this behavior and 
effectively hide the objects inside this collection. 


Note 


This is only a filtering option. That means that if an 
object is not visible at render time it won’t be visible 
during the probe render. 


Note 


Due to a limitation, dupli-objects cannot be hidden by 
using this option. 


Viewport Display 


Reference 


Panel: Object Data >» Viewport Display 


Influence 
Show the influence bounds in the 3D Viewport. 


Arrow Size 
Size of the arrow showing the reflection plane normal. 


Show Preview Plane 
Show the captured reflected image onto a fully reflective 
plane in the 3D Viewport. 


Limitations 


Eevee’s goal is to be an interactive render engine. Some 
features may not be there yet or may be impossible to 
implement into Eevee’s architecture without compromising 
performance. 


Here is a rather exhaustive list of all the limitations you can 
expect while working with Eevee. 


Cameras 


e Only perspective and orthographic projections are 
currently supported. 


Lights 


e Only 128 active lights can be supported by Eevee ina 
scene. 

e Only 8 Shadowed sun lights can be supported at the 
same time. 

e As of now, lights can only have one color and do not 
support light node trees. 


Light Probes 


e Eevee only supports up to 128 active Reflection 
Cubemaps. 

e Eevee only supports up to 64 active Irradiance Volumes. 

e Eevee only supports up to 16 active Reflection Planes 
inside the view frustum. 


Indirect Lighting 


e Volumetrics don’t receive light from Irradiance Volumes 


but do receive world’s diffuse lighting. 


e Eevee does not support “specular to diffuse” light 


bounces nor “specular to specular” light bounces. 


e All specular lighting is turned off during baking. 


Shadows 


Only 128 active lights can be supported by Eevee ina 
scene. 

Only 8 Shadowed sun lights can be supported at the 
same time. 


Volumetrics 


Only single scattering is supported. 

Volumetrics are rendered only for the camera “rays”. 
They don’t appear in reflections/refractions and probes. 
Volumetrics don’t receive light from Irradiance Volumes 
but do receive diffuse lighting from the world. 
Volumetric shadowing only work in volumetrics. They 
won’t cast shadows onto solid objects in the scene. 
Volumetric shadowing only work for volumes inside the 
view frustum. 

Volumetric lighting do not respect the lights shapes. 
They are treated as point lights. 


Depth of Field 


e Alpha blended surfaces cannot be correctly handled by 
the post-processing blur, but will be correctly handled 
by the sample-based method. For this, you need to 
disable the post-process depth of field by setting the 
Max Size to 0. 


Screen Space Effects 


Eevee is not a ray tracing engine and cannot do ray-triangle 
intersection. Instead of this, Eevee uses the depth buffer as 
an approximated scene representation. This reduces the 
complexity of scene scale effects and enables a higher 
performance. However, only what is in inside the view can 
be considered when computing these effects. Also, since it 
only uses one layer of depth, only the front-most pixel 
distance is known. 


These limitations creates a few problems: 


e The screen space effects disappear when reaching the 
screen border. This can be partially fixed by using the 
overscan feature. 

e Screen space effects lack deep information (or the 
thickness of objects). This is why most effects have a 
thickness parameter to control how to consider potential 
intersected pixels. 

e Blended surfaces are not considered by these effects. 

They are not part of the depth prepass and do not 

appear in the depth buffer. 

Objects that a part of Holdout Collections will not be 

rendered with screen space effects. 


Ambient Occlusion 


Objects are treated as infinitely thick, producing 
overshadowing if the Distance is really large. 


Screen Space Reflections 


Only one glossy BSDF can emit screen space reflections. 
The evaluated BSDF is currently arbitrarily chosen. 
Screen Space Reflections will reflect transparent objects 
and objects using Screen Space Refraction but without 
accurate positioning due to the one layer depth buffer. 


Screen Space Refraction 


Only one refraction event is correctly modeled. 
Only opaque and alpha hashed materials can be 
refracted. 


Subsurface Scattering 


Only one BSSRDF can produce screen space subsurface 
scattering. 

The evaluated BSSRDF is currently arbitrarily chosen. 

A maximum of 254 different surfaces can use 
subsurface scattering. 

Only scaling is adjustable per pixel. Individual RGB radii 
are adjustable in the socket default value. 

Input radiance from each surfaces are not isolated 
during the blurring, leading to light leaking from surface 
to surface. 


Motion Blur 


Motion Blur is only available in final renders and is not 
shown in the 3D Viewport and thus Viewport Renders. 


Materials 


Refractions 
Refraction is faked by sampling the same reflection probe 
used by the Glossy BSDFs, but using the refracted view 
direction instead of the reflected view direction. Only the 
first refraction event is modeled correctly. An 
approximation of the second refraction event can be 
used for relatively thin objects using Refraction Depth. 
Using Screen Space refraction will refract what is visible 
inside the view, and use the nearest probe if there is no 
hit. 


Screen Space Reflections and Ambient Occlusion are not 
compatible with Screen Space Refraction; they will be 
disabled on the surfaces that use it. Surfaces that use 
Screen Space Refraction will not appear in Screen Space 
Reflections at the right place. Surfaces that use Screen 
Space Refraction will not cast Ambient Occlusion onto 
other surfaces. 


Volume Objects 
Object volume shaders will affect the whole bounding 
box of the object. The shape of the volume must be 
adjusted using procedural texturing inside the shader. 


Shader Nodes 


e All BSDF’s are using approximations to achieve realtime 
performance so there will always be small differences 
between Cycles and Eevee. 


e Some utility nodes are not yet compatible with Eevee. 


See also 


For a full list of unsupported nodes see Nodes Support. 


Memory Management 


driver. In theory, only the needed textures and meshes (now 
referred as “the resources”) for a single draw call (i.e. one 
object) needs to fit into the GPU memory. 


So if the scene is really heavy, the driver will swap things in 
and out to make sure all objects are rendered correctly. 


In practice, using too much GPU memory can make the GPU 
driver crash, freeze, or kill the application. So be careful of 
what you ask. 


There is no standard way of estimating if the resources will 
fit into the GPU memory and/or if the GPU will render them 
successfully. 


CPU Rendering 


Being a rasterization engine, Eevee only uses the power of 


(software) rendering as it would be very inefficient. CPU 
power is still needed to handle high scene complexity as the 
geometry must be prepared by the CPU before rendering 
each frame. 


Multiple GPU Support 


Headless Rendering 


There is currently no support for using Eevee on headless 
systems (i.e. without a Display Manager). 
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Introduction 


Cycles is Blender’s physically-based path tracer for 
production rendering. It is designed to provide physically 
based results out-of-the-box, with artistic control and flexible 
shading nodes for production needs. 


To use Cycles, select it as the Render Engine in the Render 
properties. For GPU accelerated rendering, enable 
compatible devices in Preferences >» System » Cycles 
Render Devices. 


See also 


The Cycles website with more information and a gallery. 


Render Settings 


Grease Pencil 
Sampling 
o Adaptive Sampling 
o Denoising 
o Path Guiding 
o Advanced 
e Light Paths 


Ray Types 
Bounce Control 
Transparency 
Settings 
Volumes 
Subdivision 
Curves 
o Viewport Display 

¢ Simplify 

o Viewport 

o Render 

o Culling 

o Grease Pencil 
e Motion Blur 

o Shutter Curve 

o Limitations 
e Film 

o Pixel Filter 

o Transparent 
e Performance 

o Threads 

o Tiles 

o Acceleration Structure 

o Final Render 


ie) 


Grease Pencil 


Reference 


Panel: Render > Grease Pencil 


This panel is comprised of settings to control the rendering 
of Grease Pencil Lines. 


Anti-Aliasing Threshold 
Threshold for the edge detection algorithm used to 
correct aliasing, higher values might over blur some part 
of the image. 


Sampling 


Reference 


Panel: Render >» Sampling 


The integrator is the rendering algorithm used to compute 
the lighting. Cycles currently supports a path tracing 
integrator with direct light sampling. It works well for 
various lighting setups, but is not as suitable for caustics 
and some other complex lighting situations. 


Rays are traced from the camera into the scene, bouncing 
around until they find a light source such as a light, an 
object emitting light, or the world background. To find lights 
and surfaces emitting light, both indirect light sampling 
(letting the ray follow the surface BSDF) and direct light 
sampling (picking a light source and tracing a ray towards 
it) are used. 


Viewport Samples 
Number of samples for viewport rendering. Setting this 
value to zero enables indefinite sampling of the viewport. 


Render Samples 
Number of paths to trace for each pixel in the final 
render. AS more samples are taken, the solution becomes 
less noisy and more accurate. 


Time Limit 
Renders scene until time limit or sample count is 
reached. When the time is set to 0, the sample count is 
used to determine when the render stops. 


Note 


The time limit does not include pre-render processing 
time, only render time. 


Adaptive Sampling 


With adaptive sampling Cycles automatically reduces the 
number of samples in areas that have little noise, for faster 
rendering and more even noise distribution. For example 
hair on a character may need many samples, but the 
background may need very few. 


With adaptive sampling it is also possible to render images 
with a target amount of noise. This is done by settings the 
Noise Threshold, typical values are in the range from 0.1 to 
0.001. Then render samples can then be set to a high value, 
and the renderer will automatically choose the appropriate 
amount of samples. 


Noise Threshold 
The error threshold to decide whether to continue 
Sampling a pixel or not. Typical values are in the range 
from 0.1 to 0.001, with lower values meaning less noise. 
Setting it to exactly 0 lets Cycles guess an automatic 
value for it based on the total sample count. 


Min Samples 
The minimum number of samples a pixel receives before 
adaptive sampling is applied. When set to O (default), it 
is automatically set to a value determined by the Noise 
Threshold. 


Denoising 


Denoising removes noise while previewing scenes in 
Rendered mode in the 3D Viewport or for final renders. 


Render 
Denoising for the final render can be enabled or disabled 
with the checkbox. For denoising the image after 
rendering with the Denoising node, the Data Render 
Passes also adapt to the selected denoiser. 


Open Image Denoise: 
Uses Intel’s Open Image Denoise, an Al 
denoiser which runs on the CPU. 

Optix: Uses an artificial intelligence algorithm 
to remove noise from renders. It is 
based on the OptiX - NVIDIA 
acceleration engine and therefore has 
the same GPU requirements as 
rendering with Optix. 


Viewport 
Denoising for the Rendered mode in the 3D Viewport can 
be enabled or disabled for with the checkbox. 


Automatic: Uses the faster available denoiser for 
3D Viewport rendering (Optix if 
available, otherwise 
OpenlmageDenoise). 

OpenlImageDenoise: 

Uses Intel’s Open Image Denoise, an Al 
denoiser which runs on the CPU. 

Optix: Uses an artificial intelligence algorithm 
to remove noise from renders. It is 
based on the OptiX - NVIDIA 
acceleration engine and therefore has 
the same GPU requirements as 
rendering with Optix. 


Start Sample 
Sample to start denoising in the 3D Viewport. 


Input Passes 
Controls which Render Pass the denoiser should use as 
input, which can have different effects on the denoised 
image. Generally, the more passes the denoiser has to 
denoise the better the result. It is recommended to at 
least use Albedo as None can blur out details, especially 
at lower sample counts. 


None: Denoises the image using color data. 
Albedo: Denoises the image using color and 
albedo data. 


Albedo + Normal: 
Denoises the image using color, 
albedo, and normal pass data. 


Prefilter 
Controls whether or not prefiltering is applied to Input 
Passes for use when denoising. Visible only when using 
OpenImageDenoise. 


None: Does not apply any prefiltering to the 
input passes. This option retains the 
most detail and is the fastest, but 
assumes the input passes are noise 
free which may require a high sample 
count. If the input passes aren’t noise 
free, then noise will remain in the 
image after denoising. 

Fast: Assumes the input passes are not noise 
free, yet does not apply prefiltering to 
the input passes. This option is faster 
than Accurate but produces a blurrier 
result. 


Accurate: Prefilters the input passes before 
denoising to reduce noise. This option 
usually produces more detailed results 
than Fast with increased processing 
time. 


Path Guiding 


Path guiding helps reduce noise in scenes where finding a 
path to light is difficult for regular path tracing, for example 
when a room is lit through a small door opening. Important 
light directions are learned over time, improving as more 
samples are taken. Guiding is Supported for surfaces with 
diffuse BSDFs and volumes with isotropic and anisotropic 
scattering. 


Note 


e Path guiding is only available when rendering ona 
CPU. 

e While path guiding helps render caustics in some 
scenes, it is not designed for complex caustics as they 
are harder to learn and guide. 


Training Samples 
The maximum number of samples to use for training. A 
value of O will keep training until the end of the render. 
Usually 128 to 256 training samples is enough for 
accurate guiding. Higher values can lead to a minor 
increases in guiding quality but with increased render 
times. 


Surface 


Enable path guiding for the diffuse component of 
Surfaces. 


Volume 
Enable path guiding inside volumes. 


Advanced 


Seed 
Seed value for integrator to get different noise patterns. 


Use Animated Seed (clock icon) 
Changes the seed for each frame. It is a good idea to 
enable this when rendering animations because a 
varying noise pattern is less noticeable. 


Pattern 
Random sampling pattern used by the integrator. 


Progressive Multi-Jitter: 

Based on Progressive Multi-Jittered 
Sample Sequences. This is the default 
pattern and the only one that supports 
Scrambling Distance. 

Sobol-Burley: Based on Practical Hash-based Owen 
Scrambling. An alternative pattern with 
the same quality as Progressive Multi- 
Jitter. 


Sample Offset 
The number of samples to skip when starting render. This 
can be used to distribute a render across multiple 
computers then combine the images with 
bpy.ops.cycles.merge_images 


Scrambling Distance 
Note, these options are not applicable when using the 
Sobol-Burley sample pattern. 


Automatic 
Uses a formula to adapt the scrambling distance 
strength based on the sample count. 


Viewport 
Uses the Scrambling Distance value for the viewport 
rendering. This will make the rendering faster but may 
cause flickering. 


Multiplier 
Lower values Reduce randomization between pixels to 
improve GPU rendering performance, at the cost of 
possible rendering artifacts if set too low. 


Min Light Bounces 
Minimum number of light bounces for each path, after 
which the integrator uses Russian Roulette to terminate 
paths that contribute less to the image. Setting this 
higher gives less noise, but may also increase render 
time considerably. For a low number of bounces, it is 
strongly recommended to set this equal to the maximum 
number of bounces. 


Min Transparent Bounces 
Minimum number of transparent bounces. Setting this 
higher reduces noise in the first bounces, but can also be 
less efficient for more complex geometry like hair and 
volumes. 


Light Threshold 
Probabilistically terminates light samples when the light 
contribution is below this threshold (more noise but 


faster rendering). Zero disables the test and never 
ignores lights. This is useful because in large scenes with 
many light sources, some might only contribute a small 
amount to the final image, and increase render times. 
Using this setting can decrease the render times needed 
to calculate the rays which in the end have very little 
affect on the image. 


Layer Samples 
When render layers have per layer number of samples 
set, this option specifies how to use them. 


Use: The render layer samples will override 
the set scene samples. 

Bounded: Bound render layer samples by scene 
samples. 


Ignore: Ignore render layer sample settings. 


Light Paths 


Reference 


Panel: Render » Light Paths 


Ray Types 


Ray types can be divided into four categories: 


1. Camera: the ray comes straight from the camera. 

2. Reflection: the ray is generated by a reflection off a 
surface. 

3. Transmission: the ray is generated by a transmission 
through a surface. 

4. Shadow: the ray is used for (transparent) shadows. 


Reflection and transmission rays can further have these 
properties: 


e Diffuse: the ray is generated by a diffuse reflection or 
transmission (translucency). 

e Glossy: the ray is generated by a glossy specular 
reflection or transmission. 

e Singular: the ray is generated by a perfectly sharp 
reflection or transmission. 


The Light Path node can be used to find out the type of ray 
the shading is being computed for. 


See also 


The object ray visibility settings. 


Bounce Control 


The maximum number of light bounces can be controlled 
manually. While ideally this should be infinite, in practice a 
Smaller number of bounces may be sufficient, or some light 
interactions may be intentionally left out for faster 
convergence. The number of diffuse reflection, glossy 
reflection and transmission bounces can also be controlled 
individually. 


Light paths are terminated probabilistically when specifying 
a minimum number of light bounces lower than the 
maximum. In that case, paths longer than minimum will be 
randomly stopped when they are expected to contribute 
less light to the image. This will still converge to the same 
image, but renders faster while possibly being noisier. 


Transparency 


When a ray passes through it, light passes straight on, as if 
there was no geometry there. The ray type does not change 
when passing through a transparent BSDF. 


Alpha pass output is also different for the transparent BSDF. 
Other transmission BSDFs are considered opaque, because 
they change the light direction. As such they cannot be used 
for alpha-over compositing, while this is possible with the 
transparent BSDF. 


Note that, while semantically the ray passes through as if no 
geometry was hit, rendering performance is affected as 
each transparency step requires executing the shader and 
tracing a ray. 


Settings 


Max Bounces 


Total 
Maximum number of light bounces. For best quality, this 
should be set to the maximum. However, in practice, it 
may be good to set it to lower values for faster 
rendering. A value of 0 bounces results in direct lighting 
only. 


Diffuse 
Maximum number of diffuse bounces. 


Glossy 
Maximum number of glossy bounces. 


Transmission 
Maximum number of transmission bounces. 


Volume 
Maximum number of volume scattering bounces. 


Transparent 
Maximum number of transparency bounces. 


Note, the maximum number of transparent bounces is 
controlled separately from other bounces. It is also 
possible to use probabilistic termination of transparent 
bounces, which might help rendering many layers of 
transparency. 


Clamping 


Direct Light 
This option limits the maximum intensity a sample from 
rays which have not yet bounced can contribute to a 
pixel. It reduces noise at the cost of accuracy. Setting this 
option to 0.0 disables clamping altogether. Lower have a 
greater affect (dimmer samples) on the resulting image 
than higher values. 


Note 


This option provides a way to limit Fireflies. However, 
note that as you clamp out such values, other bright 
lights/reflections will be dimmed as well. 


Care must be taken when using this setting to find a 
balance between mitigating fireflies and losing 
intentionally bright parts. It is often useful to clamp 
indirect bounces separately, as they tend to cause more 
fireflies than direct bounces. See the Clamp Indirect 
setting. 


Indirect Light 
The same as Direct Light, but for rays which have 
bounced multiple times. 


Caustics 
A common source of noise is Caustics. 


See also 


See Reducing Noise for examples of the clamp settings in 
use. 


Filter Glossy 
When using a value higher than 0.0, this will blur glossy 
reflections after blurry bounces, to reduce noise at the 
cost of accuracy. 1.0 is a good starting value to tweak. 


Some light paths have a low probability of being found 
while contributing much light to the pixel. As a result 
these light paths will be found in some pixels and not in 
others, causing Fireflies. An example of such a difficult 
path might be a small light that is causing a small 
specular highlight on a sharp glossy material, which is 
observed through a rough glossy material. In fact in such 
a case there practically occurs a caustic. 


With path tracing it is difficult to find the specular 
highlight, but if you increase the roughness on the 
material, the highlight gets bigger and softer, and so 
easier to find. Often this blurring will hardly be 
noticeable, because it is blurred by the material anyway, 
but there are also cases where this will lead to a loss of 
detail in lighting. 


Caustics 
Reflective 
While in principle path tracing supports rendering of 
caustics with a sufficient number of samples, in 
practice it may be inefficient to the point that there is 
just too much noise. This option can be unchecked, to 
disable reflective caustics. 


Refractive 
The same as above, but for refractive caustics. 


Fast Gl Approximation 


Reference 


Panel: Render » Light Paths » Fast Gl 
Approximation 


Approximate diffuse indirect light with background tinted 
ambient occlusion. This provides fast alternative to full 
global illumination (GI), for interactive viewport rendering or 
final renders with reduced quality. 


Method 
Fast GI approximation method. 


Replace: Replace global illumination with 
ambient occlusion after a specified 
number of bounces. 

Add: Add ambient occlusion to diffuse 
surfaces. 


AO Factor 
The strength of the ambient occlusion. 


AO Distance 


Distance from shading point to trace rays. A shorter 
distance emphasizes nearby features, while longer 
distances make it also take objects farther away into 
account. 


This option can also be overridden per object in the 
Object Properties, which is useful when you have both 
Small and large scale objects in the same scene. 


Viewport Bounces 
Replace global illumination with ambient occlusion after 
the specified number of bounces when rendering in the 
3D Viewport. This can reduce noise in interior scenes 
with little visual difference. 


Render Bounces 
Number of bounces when rendering final renders. 


Volumes 


Reference 


Panel: Render > Volumes 


Volume Step size is the distance between volume shader 
samples. Cycles automatically estimates this distance based 
on voxel size in volume objects and smoke simulations. 


Render time can be reduced by increasing the step size, at 
the cost of potentially losing some volume detail. For 
procedural volume shaders that add detail, step size can be 
increased per object, material or world. 


Step Rate Render 
Global multiplier on the step size for all volumes in 
renders. Increase to reduce render time, at the cost of 
losing detail. 


Viewport 
Global multiplier on the step size for all volumes in the 
viewport. Increase for more responsive viewport 
rendering. 


Max Steps 
Maximum number of steps through the volume before 
giving up, to protect from extremely long render times 
with big objects or small step sizes. 


Subdivision 


Reference 


Panel: Render > Subdivision 


Note 


These settings are only available if Experimental Feature 
Set is turned on. 


These settings are used to control Adaptive Subdivision. 


Dicing Rate Render, Viewport 
Size of Micropolygons in pixels for the final/viewport 
render. 


Offscreen Scale 
Multiplier for dicing rate of geometry outside of the 
camera view. The dicing rate of objects is gradually 
increased the further they are outside the camera view. 
Lower values provide higher quality reflections and 
shadows for off screen objects, while higher values use 
less memory. 


Max Subdivisions 
Stop subdividing when this level is reached even if the 
dicing rate would produce finer Tessellation. 


Dicing Camera 
Camera to use as reference point when subdividing 
geometry, useful to avoid crawling artifacts in animations 
when the scene camera is moving. 


Curves 


Reference 


Panel: Render > Curves 


These are global settings that apply to all instances of 
particle hair systems. The resolution of the strands is 
controlled by the step values in particle settings. Each hair 
system uses the material identified in the particle settings. 


Shape 
Rounded Ribbons: 

Render curves as flat ribbon with 

rounded normals, for fast rendering. 

Curves are subdivided with a fixed 

number of specified subdivisions. 

Curve Subdivisions 
Number of subdivisions used in 
cardinal curve intersection (power of 
2). 


3D Curves: Render curves as circular 3D geometry, 
for accurate results when viewing 
curves close up. Curves are 
automatically subdivided until the 
curve is smooth. 


Viewport Display 


These settings control the curve rendering settings used 
when the 3D viewport is set to Material Preview 


Shape 
Strand: Render curves as a thin strand roughly 
a pixel wide. Curve diameter 
parameters are ignored with this 
setting. 
Strip: Render curves as a flat ribbon with 
rounded normals. 


Additional Subdivisions 
Additional subdivisions to be applied on top of the curve 
resolution set in the hair system settings. Increasing this 
value will smooth out the curves of the strands. 


Simplify 


Reference 


Menu: Render >» Simplify 


Common Settings 


Max Subdivision 
Maximum number of subdivision by the Subdivision 
Surface modifiers. 


Child Particles 
Show only a subset of all child hairs and particles. 


Texture Limit 
Automatically scales textures down so that they are no 
larger than the values chosen. This can help reduce 
computer memory resources when rendering large 
scenes with huge textures. 


Viewport 


See Common Settings above. 


Volume Resolution 
Resolution percentage of volume objects in the viewport. 
This mostly affects memory usage rather than 
computation times. 


Render 


See Common Settings above. 


Culling 


Camera Cull 
Automatically culls objects based on the camera frustum 
defined by the Margin. 


Distance Cull 
Automatically culls objects based on their distance from 
the active camera. This is set via the Distance property. 


Grease Pencil 


Playback Only 
Activates the simplification process only during 
animation playback. 


Fill 
Shows the fill component in Grease Pencil materials. 


Modifiers 
Shows Grease Pencil modifiers. 


Shader Effects 
Shows Grease Pencil visual effects. 


Layer Tinting 
Shows layers tint overrides. 


Anti-Aliasing 
Use Anti-Aliasing to smooth stroke edges. The amount of 
anti-aliasing can be adjusted by the Anti-Aliasing 
Threshold. 


Motion Blur 


Reference 


Panel: Render > Motion Blur 


Blender’s animations are by default rendered as a sequence 
of perfectly still images. While great for stop-motion and 
time-lapses, this is unrealistic, since fast-moving objects do 
appear to be blurred in the direction of motion, both ina 
movie frame and in a photograph from a real-world camera. 


Motion blur example. (blend-file) 


Position 
Controls at what point the shutter opens in relation to the 


current frame. 


Start on Frame: 


Shutter is starting to open at the 
current frame. 

Center on Frame: 
Shutter is fully opened at the current 
frame. 

End on Frame: Shutter is fully closed at the current 
frame. 


Shutter 
Time (in frames) between when the shutter starts to 


open and fully closed. For example, shutter time 1.0 blurs 
over the length of 1 frame. 


Rolling Shutter 
Creates a Rolling Shutter effect. 


None: No rolling shutter effect. 
Top-Bottom: Renders rolling shutter from the top of 
the image to the bottom. 


Rolling Shutter Duration 
Controls balance between pure rolling shutter effect (if 


the value is zero) and pure motion blur effect (if the 
value is one). 


Note 
If there are particles or other physics system in a scene, be 


sure to bake them before rendering, otherwise you might 
not get correct or consistent motion blur. 


See also 


Each object has its own settings to control motion blur. 
These options can be found in the Object tab of the 
Properties. See object setting for more information. 


Shutter Curve 


Curve defining how the shutter opens and closes. The X axis 
is time, Y values of 0 mean fully closed shutter, Y values of 1 
mean fully opened shutter. The default mapping is set to 
when shutter opens and closes instantly. 


Limitations 


e Deformation motion blur does not work on objects with 
Auto Smooth enabled. 

e Camera motion blur does not work for Orthographic 
Cameras. 

e Motion blur does not take into account the movement of 
Lights. 


Film 


Reference 


Panel: Render > Film 


Exposure 
This can be used to change the brightness of an image. 
Different than the Exposure option found in the Color 
management panel, this exposure option works on the 
data while the Color management exposure is on the 
view transform. 


Pixel Filter 


Due to limited resolution of images and computer screens, 
pixel filters are needed to avoid Aliasing. This is achieved by 
Slightly blurring the image to soften edges. 


Type 
Pixel Filtering algorithm to use. 
Box: No filter. 
Gaussian: Smooth filter. 


Blackman-Harris: 
Default filter with a better balance 
between smoothness and detail 
preservation. 


Width 
Lower values give more crisp renders, higher values are 
softer and reduce aliasing. 


Transparent 


Render the background transparent, for compositing the 
image over another background after rendering. 


Transparent Glass 
Render transmissive surfaces as transparent, for 
compositing glass over another background. 


Transparent Roughness 
For transparent glass, keep surfaces with roughness 
above the threshold opaque. 


Performance 


Reference 


Panel: Render > Performance 


Properties that affect render speeds or memory 
consumption. There are several presets available to help 
choose between different trade offs: 


Default: Balances memory saving and faster 
rendering settings. 

Faster Render: Uses settings to render faster at the cost 
of higher memory consumption. 

Lower Memory: 
Uses settings to decrease memory 
considered at the cost of slower renders. 


Threads 


Threads Mode 
Method to determine the maximum number of CPU cores 
to use while rendering. 


Auto-Detect: Automatically chooses the amount of 
threads to match the number of logical 
processors on your computer. 

Fixed: 


Manually choose the maximum number 
threads to use for rendering. This can 
be useful for example, if you want to 
use your computer while rendering, 
you can set the property to a thread 
count lower the amount of logical 
processors on your computer. 


Threads 
The maximum number of CPU cores to use 
simultaneously while rendering. 


Tiles 


Use Tiling 
Render high resolution images in tiles to reduce memory 
usage. Tiles are cached to disk while rendering to save 
memory. 


Tile Size 
This value is used to control the size of the tile used for 
rendering; decreasing the size reduces memory usage. 


Note 

In some cases changing the Tile Size can result in 
increased performance. For example when a small 
object renders slowly compared to other objects, using 
a small Tiles Size can lead to an increase in 
performance. 


Acceleration Structure 


Use Spatial Splits 
Spatial splits improve the rendering performance in 
scenes with a mix of large and small polygons. The 
downsides are longer BVH build times and slightly 
increased memory usage. 


Use Curves BVH 
Use a special type of BVH for rendering curves. The 
bounding boxes are not axis aligned allowing a spatially 
closer fit to the curve geometry. Disabling this option will 
reduce memory, at the cost of increasing curve render 
time. 


BVH Time Steps 
Split BVH primitives by this number of time steps to 
speed up render time at the expense of memory. 


Use Compact BVH 
Use a more compact BVH structure, which can reduce 
RAM usage but render slower. 


Final Render 


Persistent Data 
Keep render data in memory after rendering for faster re- 
renders and animation renders at the cost of extra 
memory usage while performing other tasks in Blender. 


When using multiple View Layers, only data from a single 
view layer is preserved to keep memory usage within 
bounds; however, objects shared between view layers 
are preserved. 


Viewport 


Pixel Size 
Option to control the resolution for viewport rendering. 
Allows you to speed up viewport rendering, which is 
especially useful for displays with high DPI. 


World Settings 
Mist Pass 


Reference 


Panel: World > Mist Pass 


Note 


The mist pass must be enabled in the View Layer tab of 
the Properties Editor before the settings below are 
available in the World tab. 


Mist can greatly enhance the illusion of depth in your 
rendering. To create mist, Blender generates a render layer 
with a depth map ranging between 0.0 and 1.0 that can be 
used in the Compositor to generate a mist effect. 


Start 
The distance from the camera at which the mist starts to 
fade in. 

Depth 


The distance from Start of the mist, that it fades in over. 
Objects further from the camera than Start + Depth are 
completely hidden by the mist. 


Falloff 
The curve function that controls the rate of change of the 


mist’s strength further and further into the distance. 


Quadratic: Uses the same calculation as light 
falloff (\(1\over{x*2}\)) and provides 
the smoothest transition from 
transparent (0.0) to opaque (1.0). 

Linear: Has a steeper start than quadratic (\ 
(1\over{x}\)). 

Inverse Quadratic: 

Has the steepest start (\ 
(1\over{\sqrt{x}}\)) and approaches 
1.0 faster than the other two functions. 


Tip 


A visualization can be activated in the Camera >» Viewport 
Display panel. 


Mist example (blend-file). 


Ray Visibility 


Reference 


Panel: World > Ray Visibility 


As with other objects, Ray Visibility allows you to control 
which other shaders can “see” the environment. 


Tricks 


Sometimes it may be useful to have a different background 
that is directly visible versus one that is indirectly lighting 
the objects. A simple solution to this is to add a Mix node, 
with the Blend Factor set to Is Camera Ray. The first input 
color is then the indirect color, and the second the directly 
visible color. This is useful when using a high-res image for 
the background and a low-res image for the actual lighting. 


Similarly, adding the Is Camera and Is Glossy rays will mean 
that the high-res image will also be visible in reflections. 


Color 


e Strength 1.000 


Nodes for the trick above. 


Settings 


Reference 


Panel: World >» Settings 


Surface 


Sampling 
Controls the sampling method for the world material. 
Selecting Auto or Manual enables Multiple Importance 
Sampling while None disables it. Multiple Importance 
Sampling is a method to sample the background texture 
such that lighter parts are favored, creating an 
importance map. It will produce less noise in the render 
in trade of artifacts (Fireflies). Enable this when using an 
image texture with small area lights (like the sun), 
otherwise noise can take a long time to converge. 


Below is a comparison between Multiple Importance 
Sample off and on. Both images are rendered for 25 
seconds (Off: 1,500 samples, On: 1,000 samples). 


Multiple Multiple 
Importance Sample Importance Sample 


off. on. 


Map Resolution 
Sets the resolution of the importance map. A higher 
resolution will better detect small features in the map 
and give more accurate sampling but conversely will take 
up more memory and render slightly slower. Higher 
values also may produce less noise when using high-res 
images. 


Max Bounces 
Maximal number of bounces the background light will 
contribute to the render. 


See also 


See Reducing Noise for more information on how to reduce 
noise. 


Shadow Caustics 
Mark the World Shader as a refractive caustic caster. This 
setting can be used in conjunction with the Cast and 
Receive caustics object settings to selectively speed up 
refractive caustic rendering of select objects. 


Volume 


Sampling Method 
Distance: For dense volumes lit from far away 
Distance sampling is more efficient in 
most cases. Usually this shouldn’t be 
used for World volumes. 
Equiangular: 


If you have got a light inside or near 
the volume then equiangular sampling 
is better. 

Multiple Importance: 
If you have a combination of both, then 
the multiple importance sampling will 
be better. 


Interpolation 
Interpolation method to use for the volume. 


Linear: Simple interpolation which gives good 
results for thin volumes. 

Cubic: Smoothed high-quality interpolation 
needed for more dense volumes, but 
slower. 

Homogeneous 


Assume volume has the same density everywhere (not 
using any textures), for faster rendering. Usually this is 
automatically determined by the renderer. This settings 
provides a manual control for cases where it is not 
detected. 


Step Size 
Distance between volume shader samples for world 
volume shaders. See Volume Render Settings for more 
information. 


Light Group 


Light Group Cycles only 


Select the Light Group to add the current World Surface 
Shader too. 


Add Light Group 


If the name input into the Light Group field does not 
align with an existing Light Group, then pressing this 
button will create a Light Group with that name and 

assign this World Shader to it. 


Object Settings 


These are options that are scattered though out Blender, 
and are often only available in certain contexts. 


e Object 

o Visibility 

o Motion Blur 

o Shading 
Adaptive Subdivision 

o Known Limitations 
Cameras 

o Panoramic Cameras 


Object 
Visibility 
Reference 


Panel: Object Properties » Visibility 
See also 


There are several other general visibility properties. 


Mask 
Shadow Catcher 
Enables the object to only receive shadow rays. It is to 
be noted that, shadow catcher objects will interact 
with other CG objects via indirect light interaction. 


world footage. 


Note 

The Shadow Catcher outputs different results 
depending on if the Shadow Catcher pass is enabled 
in Render Layer settings. With the Shadow Catcher 
pass enabled, all indirect light interactions are 
captured. With it disabled, a simple approximation is 
used instead. The simple approximation is used in 
viewport rendering. 


Example of the shadow catcher. Note how the 
material of the plane can still be viewed in the 
spheres. 


Ray Visibility 


Objects can be set to be invisible to particular ray types. 
This can be used, for example, to make an emitting mesh 
invisible to camera rays. For instanced objects, visibility is 
inherited; if the parent object is hidden for some ray types, 
the children will be hidden for these too. 


In terms of performance, using these options is more 
efficient that using a shader node setup that achieves the 
same effect. Objects invisible to a certain ray will be skipped 
in ray traversal already, leading to fewer ray casts and 
shader executions. 


Camera 
Makes the object visible in camera rays. 


Diffuse 
Makes the object visible in diffuse rays. 


Glossy 
Makes the object visible in glossy rays. 


Transmission 
Makes the object visible in transmission rays. 


Volume Scatter 
Makes the object visible in transmission rays. 


Shadow 
Enables the object to cast shadows. 


Culling 


In order to activate these options the respectively camera 
cull options have to be enabled in the scene simplify panel. 


Use Camera Cull 
Ignore and this way make objects invisible to rays 
outside of the camera frustum. 


Use Distance Cull 
Will cull any objects further from the camera than a given 
distance. When used in combination with camera frustum 
culling, this can be used to avoid culling nearby objects 
that are outside the camera frustum, but still visible in 
reflections. It is also useful to cull small objects far from 
the camera. 


Motion Blur 


Reference 


Panel: Properties » Object Properties » Motion 
Blur 


Each object has its own motion blur settings along with the 
Scene Level Motion Blur. These settings can be found in the 


Object Properties tab of the Properties. 


Steps 
Controls accuracy of deformation motion blur, more steps 
uses more memory. The actual number of time steps is \ 
(2*“{steps -1}\). 


Deformation 
Enables motion blur for deformed meshes such as 
animated characters, including hair. 


Warning 

An object modifier setup that changes mesh topology 
over time can not render deformation motion blur 
correctly. Deformation blur should be disabled for such 
objects. Common examples of this are animated 
Booleans, Deformation before Edge Split, Remesh, Skin 
or Decimate modifiers. 


Shading 


Reference 


Panel: Properties >» Object Properties >» Shading 


Shadow Terminator 


Geometry Offset 
Offset rays from the surface to reduce shadow terminator 
artifacts on low-poly geometry. Higher values affect more 
triangles, a value of one affecting all triangles and zero 
having no affect. The default value only affects triangles 


at grazing angles to light and should eliminate most 
artifacts. 


Unlike the Shading Offset, this option has little affect on 
the lighting making it the preferable method to handle 
shadow terminator artifacts. 


Shading Offset 
Pushes the shadow terminator (the line that divides the 
light and dark) towards the light to hide artifacts on low- 
poly geometry such as the ones below: 


Shadow Terminator Result of using an 
Artifacts. offset of 0.15. 
Note 


This property artificially alters the scene’s lighting and 
is not energy conserving and consequently not 
physically accurate (see Geometry Offset instead). 


Fast Gl Approximation 


AO Distance 


Override for the world’s AO Distance, if the value is zero 
the world’s distance is used. 


Caustics 


Mark objects as caustic casters or receivers. This is used in 
conjunction with a Light or World Shader with Shadow 
Caustics enabled to selectively soeed up caustic rendering 
of objects in your scene. 


Note 


The rendering technique used to speed up the rendering of 
caustics is based on MNEE. There are a number of 


limitations with this technique and it’s implementation in 
Cycles: 


Only refractive caustics in the shadows of objects 
work. Caustics from reflections or caustics that fall 
outside shadows are not rendered with this technique. 
MNEE Caustics are an approximation of caustics and 
will produce physically inaccurate results in many 
situations. Examples include incorrect brightnesses 
and the incorrect representation of caustics caused by 
rough or curved surfaces. 

In complex materials with multiple refractive BSDFs, 
MNEE will only generate caustics for one of the BSDFs. 
Filter Glossy settings are ignored when using MNEE for 
refractive caustics. 

MNEE Caustic rays can pass through up to 6 Caustic 
Caster surfaces between a Caustic Reciever and a 
Shadow Caustic light before the ray is terminated and 
caustics are ignored. 

The Ambient Occlusion and Bevel nodes will not 
produce a valid result on objects that are a Caustic 


caster or Caustic receiver while the scene contains a 
active Caustic caster, Caustic receiver, and Shadow 
Caustic Light. 

e MNEE Caustics only work if the caustic caster has 
smooth normals. 

e Volumetric materials are not considered when 
calculating MNEE caustics. 

e Bump and normal maps are ignored when calculating 
caustics. 


Cast Shadow Caustics 
Mark an object as a caustic caster. 


Receive Shadow Caustics 
Mark an object as a caustic receiver. 


Rendering caustics Rendering caustics 
inside an eye inside an eye using 
without MNEE at 32 MNEE at 32 samples 
Samples per pixel. per pixel. 


Light Group 


Light Group 
Select the Light Group to add the current Object or Light 
too. 


Add Light Group 
If the name input into the Light Group field does not 
align with an existing Light Group, then pressing this 
button will create a Light Group with that name and 
assign the selected Object or Light to it. 


Adaptive Subdivision 


Reference 


Panel: Modifier >» Subdivision Surface 


Note 


Implementation not finished yet, marked as an 
Experimental Feature Set. 


When using the Experimental Feature Set the Subdivision 
Surface Modifier gets changed to control the subdivision of a 
mesh at the time of rendering. For this, all the other settings 
are the same except the View and Render settings. These 
before mentioned settings get removed/renamed and the 
following settings are added: 


Adaptive Subdivision 
Use OpenSubdiv to give different subdivision levels to 
near and far objects automatically. This allows nearer 
objects to get more subdivisions and far objects to get 
less. 


Dicing Scale 
Multiplier of the scene dicing rate to determine the 
final size of Micropolygons in pixels. 


Subdivision off/on, Dicing Scale: 1.0 - 0.3 - 
0.05 (monkeys look identical in viewport, no 
modifiers). 


Known Limitations 


e Multi-user object data are currently made single users, 
leading to increased memory usage. For those it is 
better to use non-adaptive subdivision still. 

e Multi-view renders can have some inconsistencies 
between views. 


Warning 


Instances are not tessellated individually. Instead, the 
Original object is tessellated and then duplicated on all 
instances. To take advantage of both adaptive subdivision 
and instancing you should place the original object at the 
position of the instance that is closest from the camera. 


Cameras 


Panoramic Cameras 


Cycles supports several types of panoramic cameras which 
are described in detail below. Note that these cannot be 
displayed in non-rendered modes in the viewport, i.e. Solid 
mode; they will only work for the final render. 


Equirectangular 


Render a panoramic view of the scenes from the camera 
location and use an equirectangular projection, always 
rendering the full 360° over the X axis and 180° over the Y 
axis. 


This projection is compatible with the environment texture 
as used for world shaders, so it can be used to render an 
environment map. To match the default mapping, set the 
camera object rotation to (90, 0, -90) or pointing along the 
positive X axis. This corresponds to looking at the center of 
the image using the default environment texture mapping. 


Latitude Min, Max 
Limits of the vertical field of view angles. 


Longitude Min, Max 
Limits of the horizontal field of view angles. 


Equiangular Cubemap Face 


Improves on Equirectangular by providing a more uniform 
distribution of rendered pixel of the spherical environment. 
This results in an image that has little variation in visual 
resolution for the entire spherical projection. This is in 
contrast to Equirectangular which can lose detail in the 
poles of the image. This is also in contrast to cube map 
projections which lose detail near the edges of each face. 


This panorama type is great for virtual reality use cases 
where providing as much visual detail for a limited 
resolution is important. 


A limitation over Equirectangular is that this method does 
not have longitude or latitude limits. 


Fisheye 


Fisheye lenses are typically wide angle lenses with strong 
distortion, useful for creating panoramic images for e.g. 
dome projection, or as an artistic effect. 


The Fisheye Equisolid lens will best match real cameras. It 
provides a lens focal length and field of view angle, and will 
also take the sensor dimensions into account. 


The Fisheye Equidistant lens does not correspond to any 
real lens model; it will give a circular fisheye that does not 
take any sensor information into account but rather uses the 
whole sensor. This is a good lens for full-dome projections. 


Lens 
Lens focal length in millimeters. 


Field of View 
Field of view angle, going to 360 and more to capture the 
whole environment. 


Fisheye Lens Polynomial 


Match a real world camera by specifying the coordinates of 
a 4th degree polynomial. 


The projection works as follows. Pixels in the image are 
mapped to positions \((x, y)\) on the camera sensor in mm. 
A position on the sensor is mapped to a direction with 
spherical coordinates \((1, \theta, \phi)\) in radians as 
follows: 


\[\begin{split}& r = \sqrt{x*2 + y*2}\\ & \theta = k_ 0 + 
kK lrt+k2r*72+k 3r*73 +k 4r74\\ & \phi = 
acos(x/r)\end{split}\] 


Incoming light from this direction is then projected onto the 
corresponding pixel. 


This can be used to model both fisheye and perspective 
cameras. 


Mirror Ball 


Render as if taking a photo of a reflective mirror ball. This 
can be useful in rare cases to compare with a similar photo 
taken to capture an environment. 


Material Settings 


Reference 

Panel: Material >» Settings and Shader Editor » 
Sidebar > Settings 

Surface 


Multiple Importance Sample 
By default objects with emitting materials use both direct 
and indirect light sampling methods. But in some cases it 
may lead to less noise overall to disable direct light 
sampling for some materials. This can be done by 
disabling the Multiple Importance Sample option. This is 
especially useful on large objects that emit little light 
compared to other light sources. 


This option will only have an influence if the material 
contains an Emission node; otherwise it will be disabled. 


Transparent Shadows 
Use transparent shadows if it contains a Transparent 
BSDF, disabling will render faster but will not give 
accurate shadows. 


Displacement Method 
Method used to perform Displacement on materials. 


Displacement Only: 


Mesh vertices will be displaced before 
rendering, modifying the actual mesh. 
This gives the best quality results, if 
the mesh is finely subdivided. As a 
result, this method is also the most 
memory intensive. 

Bump Only: When executing the surface shader, a 
modified surface normal is used 
instead of the true normal. This is a 
less memory intensive alternative to 
actual displacement, but only an 
approximation. Surface silhouettes will 
not be accurate and there will be no 
self-shadowing of the displacement. 

Displacement and Bump: 
Both methods can be combined, to do 
displacement on a coarser mesh, and 
use bump mapping for the final detail. 


Volume 
Sampling Method 
Distance: For dense volumes lit from far away 
Distance sampling is usually more 
efficient. 
Equiangular: If you have got a light inside or near 
the volume then equiangular sampling 
is better. 


Multiple Importance: 
If you have a combination of both, then 
the multiple importance sampling will 
be better. 


Interpolation 


Interpolation method to use for the volume objects and 
smoke simulation grids. 


Linear: Simple interpolation which gives good 
results for thin volumes. 

Cubic: Smoothed high-quality interpolation 
needed for more dense volumes, but 
slower. 

Homogeneous 


Assume volume has the same density everywhere (not 
using any textures), for faster rendering. For example 
absorption in a glass object would typically not have any 
textures, and so the renderer can be set to avoid taking 
Small steps to sample the volume shader. Usually this is 
automatically determined by the renderer. This setting 
provides a manual control for cases where it is not 
detected. 


Step Rate 
Adjust distance between volume shader samples for 
volume shaders. This is typically used to reduce the step 
size for procedural shaders that add more detail with 
procedural textures, when it is not captured by the 
default step size. See Volume Render Settings for more 
information. 


Light Settings 


Reference 


Panel: Properties >» Light and Shader Editor > 
Sidebar > Settings 


Next to lighting from the background and any object with an 
emission shader, lights are another way to add light into the 
scene. The difference is that they are not directly visible in 
the rendered image, and can be more easily managed as 
objects of their own type. 


Common 


Light settings for all renderers. 


Cycles 


Max Bounces 
Maximum number of times light from the light is allowed 
to Bounce. Limited by scene-wide bounce settings. 


Cast Shadow 
By disabling this option, light from lights will not be 
blocked by objects in between. This can speed up 
rendering by not having to trace rays to the light source. 


Multiple Importance Sample 
By default lights use only direct light sampling. For area 
lights and sharp glossy reflections, however, this can be 


noisy, and enabling this option will enable indirect light 
Sampling to be used in addition to reduce noise. 


Shadow Caustics 
Mark a light as a refractive caustic caster. This setting 
can be used in conjunction with the Cast and Receive 
caustics object settings to selectively speed up refractive 
caustic rendering of select objects. 


Area Lights 


Portals 


Area lights can also function as light portals to help 
sample the environment light, and significantly reduce 
noise in interior scenes. Note that rendering with portals 
is usually slower, but as it converges more quickly, less 
Samples are required. 


Light portals work by enabling the Porta! option, and 
placing areas lights in windows, door openings, and any 
place where light will enter the interior. 


In outdoor scenes most rays do not bounce much and 
just fly off into the sky and therefore, light portals are not 
helpful for outdoor scenes. 
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White Room model by Jay Hardy. 


Beam Shape 


Spread 
How wide the emitted light fans out controlling how 
diffused the light is. Larger values create soft shadows 
while smaller values create sharper light simulating a 
gridded softbox. 


spread 180 deg 


Example of Spread at different angles. 


GPU Rendering 


for rendering, instead of the CPU. This can speed up 
rendering because modern GPUs are designed to do quite a 
lot of number crunching. On the other hand, they also have 
some limitations in rendering complex scenes, due to more 
limited memory, and issues with interactivity when using 
the same graphics card for display and rendering. 


To enable GPU rendering, go into the Preferences >» System 
>» Cycles Render Devices, and select either CUDA, Optix, 
HIP, oneAPI, or Metal. Next, you must configure each scene 
to use GPU rendering in Properties » Render > Device. 


Rendering Technologies 


Blender supports different technologies to render on the 
GPU depending on the particular GPU manufacturer and 
operating system. 


Note 


Open Shading_Language and path guiding are not 
Supported when rendering on the GPU. 


CUDA - NVIDIA 


Nvidia graphics cards with compute capability 3.0 and 
higher. To make sure your GPU is supported, see the list of 


Nvidia graphics cards with the compute capabilities and 
Supported graphics cards. 


OptiX - NVIDIA 


OptiX is supported on Windows and Linux and requires a 
Nvidia graphics cards with compute capability 5.0 and 
higher and a driver version of at least 470. To make sure 
your GPU is supported, see the list of Nvidia graphics cards 
OptiX works best on RTX graphics cards with hardware ray 
tracing support (e.g. Turing and above). 


HIP - AMD 


graphics card with the Vega architecture or newer. Both 
discrete GPUs and APUs are supported. 


Supported GPUs include: 


Radeon VII 

Radeon RX Vega Series 
Radeon RX 5000 Series 
Radeon RX 6000 Series 
Radeon RX 7000 Series 
Radeon Pro WX 9100 
Radeon Pro W6000 Series 


Minimum driver versions: 


e Windows: Radeon Software 21.12.1 or Radeon PRO 
Software 21.Q4 
e Linux: Radeon Software 22.10 or ROCm 5.3 


Please refer to AMD's website for more information about 
AMD graphics cards and their architectures. 


Note 


The Clip extension mode in the Image Texture Node is not 
Supported. 


oneAPI - Intel 


oneAPI is a computation library that is supported on 
Windows and Linux and requires a Intel® Arc™ graphics 
card with the Xe HPG architecture. 


Supported GPUs include: 
e Intel® Arc™ A-Series 
Minimum driver versions: 


e Windows: Intel Graphics Driver 30.0.101.3430 
e Linux: OpenCL runtime 22.10.23904 


Please refer to Intel’s website for more information about 
Intel graphics cards and their architectures. 


Metal - Apple (macOS) 


Metal is supported on Apple computers with Apple Silicon, 
AMD and Intel graphics cards. macOS 13.0 or newer is 
required to support all features and graphics cards. 


Apple Silicon and AMD graphics cards also work on macOS 
12.3 and newer, however without support for MNEE 
Caustics. 


Frequently Asked Questions 


Why is Blender unresponsive during 
rendering? 


While a graphics card is rendering, it cannot redraw the user 
interface, which makes Blender unresponsive. We attempt 
to avoid this problem by giving back control over to the GPU 
as often as possible, but a completely smooth interaction 
cannot be guaranteed, especially on heavy scenes. This is a 
limitation of graphics cards for which no true solution exists, 
though we might be able to improve this somewhat in the 
future. 


If possible, it is best to install more than one GPU, using one 
for display and the other(s) for rendering. 


Why does a scene that renders on the 
CPU not render on the GPU? 


There may be multiple causes, but the most common one is 
that there is not enough memory on your graphics card. 
Typically, the GPU can only use the amount of memory that 
is on the GPU (see Would multiple GPUs increase available 
memory? for more information). This is usually much 
smaller than the amount of system memory the CPU can 
access. With CUDA, Optix, HIP and Metal devices, if the GPU 
memory is full Blender will automatically try to use system 
memory. This has a performance impact, but will usually still 
result in a faster render than using CPU rendering. 


Can multiple GPUs be used for 
rendering? 


Yes, go to Preferences » System >» Compute Device Panel, 
and configure it as you desire. 


Would multiple GPUs increase available 
memory? 


Typically, no, each GPU can only access its own memory, 
however, some GPUs can share their memory. This is can be 
enabled with Distributed Memory Across Devices. 


What renders faster? 


This varies depending on the hardware used. Different 
technologies also have different compute times depending 
on the scene tested. For the most up to date information on 
the performance of different devices, browse the Blender 
Open Data resource. 


Error Messages 


In case of problems, be sure to install the official graphics 
drivers from the GPU manufacturers website, or through the 
package manager on Linux. 


Unsupported GNU version 


On Linux, depending on your GCC version you might get this 
error. See the Nvidia CUDA Installation Guide for Linux for a 
list of Supported GCC versions. There are two possible 
solutions to this error: 


Use an alternate compiler 
If you have an older GCC installed that is compatible with 
the installed CUDA toolkit version, then you can use it 
instead of the default compiler. This is done by setting 


the CYCLES CUDA EXTRA CFLAGS environment variable when 
starting Blender. 


Launch Blender from the command line as follows: 
CYCLES CUDA EXTRA CFLAGS="-ccbin gcc-x.x" blender 


(Substitute the name or path of the compatible GCC 
compiler). 


Remove compatibility checks 
If the above is unsuccessful, delete the following line in 
/usr/local/cuda/include/host_config.h: 


#error -- unsupported GNU version! gcc x.x and up are not 
Supported! 


This will allow Cycles to successfully compile the CUDA 
rendering kernel the first time it attempts to use your 
GPU for rendering. Once the kernel is built successfully, 
you can launch Blender as you normally would and the 
CUDA kernel will still be used for rendering. 


CUDA Error: Kernel compilation failed 


This error may happen if you have a new Nvidia graphics 
card that is not yet supported by the Blender version and 
CUDA toolkit you have installed. In this case Blender may 
try to dynamically build a kernel for your graphics card and 
fail. 


In this case you can: 


1. Check if the latest Blender version (official or 
experimental builds) supports your graphics card. 

2. If you build Blender yourself, try to download and install 
a newer CUDA developer toolkit. 


Normally users do not need to install the CUDA toolkit as 
Blender comes with precompiled kernels. 


Error: Out of memory 


This usually means there is not enough memory to store the 
scene for use by the GPU. 


Note 


One way to reduce memory usage is by using smaller 
resolution textures. For example, 8k, 4k, 2k, and 1k image 
textures take up respectively 256MB, 64MB, 16MB and 
4MB of memory. 


The Nvidia OpenGL driver lost connection 
with the display driver 


If a GPU is used for both display and rendering, Windows 
has a limit on the time the GPU can do render computations. 
If you have a particularly heavy scene, Cycles can take up 
too much GPU time. Reducing Tile Size in the Performance 
panel may alleviate the issue, but the only real solution is to 
use separate graphics cards for display and rendering. 


Another solution can be to increase the time-out, although 
this will make the user interface less responsive when 
rendering heavy scenes. Learn More Here. 


CUDA error: Unknown error in 
cuCtxSynchronize() 


An unknown error can have many causes, but one possibility 
is that it is a time-out. See the above answer for solutions. 


Experimental Features 


Reference 


Panel: Render 


Experimental features are disabled / hidden by default, but 
can be enabled by setting Feature Set to Experimental in 
the Render properties. Enabling the Experimental Feature 
Set will use experimental and incomplete features that 
might be broken or change in the future. 


Adaptive subdivision is currently the only experimental 
feature. 


Render Baking 


Cycles shaders and lighting can be baked to image textures. 
This has a few different purposes, most commonly: 


e Baking textures like base color or normal maps for 
export to game engines. 

e Baking ambient occlusion or procedural textures, as a 
base for texture painting or further edits. 

e Creating light maps to provide global illumination or 
speed up rendering in games. 


Setup 


Baking requires a mesh to have a UV map, and either a 
Color Attribute or an Image Texture node with an image to 
be baked to. The Active Image Texture node or Color 
Attribute is used as the baking target. 


Use Render Bake in intensive light/shadow solutions, such 
as AO or soft shadows from area lights. If you bake AO for 
the main objects, you will not have to enable it for the full 
render, saving render time. Cycles uses the render settings 
(samples, bounces, ...) for baking. This way the quality of 
the baked textures should match the result you get from the 
rendered scene. 


Settings 


Reference 


Panel: Render > Bake 


Bake 


Perform the baking operation. 


Bake from Multires 


Bake directly from multires object. 


Bake Type 


Type of pass to bake. 


Combined: 


Bakes all materials, textures, and 
lighting except specularity. The passes 
that contribute to the combined pass 
can be toggled individually to form the 
final map. 


Ambient Occlusion: 


Shadow: 
Normal: 
UV: 


Roughness: 


Emit: 


Environment: 


Bakes ambient occlusion as specified in 
the World panels. Ignores all lights in 
the scene. 

Bakes shadows and lighting. 

Bakes normals to an RGB image. 
Mapped UV coordinates, used to 
represent where on a mesh a texture 
gets mapped too. This is represented 
through the red and green channels of 
the image, the blue channel is encoded 
with a constant value of 1 but does not 
hold any information. 

Bakes the roughness pass of a 
material. 

Bakes Emission, or the Glow color of a 
material. 

Bakes the environment (i.e. the world 
surface shader defined for the scene) 
onto the selected object(s) as seen by 
rays cast from the world origin. 


Diffuse: Bakes the diffuse pass of a material. 


Glossy: Bakes the glossiness pass of a material. 
Transmission: Bakes the transmission pass of a 
material. 
View From 


Source of reflection ray directions. 


Above Surface: 
Cast rays from above the surface. 
Active Camera: 
Use the active camera’s position to 
cast rays. 


Influence 


Combined 


Lighting 
Direct 
Add direct lighting contribution. 


Indirect 
Add indirect lighting contribution. 


Contributions 
Diffuse 
Add diffuse contribution. 


Glossy 
Add glossy contribution. 


Transmission 
Add transmission contribution. 


Ambient Occlusion 


Add ambient occlusion contribution. 
Emit 
Add emission contribution. 


Diffuse, Glossy, Transmission 


Contributions 
Direct 
See above. 


Indirect 
See above. 


Color 
Colorize the pass. 


e If only Color is selected you get the pass color, 
which is a property of the surface and 
independent of sampling refinement. 

e If Color is not selected, you get the direct and/or 
indirect contributions in gray-scale. 

e If Color and either Direct or Indirect are selected, 
you get the direct and/or indirect contributions 
colored. 


Normal 


Space 
Normals can be baked in different spaces: 


For materials, the same spaces can be chosen in the 

image texture options next to the existing Normal Map 
setting. For correct results, the setting here should match 
the setting used for baking. 


Object: Normals in object coordinates, 
independent of object transformation, 
but dependent on deformation. 

Tangent: Normals in tangent space coordinates, 
independent of object transformation 
and deformation. This is the default, 
and the right choice in most cases, 
since then the normal map can be used 
for animated objects too. 


Swizzle R, G, B 
Axis to bake into the red, green and blue channel. 


Selected to Active 


Bake shading on the surface of selected objects to the 
active object. The rays are cast from the low-poly object 
inwards towards the high-poly object. If the high-poly object 
is not entirely involved by the low-poly object, you can 
tweak the rays start point with Max Ray Distance or 
Extrusion (depending on whether or not you are using 
cage). For even more control you can use a Cage Object. 


Note 


There is a CPU fixed memory footprint for every object 
used to bake from. In order to avoid crashes due to lack of 
memory, the high-poly objects can be joined before the 
baking process. 


Cage 
Cast rays to active object from a cage. A cage isa 
ballooned-out version of the low-poly mesh created 
either automatically (by adjusting the ray distance) or 


manually (by specifying an object to use). When not 
using a cage the rays will conform to the mesh normals. 
This produces glitches on the edges, but it is a preferable 
method when baking into planes to avoid the need of 
adding extra loops around the edges. 


Cage Object 


Object to use as cage instead of calculating the cage 
from the active object with the Cage Extrusion. 


Cage Extrusion 


Distance to use for the inward ray cast when using 
Selected to Active and Cage. The inward rays are casted 
from a version of the active object with disabled Edge 
Split Modifiers. Hard splits (e.g. when the Edge Split 
Modifier is applied) should be avoided because they will 
lead to non-smooth normals around the edges. 


Note 


When the base mesh extruded does not give good 
results, you can create a copy of the base mesh and 
modify it to use as a Cage. Both meshes need to have 
the same Topology (number of faces and face order). 


Max Ray Distance 


Distance to use for the inward ray cast when using 


Selected to Active. Ray distance is only available when 
not using Cage. 


Output 


Target 
Where to output the baked map. 


Image Textures: 
Bake to the image data-block 


associated with the Active Image 
Texture node. 
Clear Image 

If selected, clears the image before 


baking render. 


Color Attributes: 
Bake to the Active Color Attributes 
layer on the active mesh. Note, the 
active object must be a mesh as other 
object types do not have Color 
Attributes. 


Margin 


When baking to images, by default a margin is generated 
around UV “islands”. This is important to avoid 
discontinuities at UV seams, due to texture filtering and 


mipmapping. 


Type 
Method to generate the margin. 


Extend: Extend border pixels outwards. 


Adjacent Faces: 
Fill margin using pixels from adjacent 


faces across UV seams. 


Size 
Size of the margin in pixels. 


Optimizing Renders 


e Reducing_Noise 
Path Tracing 
The Source of the Noise 
Bounces 
Caustics and Filter Glossy 
Light Falloff 
Multiple Importance Sampling 
Glass and Transparent Shadows 
Light Portals 
Denoising 
Clamp Fireflies 
e Shader Nodes 

o Node Optimizations 

o Run-Time Optimizations 
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Reducing Noise 


When performing a final render, it is important to reduce 
noise as much as possible. Here we will discuss a number of 
tricks that, while breaking the laws of physics, are 
particularly important when rendering animations within a 
reasonable time. Click to enlarge the example images to see 
the noise differences well. 


Path Tracing 


Cycles uses path tracing with next event estimation, which 
is not good at rendering all types of light effects, like 
caustics, but has the advantage of being able to render 
more detailed and larger scenes compared to some other 
rendering algorithms. This is because we do not need to 
store, for example, a photon map in memory, and because 
we can keep rays relatively coherent to use an on-demand 
image cache, compared to e.g. bidirectional path tracing. 


We do the inverse of what reality does, tracing light rays 
from the camera into the scene and onto lights, rather than 
from the light sources into the scene and then into the 
camera. This has the advantage that we do not waste light 


rays that will not end up in the camera, but also means that 
it is difficult to find some light paths that may contribute a 
lot. Light rays will be sent either according to the surface 
BRDF, or in the direction of known light sources. 


See also 


For more details, see the Light Paths and Sampling 
documentation. 


The Source of the Noise 


To understand where noise can come from, take for example 
the scene below. When we trace a light ray into the location 
marked by the white circle on a red dot, the second image 
below gives an impression of what the diffuse shader 
“sees”. 


To find the light that is reflected from this surface, we need 
to find the average color from all these pixels. Note the 
glossy highlight on the sphere, and the bright spot the light 
casts on the nearby wall. These hotspots are much brighter 
than other parts of the image and will contribute 
significantly to the lighting of this pixel. 


The scene. Irradiance The 
at the detected 


shading highlights. 
point. 


The light is a known light source, so its location is already 
known, but the glossy highlight(s) that it causes area 
different matter. The best we can do with path tracing is to 
distribute light rays randomly over the hemisphere, hoping 
to find all the important bright spots. If for some pixels we 
miss some bright spot, but we do find it for another, that 
results in noise. The more samples we take, the higher the 
probability that we cover all the important sources of light. 


With some tricks we can reduce this noise. If we blur the 
bright spots, they become bigger and less intense, making 
them easier to find and less noisy. This will not give the 
Same exact result, but often it’s close enough when viewed 
through a diffuse or soft glossy reflection. Below is an 
example of using Glossy Filter and Light Falloff. 


Using 


Glossy ee The 

Filter & shading detected 
Light ' highlights. 
Falloff. pom: 


Bounces 


In reality light will bounce a huge number of times due to 
the speed of light being very high. In practice more bounces 
will introduce more noise, and it might be good to use 
something like the Limited Global Illumination preset in the 
Light Paths Section that uses fewer bounces for different 
shader types. Diffuse surfaces typically can get away with 
fewer bounces, while glossy surfaces need a few more, and 
transmission shaders such as glass usually need the most. 


No Two Four 
bounces bounces at 
bounces. 
at Max. max. 


Also important is to use shader colors that do not have 
components of value 1.0 or values near that; try to keep the 
maximum value to 0.8 or less and make your lights brighter. 
In reality, surfaces are rarely perfectly reflecting all light, 
but there are of course exceptions; usually glass will let 
most light through, which is why we need more bounces 
there. High values for the color components tend to 
introduce noise because light intensity then does not 
decrease much as it bounces off each surface. 


Caustics and Filter Glossy 


Caustics are a well-known source of noise, causing Fireflies. 
They happen because the renderer has difficulty finding 


specular highlights viewed through a soft glossy or diffuse 
reflection. There is a No Caustics option to disable glossy 
behind a diffuse reflection entirely. Many renderers will 
typically disable caustics by default. 


Filter 
Default Caustics Glossy 
settings. disabled. greater 

than zero. 


However, using No Caustics will result in missing light, and it 
still does not cover the case where a sharp glossy reflection 
is viewed through a soft glossy reflection. There is a Filter 
Glossy option to reduce the noise from such cases at the 
cost of accuracy. This will blur the sharp glossy reflection to 
make it easier to find, by increasing the shader Roughness. 


The above images show default settings, no caustics, and 
filter glossy set to 1.0. 


Light Falloff 


In reality light in a vacuum will always fall off at a rate of 
1/(distance*2). However, as distance goes to zero, this 
value goes to infinity and we can get very bright spots in 
the image. These are mostly a problem for indirect lighting, 
where the probability of hitting such a small but extremely 


bright spot is low and so happens only rarely. This is a 
typical recipe for Fireflies. 


Hard Falloff. Soft Falloff. 


To reduce this problem, the Light Falloff node has a Smooth 
factor, that can be used to reduce the maximum intensity a 
light can contribute to nearby surfaces. The images above 
show default falloff and smooth value 1.0. 


Multiple Importance Sampling 


Materials with emission shaders can be configured to use 
Multiple Importance Sampling (Material Settings). This 
means that they will get rays sent directly towards them, 
rather than ending up there based on rays randomly 
bouncing around. For very bright mesh light sources, this 
can reduce noise significantly. However, when the emission 
is not particularly bright, this will take samples away from 
other brighter light sources for which it is important to find 
them this way. 


The optimal setting here is difficult to guess; it may bea 
matter of trial and error, but often it is clear that a 
somewhat glowing object may be only contributing light 


locally, while a mesh light used as a light would need this 
option enabled. Here is an example where the emissive 
spheres contribute little to the lighting, and the image 
renders with slightly less noise by disabling Multiple 
Importance on them. 


Multiple Importance Multiple Importance 
off. on. 


The world background also has a Multiple Importance 
(Settings) option. This is mostly useful for environment 
maps that have small bright spots in them, rather than 
being smooth. This option will then, in a preprocess, 
determine the bright spots, and send light rays directly 
towards them. Again, enabling this option may take samples 
away from more important light sources if it is not needed. 


Glass and Transparent Shadows 


With caustics disabled, glass shadows may appear too dark, 
and with filter glossy the caustics might be too soft. We can 
make a glass shader that will use a Glass BSDF when viewed 
directly, and a Transparent BSDF when viewed indirectly. 
The Transparent BSDF can be used for transparent shadows 
to find light sources straight through surfaces, and will give 


properly-colored shadows, but without the caustics. The 
Light Path node is used to determine when to use which of 
the two shaders. 


© Light Path 


_—® Value 
Is Shadow Ray @—— _—® Value 


Is Reflection Ray @— eee 
¥ Glass BSDF 


Y Group Input Beckmann 
Color e———_ ® Color 

Roughness @—\——— —@ Roughness 
ioR e——_\—— 8 OR 


Normal 
¥ Transparent BSDF 
BSDF 


@ Color 


Optimized glass shader. 


Above we can see the node setup used for the glass 
transparency trick; on the left the render has dark shadows 


due to missing caustics, and on the right the render with the 
trick. 


Default Glass BSDF. Optimized Glass 
Shader. 


Light Portals 


When rendering a daylight indoor scene where most of the 
light is coming in through a window or door opening, it is 
difficult for the integrator to find its way to them. To fix this, 
use Light Portals. You then will need to modify its shape to 
match that of the opening that you are trying to fill. 


Denoising 


Even with all the settings described above there will always 
end up being some render noise no matter how many 
Samples you use. To fix this there is a post-processing 
technique to cleanup the final bit of noise. To use this enable 
Denoising in the Render tab of the Properties. 


Below is an example render by The Pixelary. 


Example render Example render 
before denoising. after denoising. 


Clamp Fireflies 


Ideally with all the previous tricks, Fireflies would be 
eliminated, but they could still happen. For that, the 
intensity that any individual light ray sample will contribute 
to a pixel can be clamped to a maximum value with the 
integrator Clamp setting. 


If set too low this can cause missing highlights in the image, 
which might be useful to preserve for camera effects such 
as bloom or glare. To mitigate this conundrum it’s often 
useful to clamp only indirect bounces, leaving highlights 
directly visible to the camera untouched. 


No Clamp (0). With Clamp set to 4. 


Shader Nodes 


Cycles applies a number of shader node optimizations both 
at compile time and run-time. By exploiting them it is 
possible to design complicated “Uber Shader” style node 
groups that incur minimal render time overhead for unused 
features. 


Node Optimizations 


As the first step in preparing a node shader for execution, 
Cycles expands all node groups, as if using the Ungroup 
tool, and discards UI only features like frames and reroute 
nodes. 


After that, it applies some obvious transformations, for 
example, it can (the list is not exhaustive): 


e Replace the following nodes with the constant result of 
their evaluation, if all their inputs are determined to be 
constant: 


RGB, Value, Mix RGB, Math, Vector Math, RGB to BW, 
Gamma, Bright Contrast, Invert, Separate/Combine 
RGB/XYZ/HSV, Blackbody, RGB Curves, Vector Curves, 
Color Ramps. 


e Detect Mix RGB, Math and Vector Math nodes that 
become no-op (without Clamp) or evaluate to 0 as a 
result of addition, subtraction, multiplication, division or 
dot/cross product with a known constant 0 or 1 input, 
and replace with the appropriate input link or constant 
result. 


Eliminate Mix RGB Mix (without Clamp) and Mix Shader 
nodes when Factor is known to be 0 or 1 by replacing 
with the appropriate input value or link. 


e Eliminate no-op Mix RGB (except Color Burn, Color 
Dodge, Lighten, or enabled Clamp), Invert, RGB Curves 
and Vector Curves nodes with known zero Factor. 


Eliminate Emission and Background shader nodes that 
do not emit any light, and Add Shader nodes with one or 
both input arguments missing. 


Eliminate Bump with constant Height input, using its 
Normal input or Geometry Normal instead. This is useful 
for implementing node group inputs that default to 
normal via routing through a no-op Bump before doing 
math. 


Replace Attribute nodes of the View Layer type with the 
evaluated attribute value (it is constant within the whole 
Render Layer). 


e Combine multiple copies of the same node with the 
Same inputs into only one instance. 


Finally, any nodes that end up not connected either directly 
or indirectly to the Output node are removed. 


Run-Time Optimizations 


When executing shaders, a special optimization is applied to 
Mix Shader nodes. If Factor evaluates to 0 or 1, any nodes 
that are only reachable via the unused branch of the mix 
are not evaluated. 


This can substantially reduce the performance cost of 
combining multiple materials in one shader with a Color 
Attribute, texture, or other input used as a switch. 


Open Shading Language 


If Open Shading Language is chosen as the rendering back 
end, node shaders are translated to OSL code and then 
compiled and executed by the OSL runtime. In the process it 
applies its own extensive set of optimizations, both at 
compile time and run-time. 


Open Shading Language can optimize out Script nodes if 
their outputs are unused or constant, even if their OSL 
shaders have side effects like debug tracing and message 
passing, which may be confusing. For that reason message 
passing with setmessage and getmessage Should generally not 
be used for passing information forward in the graph; 
explicitly passing information through sockets should be 
preferred. 


Workbench 


Introduction 
Grease Pencil 
Performance 
Lighting 

Color 

Options 
Viewport Display 
Sampling 


Introduction 


The Workbench Engine is a render engine optimized for fast 
rendering during modeling and animation preview. It is not 
intended to be a render engine that will render final images 
for a project. Its primary task is to display a scene in the 3D 
Viewport when it is being worked on. 


Note 


While its not intended to be used for final renders, the 
Workbench render engine can be selected as the Render 
Engine in the Render properties. 


By default the 3D Viewport uses Workbench to shade and 
light objects. Unlike other render engines such as Eevee or 
Cycles, the Workbench engine does not use shader nodes. 
Instead, shading settings can be tweaked in the 3D 
Viewport’s Shading popover or the render properties when 
doing final renders. 


Workbench supports assigning random colors to objects to 
make each visually distinct. Other coloring mechanisms also 
exist, including; materials, Color Attributes, and textures. 


Workbench also has an X-ray mode to see through objects, 
along with cavity and shadow shading to help display details 
in objects. Workbench supports several lighting mechanisms 
including studio lighting and MatCaps. 


The image below is an excellent example of the Workbench 
engine’s capabilities using random coloring and shadows to 
show the details of the model. 


Workbench example. 


Grease Pencil 


Reference 


Panel: Render > Grease Pencil 


This panel is comprised of settings to control the rendering 
of Grease Pencil Lines. 


Anti-Aliasing Threshold 
Threshold for the edge detection algorithm used to 
correct aliasing, higher values might over blur some part 
of the image. 


Performance 


Reference 


Panel: Properties » Render >» Performance 


High Quality Normals 
Uses higher precision normals and tangents which can 
improve visual quality for dense meshes with high 
frequency textures at the cost of memory. 


Lighting 


The Workbench engine does not use the lights of the scene. 
The lighting conditions that will be used can be set in the 
Lighting panel. 


Reference 


Panel: Properties >» Render » Lighting 


Flat: Do not calculate any lighting. The base 
color of the scene will be rendered. 


Studio: Use studio lights to light the objects. The 
studio lights can be configured in the 
preferences. Studio lights can follow the 
camera or be fixed. When fixed the angle 
of the lights can be adjusted. 

World Space Lighting 
Uses world space lighting so lights do 
not follow the view camera. 

Rotation 
The rotation of the studio lights on the 
Z axis. 


MatCap: Use a material capture to light the objects 
in the scene. MatCaps can be flipped 
horizontally by clicking the Flip MatCap 
button. 

Custom MatCaps can be loaded in the 
preferences. 


Color 


The colors that the Workbench uses to render objects can 
be changed. 


Reference 
Panel: Render >» Color 
Material: Use the color that can be set per material 
in the Viewport Display Material panel. 
Object: Use the color that can be set per object in 
the Viewport Display Object panel. 
Attribute: Display the active Color Attribute of an 
object. When an object has no active Color 
Attribute it will be rendered in the color 
set in the Viewport Display Object panel. 
Single: Render the whole scene using a single 
color. The color can be chosen. 
Random: A random color will be selected for every 
object in the scene. 
Texture: Display the active texture using the active 


UV mapping coordinates. When an object 
has no active texture the object will be 
rendered with the settings in the Viewport 
Display Material panel. 


Options 


Reference 


Menu: Properties » Render > Options panel. 


Backface Culling 
Use backface culling to hide backsides of faces. 


X-Ray 
Render the scene transparent. With the slider you can 
control how transparent the scene should appear. 


Shadow 
Renders a sharp shadow in the scene. 


Darkness 
Defines how dark the shadow should be rendered. 
This slider can be adjusted between 0 (shadow not 
visible) and 1 (shadow is black). 


Light Direction 
Controls the direction of the light source that casts the 
shadows. 


Shadow Shift 
Controls the Shadow termination angle. It can be used 
to limit self shadowing artifacts. 


Shadow Focus 
Controls the falloff near the edge of the shadow. 


Cavity 
Highlight ridges and valleys in the scene geometry. 


Type 
Method how to calculate the cavity. 


World: More precise but is slower to 
calculate. 
Screen: Fast but does not take the size of 
the ridges and valleys into account. 
Both: Both will use both methods. 
Ridge 


Control the visibility of ridges. 


Valley 
Control the visibility of valleys. 


Depth of Field 
Use the Depth of Field settings of the active camera in 
the viewport. Only visible when looking through the 
camera. 


The settings are located on Properties » Camera >» Depth 
of Field panel. 


Outline 
Render the outline of objects in the viewport. The color of 
the outline can be adjusted. 


Specular Highlighting 
Render specular highlights. 


Note 

Only available when Lighting is set to Studio lighting or 
when a MatCap has been selected that contains a 
specular pass. 


Viewport Display 


The Workbench engine does not work with shader trees. In 
various tabs of the Properties are Viewport Display panels 
where settings can be adjusted that the Workbench engine 
uses. 


Object 


The Viewport Display panel in the Object Properties has 
several settings that are used by the Workbench Engine. 


Reference 
Panel: Properties >» Object >» Viewport Display 
Shadow 


When the Shadow in the Options is enabled this object 
will cast a shadow. 


In Front 
When checked the object will be rendered in front of the 
other objects in the scene. 


Color 
The color to render the object in when object color needs 
to be rendered. The alpha channel can be used to render 
the object transparent. 


Material 


The Viewport Display panel in the Material Properties has 
several settings that are used by the Workbench Engine. 


Reference 


Panel: Properties » Material » Viewport Display 


Color 
The color when rendering the material. The alpha 
channel can be used to render the object transparent. 


Metallic 
Changes the amount of specular lighting. This is only 
available when Specular Lighting in the Options is 
enabled. 


Roughness 
Changes the amount of roughness for specular lighting. 
This is only available when Specular Lighting in the 
Options is enabled. 


World 


The Viewport Display panel in the World Properties has 
several settings that are used by the Workbench Engine. 


Reference 


Panel: Properties » World >» Viewport Display 


Color 
The color of the world background. This color will be 
rendered in the background of the scene. 


Sampling 


The quality of the renders can be adjusted by changing the 
Anti-Aliasing method. A different one can be selected for the 
3D Viewport, viewport rendering and for final rendering. 


The setting for the 3D Viewport is a user preference to 
specify the anti-aliasing method that runs best on the used 
system. The setting for viewport rendering and final 
rendering is saved per scene. 


Reference 


Panel: Render >» Sampling Preferences » 
Viewport 


No Anti-Aliasing 
With this option selected no anti-aliasing will be applied. 


Single Pass Anti-Aliasing 


Scene will be rendered with a post-process anti-aliasing 
pass. 


Multisample 


The scene will be rendered multiple times with a slight 
offset. The anti-aliasing will be gathered from the 
multiple renders. The number of samples are predefined 
so it uses the best distribution of the samples. 


5, 8, 11, 16, 32 


Tip 


Multisample anti-aliasing is well suited for rendering 
small details like hair. 


Progressive Viewport Rendering 


For the 3D Viewport, one sample is rendered at a time. 
When there are no changes to the scene or viewport the 
next sample will be rendered. 


Cameras 


A camera is an object that provides a means of rendering 
images from Blender. It defines which portion of a scene is 
visible in the rendered image. 


Cameras are invisible in renders, so they do not have any 
material or texture settings. However, they do have Object 
and Editing setting panels available which are displayed 
when a camera is the active object. 


See also 


3D Viewport Camera Navigation for documentation about 
managing cameras in the viewport. 


Properties 

Reference 

Mode: Object Mode 
Editor: Properties » Camera 
Lens 

Type 


The camera lens options control the way 3D objects are 
represented in a 2D image. 


Perspective 


This matches how you view things in the real world. 
Objects in the distance will appear smaller than objects 
in the foreground, and parallel lines (such as the rails on 
a railroad) will appear to converge as they get farther 
away. 


Focal Length/Field of View 


The Focal Length controls the amount of zoom, i.e. the 
amount of the scene which is visible all at once. 


“ : Perspective 


Perspective camera with 210 
camera with 35 mm focal length 
mm focal length. instead of 35 
mm. 
Lens Unit 


The focal length can be set either in terms of 
millimeters or the actual Field of View as an angle. 


Visible 


@ FOV Angle 
x & 
awa 


Hint 

While the camera is moving towards an object the 
Focal Length property can be decreased to produce 
a Dolly Zoom camera effect, or vice versa. 


This video demonstrates the Dolly Zoom camera 
effect. 


Orthographic 
With Orthographic perspective objects always appear at 
their actual size, regardless of distance. This means that 
parallel lines appear parallel, and do not converge like 
they do with Perspective. 


Render from the same camera angle as the 
previous examples, but with orthographic 
perspective. 


Orthographic Scale 
This controls the apparent size of objects projected on 
the image. 


Note that this is effectively the only setting which 
applies to orthographic perspective. Since parallel 
lines do not converge in orthographic mode (no 
vanishing points), the lens shift settings are 
equivalent to translating the camera in the 3D 
Viewport. 


Near Clip Far Clip 


Panoramic 


Panoramic cameras only work in Cycles. See the Cycles 
panoramic camera settings for more information. 


Shift 


Allows for the adjustment of vanishing points. Vanishing 
points refer to the positions to which parallel lines 
converge. In these render examples, the most obvious 
vanishing point is at the end of the railroad. 


> Rotation of the 


Horizontal lens camera object 
shift of 0.330. instead of a lens 
shift. 


Notice how the horizontal lines remain perfectly 
horizontal when using the lens shift, but do get skewed 
when rotating the camera object. 


Note 
Using lens shift is equivalent to rendering an image with 


Clip Start and End 
The interval in which objects are directly visible. Any 
objects outside this range still influence the image 
indirectly, as further light bounces are not clipped. 


Note 

For viewport rendering, setting clipping distances to 
limited values is important to ensure sufficient 
rasterization precision. Ray tracing renders do not suffer 
from this issue so much, and as such more extreme 
values can Safely be set. 


Tip 

When Limits in the Viewport Display panel is enabled, 
the clip bounds will be visible as two yellow connected 
dots on the camera’s line of sight. 


See also 
e 3D Viewport clipping 


Depth of Field 


Real-world cameras transmit light through a lens that bends 
and focuses it onto the sensor. Because of this, objects that 
are a certain distance away are in focus, but objects in front 
and behind that are blurred. 


Example of DOF bokeh effect. 


The area in focus is called the focal! point and can be set 
using either an exact value, or by using the distance 
between the camera and a chosen object: 


Focus Object 


Choose an object which will determine the focal point. 
Linking an object will deactivate the distance parameter. 


Focal Distance 
Sets the distance to the focal point when no Focus Object 
is specified. If Limits are enabled, a yellow cross is shown 
on the camera line of sight at this distance. 


Hint 
Hover the mouse over the Distance property and press 
E to use a Special Depth Picker. Then click on a point in 


the 3D Viewport to sample the distance from that point 
to the camera. 


Aperture 
F-Stop 


F-Stop ratio that defines the amount of blurring. Lower 
values give a strong depth of field effect. 


Blades 
Total number of polygonal blades used to alter the shape 
of the blurred objects in the render, and render preview. 
As with the viewport, the minimum amount of blades to 
enable the bokeh effect is 3, resulting in a triangular- 
Shaped blur. 


Rotation 
Rotate the polygonal blades along the facing axis, and 
will rotate in a clockwise, and counter-clockwise fashion. 


Ratio 
Change the amount of distortion to simulate the 
anamorphic bokeh effect. A setting of 1.0 shows no 
distortion, where a number below 1.0 will cause a 
horizontal distortion, and a higher number will cause a 
vertical distortion. 


Camera 


These settings adjusts properties that relate to a physical 
camera body. Several Presets can be chosen to match real- 
world cameras. 


Sensor Fit 
Adjusts how the camera’s sensor fits within the outputs 
dimension adjusting the angular field of view. 


Auto: Calculates a square sensor size based 
on the larger of the Resolution 
dimensions. 

Horizontal: Manually adjust the Width of the 


sensor, the Height is calculated based 
on the aspect ratio of the output’s 
Resolution. 

Vertical: 


Manually adjust the Height of the 
sensor, the Width is calculated based 
on the aspect ratio of the output’s 
Resolution. 


Size / Width, Height 
This setting is an alternative way to control the field of 
view, aS opposed to modifying the focal length. It is 
useful to match a camera in Blender to a physical 
camera and lens combination, e.g. for motion tracking. 


Safe Areas 


Safe areas are guides used to position elements to ensure 
that the most important parts of the content can be seen 
across all screens. 


Different screens have varying amounts of Overscan 
(especially older TV sets). That means that not all content 
will be visible to all viewers, since parts of the image 
Surrounding the edges are not shown. To work around this 
problem TV producers defined two areas where content is 
guaranteed to be shown: action safe and title safe. 


Modern LCD/plasma screens with purely digital signals have 
no Overscan, yet safe areas are still considered best 
practice and may be legally required for broadcast. 


In Blender, safe areas can be set from the Camera and 
Sequencer views. 


Red line: Action safe. Green line: Title safe. 


The Safe Areas can be customized by their outer margin, 
which is a percentage scale of the area between the center 
and the render size. Values are shared between the Video 
Sequence editor and camera view. 


Title Safe Margins X/Y 
Also known as Graphics Safe. Place all important 


information (graphics or text) inside this area to ensure it 
can be seen by the majority of viewers. 


Action Safe Margins X/Y 
Make sure any significant action or characters in the shot 
are inside this area. This zone also doubles as a sort of 
“margin” for the screen which can be used to keep 
elements from piling up against the edges. 


Tip 


Each country sets a legal standard for broadcasting. These 
include, among other things, specific values for safe areas. 
Blender defaults for safe areas follow the EBU (European 
Union) standard. Make sure you are using the correct 
values when working for broadcast to avoid any trouble. 


Center-Cut Safe Areas 


Center-cuts are a second set of safe areas to ensure content 
is seen correctly on screens with a different aspect ratio. Old 
TV sets receiving 16:9 or 21:9 video will cut off the sides. 
Position content inside the center-cut areas to make sure 
the most important elements of your composition can still 
be visible in these screens. 


Blender defaults show a 4:3 (Square) ratio inside 16:9 
(widescreen). 


Cyan line: action center safe. Blue line: title center 
Safe. 


Background Images 


A background picture in your camera can be very helpful in 
many situations: modeling is obviously one, but it is also 
useful when painting (e.g. you can have reference pictures 
of faces when painting textures directly on your model...), or 
animation (when using a video as background), etc. 


Background Source 
The source of the background image. 


Image: Use an external image, image 
sequence, video file or generated 
texture. 


Movie Clip: Use one of the Movie Clip data-blocks. 


Active Clip 
Display a Movie Clip from the 
scene’s Active Clip. 
Render Undistorted 
Display the background image using 
undistorted proxies when available. 
Proxy Render Size 
Select between full (non-proxy) 


display or a proxy size to draw the 
background image. 


See also 
To build a proxy, the Movie Clip 
Editor Proxy settings have to be 
used. Otherwise the proxy settings 
here have no effect. 
Color Space 
The color space the image or video file uses within 
Blender. 
Opacity 
Controls the transparency of the background image. 
Depth 
Choose whether the image is shown behind all objects, or 
in front of everything. 
Frame Method 
Controls how the image is placed in the camera view. 


Stretch: Forces the image dimensions to match 
the camera bounds (may alter the 


aspect ratio). 
Fit: 


Scales the image down to fit inside the 
camera view without altering the 
aspect ratio. 

Crop: Scales the image up so that it fills the 
entire camera view, but without 
altering the aspect ratio (some of the 
image will be cropped). 


Offset X, Y 
Positions the background image using these offsets. 


In orthographic views, this is measured in the normal 
scene units. In the camera view, this is measured relative 
to the camera bounds (0.1 will offset it by 10% of the 
view width/height). 


Rotation 
Rotates the image around its center. 


Scale 
Scales the image up or down from its center. 


Flip 
X 
Swaps the image around, such that the left side is now 
on the right, and the right now on the left. 
Y 


Swaps the image around, such that the top side is 
now on the bottom, and the bottom now on the top. 


Viewport Display 


Camera view displaying safe areas, sensor and 
name. 


Size 
Size of the camera visualization in the 3D Viewport. This 
setting has no effect on the render output of a camera. 
The camera visualization can also be scaled using the 
standard Scale s transform key. 


Show 
Limits 
Shows a line which indicates Start and End Clipping 
values. 


Mist 
Toggles viewing of the mist limits on and off. The limits 
are shown as two connected white dots on the camera 
line of sight. The mist limits and other options are set 
in the World panel, in the Mist section. 


Sensor 
Displays a dotted frame in camera view. 


Name 
Toggle name display on and off in camera view. 


Composition Guides 


Composition Guides enable overlays onto the camera 
display that can help when framing a shot. 


Thirds 
Adds lines dividing the frame in thirds vertically and 
horizontally. 


Center 
Center 
Adds lines dividing the frame in half vertically and 
horizontally. 


Diagonal 
Adds lines connecting opposite corners. 


Golden 
Ratio 
Divides the width and height into Golden proportions 
(about 0.618 of the size from all sides of the frame). 


Triangle A 
Displays a diagonal line from the lower left to upper 
right corners, then adds perpendicular lines that pass 
through the top left and bottom right corners. 


Triangle B 
Same as A, but with the opposite corners. 


Harmony 
Triangle A 
Displays a diagonal line from the lower left to upper 
right corners, then lines from the top left and bottom 
right corners to 0.618 the lengths of the opposite side. 


Triangle B 
Same as A, but with the opposite corners. 


Passepartout 
This option darkens the area outside of the camera’s field 
of view. The opacity of the passepartout can be adjusted 
using the value slider. 
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Light Objects 


Reference 


Panel: Properties >» Light and Shader Editor > 
Sidebar > Settings 


Common Settings 


Type 
Defines the type of light. 


Color 
Color tint of the emitted light. 


Renderer Settings 


e Eevee specific settings 
e Cycles specific settings 


Point Light 


The point light is an omni-directional point of light, that is, a 
point radiating the same amount of light in all directions. It’s 
visualized by a plain, circled dot. Being a point light source, 
the direction of the light hitting an object’s surface is 
determined by the line joining the light and the point on the 
surface of the object itself. It can be used as simple model of 
e.g. a light bulb. 


Light intensity/energy decays 
based on (among other 
variables) distance from the 
point light to the object. In other 
words, surfaces that are further 
away will be rendered darker. 


Power 
Power of the light in Watts. 
Higher values increase the 
intensity of the light. 
Negative values can be set, 
but should be avoided for 
predictable and physically ke 
based result. Point light. 


Radius 
When larger than zero, light will be emitted from a 
spherical surfaces with the specified radius. Lights with 
larger size have softer shadows and specular highlights, 
and they will also appear dimmer because their power is 
distributed over a larger area. 


Spot Light 


A spot light emits a cone-shaped beam of light from the tip 
of the cone, in a given direction. 


Power 
Power of the light in Watts. Higher values increase the 
intensity of the light. Negative values can be set, but 
should be avoided for predictable and physically based 
result. 


Radius 


When larger than zero, light will be emitted from a 
spherical surfaces with the specified radius. Lights with 
larger size have softer shadows and specular highlights. 


Beam/Spot Shape 


Clip Start 


Clip End 


Changing the spot options also changes the 
appearance of the spotlight as displayed in the 3D 


Viewport. 
Size 
The size of the outer cone of a spot, which largely 
controls the circular area a spot light covers. This slider 


in fact controls the angle at the top of the lighting cone, 
and can be between (1.0 to 180.0). 


Changing the spot Size option. 


Blend 
The Blend slider controls the inner cone of the spot. The 
Blend value can be between (0.0 to 1.0). The value is 
proportional and represents that amount of space that 
the inner cone should occupy inside the outer cone Size. 


The inner cone boundary line indicates the point at which 
light from the spot will start to blur/soften; before this 
point its light will mostly be full strength. The larger the 
value of Blend the more blurred/soft the edges of the 
spotlight will be, and the smaller the inner cone’s circular 
area will be (as it starts to blur/soften earlier). 


To make the spot have a sharper falloff rate and 
therefore less blurred/soft edges, decrease the value of 
Blend. Setting Blend to 0.0 results in very sharp spotlight 
edges, without any transition between light and shadow. 


The falloff rate of the spot light is a ratio between the 
Blend and Size values; the larger the circular gap 
between the two, the more gradual the light fades 
between Blend and Size. 


Blend and Size only control the spot light cone’s aperture 
and softness (“radial” falloff); they do not control the 
Shadow’s softness as shown below. 


Spotlight Soft Edge 


Object Hard Shadow 


Render showing the soft edge spotlighted area 
and the sharp/hard object shadow. 


Notice in the picture above that the object’s shadow is 
Sharp as a result of the ray tracing, whereas the spotlight 
edges are soft. If you want other items to cast soft 
shadows within the spot area, you will need to alter other 
shadow settings. 


Show Cone 
Displays a transparent cone in 3D Viewport to visualize 
which objects are contained in it. 


Area Light 


The area light simulates light originating from a surface (or 
Surface-like) emitter. For example, a TV screen, office neon 
lights, a window, or a cloudy sky are just a few types of area 
light. The area light produces shadows with soft borders by 
sampling a light along a grid the size of which is defined by 
the user. This is in direct contrast to point-like artificial lights 
which produce sharp borders. 


Power 


Power of the light in Watts. Higher values increase the 
intensity of the light. Negative values can be set, but 
should be avoided for predictable and physically based 
result. 


Shape 
Shape of the light. 


Rectangle 
The shape of the light can be represented as a 
rectangle and changed with the “X” and “Y” values. 


Square 


The shape of the light can be represented as a square 
and changed with the Size property. 


Disk 
The shape of the light can be represented as a disk 
and changed with the Size property. 


Ellipse 
The shape of the light can be represented as an 
ellipse and changed with the X and Y values. 


Tip 

Choosing the appropriate shape for your area light will 
enhance the believability of your scene. For example, 
you may have an indoor scene and would like to 
simulate light entering through a window. You could 
place a Rectangular area light in a window (vertical) or 
from neons (horizontal) with proper ratio for Size X and 
Size Y. For the simulation of the light emitted by a TV 


screen, a vertical Square area light would be better in 
most cases. 


Size / Size X / Size Y 
Dimensions for the Square or Rectangle. 


Sun Light 


A sun light provides light of constant intensity emitted ina 
single direction from infinitely far away. It can be very handy 
for a uniform clear daylight open-space illumination. In the 
3D Viewport, the sun light is represented by an encircled 
black dot with rays emitting from it, plus a dashed line 
indicating the direction of the light. 


Note 


This direction can be changed by rotating the sun light, like 
any other object, but because the light is emitted from a 
location considered infinitely far away, the location of a 
sun light does not affect the rendered result. 


Strength 
Strength of the lights in Watts per square meter. Typical 
values are around 250 for an overcast day and 1000 or 
more for direct sunlight. See more details at Power of 
Lights. 


Angle 


The size of the sun light according to its angular diameter 
as seen from earth. 


Power of Lights 


The power of sun lights is specified in Watts per square 
meter. The power of point lights, spot lights, and area lights 


is specified in Watts. But this is not the electrical Watts that 
consumer light bulbs are rated at. It is Radiant Flux or 
Radiant Power which is also measured in Watts. It is the 
energy radiated from the light in the form of visible light. 


If you want to set the power to real world values, you have 


radiant flux, but it is not a straightforward process. The 
wattage of bulbs means the electrical power required to 
power them. LED lights have a “Watt equivalent” which is 
neither the electrical power they require nor the amount of 
light they put out. Some consumer lights specify lumens or 
luminous flux which is the radiant flux weighted with the 
wavelengths perceived by the human eye. 


To save you from doing the conversion, here is a table of 
typical power values for point, spot, and area lights: 


Suggested Light 


Real world light Power Type 
Candle 0.05 W_ Point 
800 Im LED bulb 2.1W Point 
1000 Im light bulb 2.9 W Point 


1500 Im PAR38 floodlight 4 W Area, Disk 


2500 Im fluorescent tube 4.5 W Area, Rectangle 


Suggested Light 


Real world light Power T 
ype 


5000 Im car headlight 22 W Spot, size 125 degrees 


And a table of typical Strength values for sun lights: 


Sun type Strength 
Clear sky 1000 W/m? 
Cloudy sky 500 W/m2 
Overcast sky 200 W/m? 
Moonlight 0.001 W/m2 


These values will likely produce much brighter or dimmer 
lights than you would expect, because our eyes adapt while 
a render engine does not. So to compensate, adjust the 
Exposure in Render » Film. 


To get realistic results, remember to also set the light size 
and color to realistic values. The color of your lights will also 
influence how bright they appear to the human visual 
system. If you leave the power unchanged, a green light will 
seem the brightest, red darker and blue the darkest. Thus 


you might want to manually compensate for these 
perceived differences. 


World Environment 


The world defines the 
environment that the scene 
is in. The surface shader sets 
the background and 
environment lighting, either 
as a fixed color, sky model or 
HDRI texture. With volume 
shaders the entire scene can 
be covered in mist or other 
volumetric effects. 


Lighting with an HDR image. 


Surface 


Reference 


Panel: World > Surface 


The surface shader defines the light emission from the 
environment into the scene. The world surface is rendered 
as if it is very distant from the scene, and as such there is 
no two-way interacting between objects in the scene and 
the environment, only light coming in. The only shader 
accepted is the Background node with a color input and 
strength factor for the intensity of the light. 


Image Based Lighting 


For image based lighting, use the Environment Texture node 
rather than the Image Texture node for correct mapping. 


This supports Equirectangular (also Known as 
latitude/longitude) for environment maps, and Mirror Ball 
mapping for converting photos of mirror balls to 
environment maps. 


Volume 


Reference 


Panel: World >» Volume 


A volume shader can be applied to the entirely world, filling 
the entire space. 


Currently this is most useful for night time or other dark 
scenes, as the world surface shader or sun lights will have 
no effect if a volume shader is used. This is because the 
world background is assumed to be infinitely far away, 
which is accurate enough for the sun for example. However, 
for modeling effects such as fog or atmospheric scattering, 
it is not a good assumption that the volume fills the entire 
Space, as most of the distance between the sun and the 
earth is empty space. For such effects it is be better to 
create a volume object surrounding the scene. The size of 
this object will determine how much light is scattered or 
absorbed. 


Viewport Display 


Reference 


Panel: World > Viewport Display 


Color 
The color to render the 3D Viewport background when 
choosing World Background. 
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Introduction 


Materials control the appearance of meshes, curves, 
volumes and other objects. They define the substance that 
the object is made of, its color and texture, and how light 
interacts with it. 


Physically based materials can be created using the 
Principled BSDF, Principled Hair, and Principled Volume 
Shaders. With these uber shaders, a wide variety of 
materials including plastic, glass, metal, cloth, skin, hair, 
smoke and fire can be created. 


A flexible shading_nodes system is used to set up textures 
and create entirely different types of materials like toon 
shading. 


Setting up Materials 


Materials can be created in either the Material properties, or 
in the Shader Editor. These provide a different view of the 
Same shader nodes and material settings. 


The default Shading workspace has a Shader Editor and a 
3D Viewport that can be set to Material Preview or Rendered 
shading, to interactively preview how the material interacts 
with objects and lights in the scene. 


Materials are data-blocks that can be assigned to one or 
more objects, and different materials can be assigned to 
different parts of meshes. 


Image textures can be created from scratch in Texture Paint 
Mode, or by loading in existing images with the Image 
Texture node. A variety of procedural texture nodes is also 
available. 


Components 


Materials consist of three shaders, defining the appearance 
of the surface, the volume inside the object, and the 
displacement of the surface. 


Surface Volume Displacement 


Surface Shader 


The surface shader controls the textures and light 
interaction at the surface of the mesh. 


Volume Shader 


The volume shader defines the interior of the mesh. A 
material can have just a volume shader for cases like smoke 
and fire, or it can be combined with a surface shader for 
materials like cloudy glass. 


Displacement 


The shape of the surface and the volume inside it may be 
altered by displacement. This way, textures can then be 
used to make the mesh surface more detailed. 


Depending on the settings, the displacement may be virtual, 
only modifying the surface normals to give the impression of 
displacement, which is known as bump mapping, or a 
combination of real and virtual displacement. 


Physically Based Shading 


The material system is built with physically-based rendering 
in mind, separating how a material looks and which 
rendering algorithm is used to render it. This makes it easier 
to achieve realistic results and balanced lighting, though 
there are a few things to keep in mind. 


In order for materials to work well with global illumination, 
they should be energy conserving. That means they cannot 
reflect more light than comes in. This property is not strictly 


are only mixed together with the Mix Shader node, this will 
automatically be true. 


It is however, possible to break this, with color values higher 
than 1.0 or using the Add Shader node, but one must be 
careful when doing this to keep materials behaving 
predictably under various lighting conditions. 


Components 


e Surfaces 

o Terminology 

o BSDF Parameters 
« Volumes 

o Shading 

o Mesh Volumes 

o World Volume 

o Multiple Scattering 
e Displacement 

Bump Only 


o Displacement Only 
o Displacement and Bump 


Surfaces 


The surface shader defines the light interaction at the 


light is reflected back, refracted into the mesh, or absorbed. 


Emission defines how light is emitted from the surface, 
allowing any surface to become a light source. 


Terminology 


BSDF 
Stands for Bidirectional Scattering Distribution Function. 
It defines how light is reflected and refracted ata 
surface. 


Reflection 
BSDFs reflect an incoming ray on the same side of the 
surface. 


Transmission 
BSDFs transmit an incoming ray through the surface, 
leaving on the other side. 


Refraction 
BSDFs are a type of Transmission, transmitting an 
incoming ray and changing its direction as it exits on the 
other side of the surface. 


BSDF Parameters 


A major difference from non-physically-based renderers is 
that direct light reflection from lights and indirect light 
reflection of other surfaces are not decoupled, but rather 


bit, but we believe overall it is helpful in creating consistent- 
looking renders with fewer parameters to tune. 


Roughness 


the sharpness of the reflection, from 0.0 (perfectly sharp) 
to 1.0 (very soft). 


Volumes 


Volume rendering is used to render various effects that 
cannot be represented by hard surfaces alone. 


e Smoke, fire or clouds are set up using a volume object 
or fluid simulation, with only a volume shader. 

e Meshes can also be used to create such shapes by 
removing the default surface shader and using a volume 
Shader with the mesh shape defining the volume 
bounds and textures defining the volume density. 

e Mist is created with a volume shader for the world, or 
with a large mesh object encompassing the scene. 

e Absorption in glass is simulated by combining a glass 
surface shader with refraction and a volume absorption 
Shader for the interior of the object. 


Shading 


Principled Volume 


Principled Volume is a physically-based volume shader that 
can be used to create a wide range of volume materials. It 
Supports scattering, absorption and emission in one easy to 
use node. Fire can be rendered with blackbody emission. 


Smoke and fire rendered with Principled Volume 
shader. 


Volume Components 


For more control, volume shading components can be 
manually combined into a custom shader setup. 


e Volume Absorption will absorb part of the light as it 
passes through the volume. This can be used to shade 
for example black smoke or colored glass objects, or 
mixed with the Volume Scatter node. This node is similar 
to the transparent BSDF node, it blocks part of the light 
and lets other light pass straight through. 

Volume Scatter lets light scatter in other directions as it 
hits particles in the volume. The anisotropy defines in 
which direction the light is more likely to scatter. A value 
of O will let light scatter evenly in all directions (similar 
to the diffuse BSDF node), negative values let light 
scatter mostly backwards, and positive values let light 
scatter mostly forward. This can be used to shade white 
smoke or clouds for example. 


e Emission will emit light from the volume, for example for 
fire. 


Volume Absorption, Scatter and Emission 


Attributes 


When rendering smoke and fire, volume attributes are used 
to define the shape and shading of the volume. The 
Principled Volume shader will use them by default, while 
custom volume shaders can use the Attribute node to get 
attributes such as density, color and temperature. 


Density 


All volume shaders have a density input. The density 
defines how much of the light will interact with the volume, 
getting absorbed or scattered, and how much will pass 
straight through. For effects such as smoke you would 
specify a density field to indicate where in the volume there 
is smoke and how much (density bigger than 0), and where 
there is no smoke (density equals 0). 


Volumes in the real world consist of particles, a higher 
density means there are more particles per unit volume. 
More particles means there is a higher chance for light to 


collide with a particle and get absorbed or scattered, rather 
than passing straight through. 


Mesh Volumes 


Meshes used for volume render should be closed and 
Manifold. That means that there should be no holes in the 
mesh. Each edge must be connected to exactly two faces 
such that there are no holes or T-shaped faces where three 
or more faces are connected to an edge. 


Normals must point outside for correct results. The normals 
are used to determine if a ray enters or exits a volume, and 
if they point in a wrong direction, or there is a hole in the 
mesh, then the renderer is unable to decide what is the 
inside or outside of the volume. 


These rules are the same as for rendering glass refraction 
correctly. 


World Volume 


A volume shader can also be applied to the world, filling the 
entire space. 


Currently, this is most useful for night time or other dark 
scenes, as the world surface shader or sun lights will have 
no effect if a volume shader is used. This is because the 
world background is assumed to be infinitely far away, 
which is accurate enough for the sun for example. However, 
for modeling effects such as fog or atmospheric scattering, 
it is not a good assumption that the volume fills the entire 
Space, as most of the distance between the sun and the 
earth is empty space. For such effects it is be better to 


create a volume object surrounding the scene. The size of 
this object will determine how much light is scattered or 
absorbed. 


Multiple Scattering 


Real-world effects such as scattering in clouds or subsurface 
scattering require many scattering bounces. However, 
unbiased rendering of such effects can be noisy, so by 
default the number of bounces is zero in Cycles, and no 
Support is available in Eevee. The effect you get when 
rendering with zero volume bounces is what is known as 
“single scattering”, the effect from more bounces is 
“multiple scattering”. 


For rendering materials like skin or milk that require multiple 
scattering, subsurface scattering is more efficient and easier 
to control. Particularly the random walk method can 
accurately render such materials. 


For materials such as clouds or smoke that do not have a 
well-defined surface, volume rendering is required. These 
look best with many scattering bounces, but in practice one 
might have to limit the number of bounces to keep render 
times acceptable. 


Displacement 


Reference 


Panel: Material >» Settings >» Displacement 


Detail can be added to the shape of a surface with 
displacement shaders. 


To create displacement, connect a Displacement or Vector 
Displacement node to the displacement input of the 
Material Output node. Procedural, painted or baked textures 


can then be connected to these nodes. 
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Typical displacement node setup. 


Three displacement methods exist, with varying accuracy, 
performance and memory usage. 


Bump only, displacement only and displacement 
and bump combined. 


Bump Only 


The least accurate but most memory efficient method is 
bump mapping. This method does not actually alter the 
mesh surface, but merely changes the shading to make it 
seem SO. 


Bump maps are often used to add smaller details ona 
model, for example pores or wrinkles on skin. 


For baked bump maps, 8-bit images are commonly used. 
However, 16 or 32-bit float maps can provide better looking 
results. When using image textures use Cubic interpolation 
to avoid stepping artifacts, these are more visible for bump 
maps than other types of textures. 


Important 


Because bump mapping is a fake effect, it can cause 
artifacts if the actual shape of the geometry is too different 
from the bump mapped shape. If this happens the strength 
of bump mapping should be reduced or actual 
displacement should be used. 


Displacement Only 


Cycles Only 


The most accurate and memory intensive displacement 
method is to apply true displacement to the mesh surface. 


It requires the mesh to be finely subdivided, which can be 
memory intensive. Adaptive Subdivision is the best way to 
subdivide the mesh, so that exactly the right amount of 
Subdivision is used depending on the distance of the object 
to the camera. 


For baked displacement maps, best results are achieved 
with 16 or 32-bit float maps, as 8-bit images often can not 
represent all the necessary detail. 


See also 


The Displace Modifier can also be used to displace a mesh. 


Displacement and Bump 


Cycles Only 


Both methods can be combined to use actual displacement 
for the bigger displacement and bump for the finer details. 
This can provide a good balance to reduce memory usage. 


Once you subdivide the mesh very finely, it is better to use 
only actual displacement. Keeping bump maps will then only 
increase memory usage and slow down renders. 


Assignment 


Reference 


Panel: Material >» Material Slots 


Materials are data-blocks that can be created and then 
assigned to one or more objects. An object can also have 
multiple materials assigned in different material slots, which 
correspond to different parts of an object. If a smooth 
transition between materials is desired, then mixing shader 
nodes with a Mix shader is a better solution. 


Material Slots 


Material slots link materials to objects and meshes. By 
default objects only have a single material slot, which 
assigns a material to the entire object. If different parts of 
the mesh need different materials, multiple material slots 
can be created. 


@ Material 


be 


@)~ Material 


Material slots panel. 


Slot List 


The object’s material slots and active material displayed in 
a List View. 


Add Material Slot 
Add a new material slot on the object. 


Remove Material Slot 
Remove a material slot from the object. 


Copy Material 
Copy material shader nodes and settings to clipboard. 


Paste Material 
Paste material shader nodes and settings from clipboard. 


Copy Material to Selected 
Copy the same material assignment from the active to 
other selected objects. 


Remove Unused Slots 
Removes all material slots not assigned to the object. 


Data-Block 


Material 
The Material Data-Block Menu for the selected material 
slot. Here new materials can be created, or existing 
materials can to the material slot. 


Link 
Specifies whether the material is to be linked to the 
object or to the object data. 


The Link selector has two choices, Data and Object. 
These two menu choices determine whether the material 
is linked to the object or to the data (e.g. a mesh or 


curve). The Data menu item determines that this 
material will be linked to the mesh’s data-block which is 
linked to the object’s data-block. The Object menu item 
determines that the material will be linked to the object’s 
data-block directly. 


This has consequences of course. For example, different 
objects may share the same mesh data-block. Since this 
data-block defines the shape of the object any change in 
Edit Mode will be reflected on all of those objects. 
Moreover, anything linked to that mesh data-block will be 
Shared by every object that shares that mesh. So, if the 
material is linked to the mesh, every object will share it. 


On the other hand, if the material is linked directly to the 
object data-block, the objects can have different 
materials and still share the same mesh. 


Short explanation: If connected to the object, you can 
have several instances of the same Object Data using 
different materials. If linked to mesh data, you cannot. 
See Data System for more information. 


Edit Mode 


To assign materials to different parts of a mesh, enter Edit 
Mode on the mesh. Additional buttons will then appear in 
the material slots panel. 


@ Material 


& 
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Assign Select Deselect 


Material slots panel in Edit Mode. 


Assign 
Assign active material slot and material to the selected 
faces in the mesh, strokes in a Grease Pencil, and similar 
for other object types. 


Select 
Select faces assigned to the active material slot. 


Deselect 
Deselect faces assigned to the active material slot. 


Reusing Existing Materials 


Blender is built to allow you to reuse anything, including 
material settings, between many objects. Instead of creating 
duplicate materials, you can simply reuse an existing 
material. There are several ways to do this using the 
Material’s data-block menu: 


Single Object - With the object selected, click the sphere 
located to the left of the Material name. A pop-up appears 
showing all the materials available in the current blend-file. 
To use one, just click on it. 


Tip 
Searching for Materials 


The search field at the bottom of the material list allows 
you to search the names in the list. For example, by 
entering “wood” all existent materials are filtered so that 
only materials containing “wood” are displayed in the list. 


Multiple Objects - In the 3D Viewport, with ctri-L you can 
quickly link all selected objects to the material (and other 
aspects) of the active object. Very useful if you need to set a 
large number of objects to the same material; just select all 
of them, then the object that has the desired material, and 
Ctri-L links them to that “parent”. 


Deleting a Material 


To delete a material, select the material and click X in the 
Available Materials List entry. 


Although the material will seem to disappear immediately, 
the Delete action can depend on how the material is used 
elsewhere. 


If the material is linked to the object and there are other 
objects which use this material, then the material will be 
removed from that object (but remain on all its other 
objects). 


If the “Fake User” button has been lit in the Available 
Materials list, then the material will be retained when the 
file is saved, even if it has no users. 


Only if it has 0 “real” users, and no “Fake” user, will the 
material be permanently deleted. Note that it will still 
remain in the Materials list until the blend-file is saved, but 
will have disappeared when the file is reloaded. 


Multiple Materials 


Normally, different colors or patterns on an object are 
achieved by adding textures to your materials. However, in 


some applications you can obtain multiple colors on an 
object by assigning different materials to the individual 
faces of the object. 


To apply several materials to different faces of the same 
object, you use the Material Slots options in the Materials 
header panel. 


The workflow for applying a second material to some faces 
of an object covered by a base material is as follows: 


1. In Object Mode, create a base material. 

2. Go into Edit Mode and Face Select (a new list will appear 
below the Active Material list with Assign, Select, 
Deselect buttons). 

3. Select the faces to be colored with the second material. 

4. In the Object Material Slots list, click the + button to 
create a new slot or select an existing material. 

5. Click the Assign button, and the material will appear on 
the selected object faces. 


Preview 


The Preview panel gives a quick visualization of the active 
material applied in a simple scene. 


Shape 
Preview the material on a Plane, Sphere, Cube, Hair, 
Shader Ball, Cloth or Fluid object. This shape is also used 
for previews when linking and appending materials. 


Preview World Cycles Only 
Use the world from the current scene for lighting in the 
material preview. 


Preview shapes. 


Settings 


Reference 


Panel: Material >» Settings 


Renderer Settings 


While shading nodes control the appearance, these settings 
control the quality and algorithms that each renderer uses 


to render the material. 


e Eevee specific settings 
e Cycles specific settings 


Pass Index 


Pass Index 
Index number for the Material Index render pass. This 


can be used to give a mask to a material and then be 
read with the |D Mask Node in the Compositor. 


Note 


Volume Objects are not supported. 


Viewport Display 


These settings control the 3D Viewport display in solid 
shading. They provide a faster alternative to full shader 
nodes, which may be too heavy or distracting for tasks like 
modeling, layout or sculpting. 


Color 
Diffuse or metal surface color. 


Metallic 
Blends between a non-metallic and metallic material 
model. A value of 1.0 gives a fully specular reflection 
tinted with the base color, without diffuse reflection or 
transmission. At 0.0 the material consists of a diffuse or 
transmissive base layer, with a specular reflection layer 
on top. 


Roughness 
Specifies microfacet roughness of the surface for metal 
and specular reflection. 


Line Art 


Reference 
Panel: Material > Line Art 
Material Mask ¥ Line Art 


Material masks are a 
way to provide Line 
Art extra information Masks O12345 67 * 
about faces that 
caused the occlusion. Line Art material properties. 
So edges occluded by 

those faces can be 

selected to have 

different styles. 


¥ Use Transparency . 


Masks 
The layer to include faces of the current material. 


Levels 
Faces with this material will behave as if it has set 
number of layers in occlusion. 


Intersection Priority 
Assigns an intersection priority value for this material. 
Note that this priority takes precedent over Object or 
Collection priority values. The intersection line will be 
included into the object with the higher intersection 
priority value. 


Legacy Textures 


Introduction 
Colors 


Types 


Blend 
Clouds 
Distorted Noise 


Introduction 


None 

Ba Blend 

EA Clouds 

| Distorted Noise 


la’ Image or Movie 


The Texture Type list in the Texture panel of the 
Texture buttons. (Non-procedural textures darkened 
out.) 


Procedural textures are textures that are defined 
mathematically. They are generally relatively simple to use, 
because they do not need to be mapped in a special way. 
This does not mean that procedural textures cannot become 
very complex. 


These types of textures are ‘real’ 3D. By that we mean that 
they fit together perfectly at the edges and continue to look 
like what they are meant to look like even when they are 
cut; as if a block of wood had really been cut in two. 
Procedural textures are not filtered or anti-aliased. This is 
hardly ever a problem: the user can easily keep the 
specified frequencies within acceptable limits. 


Common Options 


Noise Basis 


Each noise-based Blender texture (except Voronoi and 
Simple Noise) has a Noise Basis setting that allows the user 
to select which algorithm is used to generate the texture. 
This list includes the original Blender noise algorithm. The 
Noise Basis settings makes the procedural textures 
extremely flexible (especially Musgrave). 


The Noise Basis governs the structural appearance of the 
texture: 
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Perlin. F2. Crackle. 


Improved 
Perlin. 


Voronoi 
F4, 


There are two more possible settings for Noise Basis, which 


2. 
>, 
ee 


Voronoi 
F3. 


Cell Noise. 


are relatively similar to Blender Original: Improved Perlin 


and Original Perlin. 


Nabla 


Almost all procedural textures in Blender use derivatives for 
calculating normals for texture mapping (except Blend and 


Magic). This is important for Normal and Displacement 


Maps. The strength of the effect is controlled with the Nabla 


number field. 


Hints 


Procedural textures can either produce colored textures, 
intensity only textures, textures with alpha values and 
normal textures. If intensity only ones are used the result is 
a black-and-white texture, which can be greatly enhanced 
by the use of ramps. If on the other hand you use ramps 
and need an intensity value, you have to switch on No RGB 
in the Mapping panel. 


Colors 


The color of a texture can be modified with the Brightness, 
Contrast, and Saturation buttons. All textures with RGB 
values, including Images and Environment Maps, may be 
modified with the RGB sliders. 


Clamp 
Set negative texture RGB and intensity values to zero, for 
some uses like displacement this option can be disabled 
to get the full range. 


Multiply R, G, B 
Tint the color of a texture by brightening each red, green 
and blue channel. 


Brightness 
Change the overall brightness/intensity of the texture. 


Contrast 
Change the contrast of the texture. 


Saturation 
Change the saturation of the texture. 


Color Ramp 


Activates a color ramp which allows you to remap the colors 
of a texture to new ones. 


Blend 


The Blend texture generates a smoothly interpolated 
progression. This is one of the most frequently used 
procedural textures. You can use blend textures to blend 
other textures together (with Stenci/), or to create nice 
effects (especially with the Mapping: Normal trick). 


Note 


Remember that if you use a ramp to create a custom 
blending, you may have to use No RGB, if the Mapping 
value needs an intensity input. 


¥ Blend 


Progression Linear 


Orientation Horizontal 


Blend Texture panels. 


Options 


Progression 
Profile of blend. 


Linear 
A linear progression. 


Quadratic 
A quadratic progression. 


Easing 
A flowing, nonlinear progression. 


Diagonal 
A diagonal progression. 


Spherical 
A progression with the shape of a three-dimensional ball. 


Quadratic Sphere 
A quadratic progression with the shape of a three- 
dimensional ball. 


Radial 
A radial progression: Horizontal / Vertical. The direction of 
the progression is flipped a quarter turn. 


Clouds 


Clouds represent Perlin noise. In addition, each noise-based 
Blender texture (with the exception of Voronoi and simple 
noise) has a Noise Basis setting that allows the user to 
select which algorithm is used to generate the texture. This 
is often used for Clouds, Fire, Smoke. Well-suited to be used 
as a Bump map, giving an overall irregularity to the 
material. 


Noise Basis Blender Original 


Depth 


Nabla 


Clouds Texture panels. 


Options 


Grayscale 
The standard noise, gives an intensity. 


Color 
The noise gives an RGB value. 


Noise 
Soft or Hard, changes contrast and sharpness. 


Size 
The dimension of the Noise table. 


Depth 
The depth of the Clouds calculation. A higher number 
results in a long calculation time, but also in finer details. 


Distorted Noise 


Distortion Noise takes the option that you pick from Noise 
Basis and filters it, to create hybrid pattern. It is often used 
for grunge but is also very complex and versatile. 


Y Distorted Noise 


Noise Basis Blender Original 


Distortion Blender Original 
Amount 1.000 
Size 0.25 
Nabla 0.03 


Distorted Noise Texture panels. 


Options 


Noise Distortion 
The texture to use to distort another. 


Basis 
The texture to be distorted. 


Noise 
The size of the noise generated. 


Distortion 
The amount that Distortion Noise affects Basis. 


Image or Movie 


The term Image Texture simply means that a graphic image, 
which is a pixel grid composed of R, G, B, and sometimes 
Alpha values. It is used as the input source to the texture. 
As with other types of textures, this information can be used 
in a number of ways, not only as a simple “decal”. 


Video textures are a some kind of Image textures and based 
on movie file or sequence of successive numbered separate 
images. They are added in the same way that image 
textures are. 


When the Texture Type /mage or Movie is selected, three 
new panels present themselves allowing to control most 
aspects of how image textures are applied: /mage, Image 
Sampling, and Image Mapping. 


About Image-Based Texturing 


Texture images take up precious memory space, often being 
loaded into a special video memory bank that is very fast 
and very expensive, so it is often very small. So, keep the 
images as small as possible. A 64x64 image takes up only 
one fourth the memory of a 128x128 image. 


For photorealistic rendering of objects in animations, often 
larger image textures are used, because the object might be 
zoomed in on in camera moves. In general, you want to use 
a texture sized proportionally to the number of pixels that it 
will occupy in the final render. Ultimately, you only have a 
certain amount of physical RAM to hold an image texture 


and the model and to provide workspace when rendering 
your image. 


For the most efficient memory usage, image textures should 
be square, with dimensions as powers of 2, such as 32X32, 
64x64, 128x128, 256x256, 1024x1024, 2048x2048, and 
4096x4096. 


If you can reuse images across different meshes, this 
greatly reduces memory requirements. You can reuse 
images if you map those areas of the meshes that “look 
alike” to a layout that uses the common image. 


When using file textures, it is very important that you have 
Mapped the UVs of the mesh, and they are laid out 
appropriately. 


You do not have to UV map the entire mesh. The sphere 
above on the left has some faces mapped, but other faces 
use procedural materials and textures. Only use UV textures 
for those portions of your mesh where you want very 
graphic, precise detail. For example, a model of a vase only 
needs UV texture for the rim where decorative artwork is 
incorporated. A throw pillow does not need a different image 
for the back as the front; in fact many throw pillows have a 
fabric (procedural material) back. 


As another example, you should UV map both eyes of a 
head to the same image (unless you want one bloodshot 
and the other clear). Mapping both sides of a face to the 
Same image might not be advisable, because the location of 
freckles and skin defects are not symmetrical. You could of 
course change the UV map for one side of the face to 
Slightly offset, but it might be noticeable. Ears are another 
example where images or section of an image can be 
mapped to similar faces. 


Options 


Image 
The Image Data-Block Menu. 


Alpha 


Use the alpha channel information stored in the image. 
Where the alpha value in the image is less than 1.0, the 
object will be partially transparent and things behind it will 
be visible. Works with image formats that store 
transparency information. 


Calculate 
Calculate an alpha based on the RGB values of the 
Image. Black (0, 0, 0) is transparent, white (1, 1, 1) 
opaque. Enable this option if the image texture is a 
mask. Note that mask images can use shades of gray 
that result in semi-transparency, like ghosts, flames, and 
smoke/fog. 


The image with various alpha and gray-scale values. 


Image with Use 
alpha. The alpha 
values of the pixels 
are evaluated. 


Image with 
Calculate alpha 
only, Use Alpha in 
the Image panel is 
disabled. 


Invert 
Reverses the alpha value. Use this option if the mask 
image has white where you want it transparent and vice 
versa. 


Mapping 


¥ Mapping 


Extension 


Repeat X 


Y 


Minimum X 
Y 
Maximum X 


Y 


Image Mapping panel. 


In the Mapping panel, you can control how the image is 
mapped or projected onto the 3D model. 


Flip Axes 


Rotates the image 90 degrees counterclockwise when 
rendered. 


Extension 
How the image is extrapolated beyond its original 
bounds. 


Extend 


Outside the image the colors of the edges are 
extended. 


Clip 
Clip to image size and set exterior pixels as 
transparent. Outside the image, an alpha value of 0.0 
is returned. This allows you to ‘paste’ a small logo on 
a large object. 


Clip Cube 
Clips to cubic-shaped area around the images and 
sets exterior pixels as transparent. The same as Clip, 
but now the ‘Z’ coordinate is calculated as well. An 
alpha value of 0.0 is returned outside a cube-shaped 
area around the image. 


Repeat 
The image is repeated horizontally and vertically. 


Repeat 
X/Y repetition multiplier. 


Mirror 
Mirror on X/Y axes. These buttons allow you to map 
the texture as a mirror, or automatic flip of the 
image, in the corresponding X and/or Y direction. 


Checker 
Checkerboards quickly made. You can use the option 
size on the Mapping panel as well to create the 
desired number of checkers. 


Even/Odd 
Set even/odd tiles. 


Distance 


Governs the distance between the checkers in 
parts of the texture size. 


Crop 


Minimum X, Y / Maximum X, Y 
The offset and the size of the texture in relation to the 
texture space. Pixels outside this space are ignored. Use 
these to crop, or choose a portion of a larger image to 
use as the texture. 


Sampling 


In the Sampling panel you can control how the information 
is retrieved from the image. 


¥ Sampling 
Interpolation \# « 


MIPMap  « 


Gaussian Filter 


Filter Type EWA 


Eccentricity 8 
Size 1.00 


Minimum Size 


Image Sampling panel. 


Interpolation 


This option interpolates the pixels of an image. This 
becomes visible when you enlarge the picture. By 
default, this option is on. Turn this option off to keep the 
individual pixels visible and if they are correctly anti- 
aliased. This last feature is useful for regular patterns, 
such as lines and tiles; they remain ‘sharp’ even when 


enlarged considerably. Turn this image off if you are using 
digital photos to preserve crispness. 
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Enlarged Image Enlarged Image 

texture without texture with 

Interpolation. Interpolation. 
MIP Map 


Mip-maps are precalculated, smaller, filtered textures for 
a certain size. A series of pictures is generated, each half 
the size of the former one. This optimizes the filtering 
process. By default, this option is enabled and speeds up 
rendering. When this option is off, you generally get a 
sharper image, but this can significantly increase 
calculation time if the filter dimension (see below) 
becomes large. Without mip-maps you may get varying 
pictures from slightly different camera angles, when the 
textures become very small. This would be noticeable in 
an animation. 


Gaussian Filter 
Used in conjunction with mip-mapping, it enables the 
mip-map to be made smaller based on color similarities. 
In game engines, you want your textures, especially your 
mip-map textures, to be as small as possible to increase 
rendering speed and frame rate. 


Filter Type 
Texture filter to use for image sampling. Just like a pixel 
represents a pic ture e/ ement, a texe/ represents a tex 


ture e/ ement. When a texture (2D texture space) is 
mapped onto a 3D model (3D model space), different 
algorithms can be used to compute a value for each pixel 
based on samples from several texels. 


Box 


A fast and simple nearest-neighbor interpolation 
known as Monte Carlo integration. 


EWA (Elliptical Weighted Average) 
One of the most efficient direct convolution algorithms 
developed by Paul Heckbert and Ned Greene in the 
1980s. For each texel, EWA samples, weights, and 
accumulates texels within an elliptical footprint and 
then divides the result by the sum of the weights. 


Eccentricity 
Maximum Eccentricity. Higher values give less blur 
at distant/oblique angles, but is slower. 


FELINE (Fast Elliptical Lines) 
Uses several isotropic probes at several points along a 
line in texture space to produce an anisotropic filter to 
reduce aliasing artifacts without considerably 
increasing rendering time. 


Light Probes 
Number of probes to use. An integer between 1 
and 256. Further reading: McCormack, J; Farkas, Kl; 
Perry, R; Jouppi, NP (1999) Simple and Table Feline: 
Fast Elliptical Lines for Anisotropic Texture Mapping, 
WRL 


Area 
Area filter to use for image sampling. 


Eccentricity 
Maximum Eccentricity. Higher values give less blur 
at distant/oblique angles, but is slower. 


Size 
The filter size used in rendering, and also by the options 
Mip Map and Interpolation. |\f you notice gray lines or 
outlines around the textured object, particularly where 
the image is transparent, turn this value down from 1.0 
to 0.1 or so. 


Minimum Size 
Use Filter Size as a minimal filter value in pixels. 


Magic 


The magic texture is not frequently used. It can be used for 
“Thin Film Interference”, if you set Mapping to Reflection 
and use a relatively high Turbulence. The RGB components 
are generated independently with a sine formula. 


Depth 


Turbulence 


Magic Texture panels. 
Options 


Depth 
The depth of the calculation. A higher number results in a 
long calculation time, but also in finer details. 


Turbulence 
The strength of the pattern. 


Marble 


The marble texture is used to generate marble, fire, or noise 
with a structure. Bands are generated based on the sine, 
saw, or triangular formula and noise turbulence. 


¥ Marble 
Noise Basis Blender Original 
Pattern 


Second Basis 


Type 


Size 


Depth 


Turbulence 


Nabla 


Marble Texture panels. 
Options 


Marble Type 
Three settings for soft to more clearly defined Marble. 


Soft, Sharp, Sharper 


Noise basis 
Shape of wave to produce bands. 


Sine, Saw, Triangle 


Noise Type 
The noise function works with two methods. 


Soft, Hard 


Size 
The dimensions of the noise table. 


Depth 
The depth of the Marble calculation. A higher value 
results in greater calculation time, but also in finer 
details. 


Turbulence 
The turbulence of the sine bands. 


Musgrave 


The musgrave texture is used to generate organic materials, but it is very flexible. You can 
do nearly everything with it. 


¥ Musgrave 


Multifractal 


0.25 

Nabla 0.03 
Dimension 1.00 
Lac / 2.00 


2.00 


Intensity 1.00 


Musgrave Texture panels. 
Options 


Type 
This procedural texture has five noise types on which the resulting pattern can be based 
and they are selectable from a select menu at the top of the tab. The five types are: 


e Hetero Terrain 

e Fractal Brownian Motion (fBm) 
e Hybrid Multifractal 

e Ridged Multifractal 

e Multifractal 


These noise types determine the manner in which Blender layers successive copies of 
the same pattern on top of each other at varying contrasts and scales. 


Examples with Basis: Voronoi: F1, Dimension: 0.5, Lacunarity: 0.15, Octave: 2.0. 


Hetero Fractal Hybrid Ridged Multifracte 
Terrain. Brownian Multifractal. Multifractal. 
Motion. 


The main noise types have four characteristics: 


Dimension 
Fractal dimension controls the contrast of a layer relative to the previous layer in the 
texture. The higher the fractal dimension, the higher the contrast between each layer, 
and thus the more detail shows in the texture. 


Lacunarity 
Lacunarity controls the scaling of each layer of the Musgrave texture, meaning that 
each additional layer will have a scale that is the inverse of the value which shows on 
the button. i.e. Lacunarity = 2 -> Scale = 1/2 original. 


Octaves 
Octave controls the number of times the original noise pattern is overlayed on itself and 
scaled/contrasted with the fractal dimension and lacunarity settings. 


Intensity 
Light intensity. Called Offset for Hetero Terrain. 


The Hybrid Multifractal and Ridged Multifractal types have these additional settings: 


Offset 
Both have a “Fractal Offset” button that serves as a “sea level” adjustment and 
indicates the base height of the resulting bump map. Bump values below this threshold 
will be returned as zero. 


Gain 
Setting which determines the range of values created by the function. The higher the 
number, the greater the range. This is a fast way to bring out additional details in a 
texture where extremes are normally clipped off. 


Noise 


Y Preview 


Noise Texture panel. 


Although this looks great, it is not Perlin Noise! This is a 
true, randomly generated Noise. This gives a different result 
every time, for every frame, for every pixel. 


Options 


There are no options for this noise. 


Often used for 
White noise in an animation. This is not well suited if you 
do not want an animation. For material displacement or 
bump, use clouds instead. 


Result(s) 
Intensity. 


Stuccl 


Noise Basis Blender Original 


Pattern Plastic 


Type 


Size 


Turbulence 


Stucci Texture panels. 


The Stucci texture is based on noise functions. It is often 
used for stone, asphalt, or oranges, normally for bump 
mapping to create grainy surfaces. 


Options 


Plastic / Wall In / Wall out 
Plastic is the standard Stucci, while the “walls” is where 


Stucci gets it name. This is a typical wall structure with 
holes or bumps. 


Soft / Hard 
There are two methods available for working with Noise. 


Size 
Dimension of the Noise table. 


Turbulence 
Depth of the Stucci calculations. 


Voronol 


The Voronoi texture is used to generate very convincing 
Metal, especially the “Hammered” effect. Organic shaders 
(e.g. scales, veins in skin). 


¥ Voronol 


Distance Metric Actual Distance 


Coloring Intensity 


Intensity 1.000 


Size 0.25 


Nabla 0.03 


* Feature Weights 


First 1.000 
0.000 
Third 0.000 


Fourth 0.000 


Voronoi Texture panels. 


Options 


Distance Metric 
This procedural texture has seven Distance Metric options. 
These determine the algorithm to find the distance 
between cells of the texture. These options are: 


e Minkowski 

e Minkowski 4 

e Minkowski 1/2 

e Chebychev 

e Manhattan 

e Distance Squared 
e Actual Distance 


The Minkowski setting has a user definable value (the 
Exponent button) which determines the Minkowski 
exponent e of the distance function: 


(xe a yé Ae zeyte 


A value of one produces the Manhattan distance metric, a 
value less than one produces stars (at 0.5, it gives a 
Minkowski 1/2), and higher values produce square cells (at 
4.0, it gives a Minkowski 4, at 10.0, a Chebychev). So 
nearly all Distance Settings are basically the same -a 
variation of Minkowski. 


You can get irregularly-shaped rounded cells with the 
Actual Distance / Distance Squared options. 
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Feature Weights 
These four sliders at the bottom of the Voronoi panel 
represent the values of the four Worley constants, which 
are used to calculate the distances between each cell in 
the texture based on the distance metric. Adjusting these 
values can have some interesting effects on the end 
result... 


Coloring 
Four settings (/ntensity, Position, Position and Outline, and 
Position, Outline, and Intensity) that can use four different 
noise basis as methods to calculate color and intensity of 
the texture output. This gives the Voronoi texture you 
create with the “Worley Sliders” a completely different 
appearance and is the equivalent of the noise basis 
setting found on the other textures. 


Wood 


The wood texture is used to generate wood and ring-shaped 
patterns. 


¥ Preview 


SS 


Wood 


Noise Basis Blender Original 


Pattern Bands 


Second Basis Sine 


Wood Texture panels. 
Options 


Noise Basis 
Shape of wave to produce bands. 


Sine, Saw, Triangle 


Wood Type 


Set the bands to either straight or ring-shaped, with or 
without turbulence. 


Bands, Rings, Band Noise, Ring Noise 


Noise Type 
There are two methods available for the Noise function. 


Soft, Hard 
Size 
Dimension of the Noise table. 


Turbulence 
Turbulence of the Band Noise and Ring Noise types. 


Shader Nodes 
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Shaders 
Textures 
More 
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Ambient Occlusion 
Attribute Node 
Bevel Node 

Camera Data Node 
Fresnel Node 
Geometry Node 
Curves Info Node 
Layer Weight Node 
Light Path Node 
Object Info Node 
Particle Info Node 
Point Info 

RGB Node 

Tangent Node 
Texture Coordinate Node 
UV Map Node 

Value Node 

Color Attribute Node 
Volume Info Node 
Wireframe Node 


{put 
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O° 


AOV Output Node 
Material Node 
Light Node 

World Node 


e Shader 
Add Shader 
Anisotropic BSDF 
Background 
Diffuse BSDF 
Emission 
Glass BSDF 
Glossy BSDF 
Hair BSDF 
Holdout 
Mix Shader 
Principled BSDF 
Principled Hair BSDF 
Principled Volume 
Refraction BSDEF 
Specular BSDF 
Subsurface Scattering 
Toon BSDE 
Translucent BSDF 
Transparent BSDF 
Velvet BSDE 
Volume Absorption 
Volume Scatter 
e Texture 

o Brick Texture Node 
Checker Texture Node 
Environment Texture Node 
Gradient Texture Node 
IES Texture Node 
Image Texture Node 
Magic Texture Node 
Musgrave Texture Node 
Noise Texture Node 
Point Density Node 
Sky Texture Node 
Voronoi Texture Node 
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e Col 


Wave Texture Node 
White Noise Texture Node 


or 


Bright/Contrast Node 
Gamma Node 

Hue Saturation Value Node 
Invert Node 

Light Falloff Node 

Mix Node 

RGB Curves Node 


e Vector 


o Oo 0 0 0 0 0 OO O 


Bump Node 

Displacement Node 
Mapping Node 

Normal Node 

Normal Map Node 

Vector Curves Node 
Vector Displacement Node 
Vector Rotate Node 
Vector Transform Node 


e Converter 
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Blackbody Node 
Clamp Node 


Color Ramp Node 
Combine Color Node 
Combine XYZ Node 
Float Curve 

Map Range Node 
Math Node 

Mix Node 

RGB to BW Node 
Separate Color Node 
Separate XYZ Node 
Shader To RGB 
Vector Math Node 
Wavelength Node 


« Group 
o Make Group 
o Ungroup 
o Group Input 
o Group Output 
Node Groups 


{e) 


o Script Node 
Writing Shaders 
Closures 
Attributes 

Trace 
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Introduction 


Materials, lights and backgrounds are all defined using a 
network of shading nodes. These nodes output values, 
vectors, colors and shaders. 


Shaders 


An important concept to understand when building node 
setups is that of the shader socket. The output of all surface 
and volume shaders is a shader, describing lighting 
interaction at the surface or of the volume, rather than the 
color of the surface. 


There are a few types of shaders available as nodes: 


BSDF shader 


Describe light reflection, refraction and absorption at an 
object surface. 


Emission shader 
Describe light emission at an object surface orina 
volume. 


Volume shader 
Describe light scattering inside a volume. 


Background shader 
Describe light emission from the environment. 


Each shader node has a color input, and outputs a shader. 
These can then be mixed and added together using Mix and 
Add Shader nodes. No other operations are permitted. The 


resulting output can then be used by the renderer to 
compute all light interactions, for direct lighting or global 
illumination. 


See also 


Shaders 


Textures 


Blender has various built in procedural texture nodes, with 

texture coordinates and various parameters as input, and a 
color or value as output. No texture data-blocks are needed; 
instead node groups can be used for reusing texture setups. 


For UV mapping and texture painting in the 3D Viewport, the 
Image Texture node must be used. When setting such a 
node as active, it will be displayed in the 3D Viewport while 
using Texture color mode. This method can be used to 
preview painted textures while texture painting. 


The default texture coordinates for all nodes are Generated 
coordinates, except for Image textures that use UV 
coordinates by default. Each node includes some options to 
modify the texture mapping and resulting color, and these 
can be edited in the texture properties. 


See also 


Textures 


More 


Nodes for geometric data, texture coordinates, layering 
Shaders and non-physically-based tricks can be found in: 


e Vector Nodes 
e Color Nodes 
e Converter Nodes 


Open Shading Language 


In Cycles, custom nodes can be written using the Open 
Shading Language. 


See also 


Open Shading Language 


Input 


Ambient Occlusion 
Attribute Node 
Bevel Node 

Camera Data Node 
Fresnel Node 
Geometry Node 
Curves Info Node 
Layer Weight Node 
Light Path Node 
Object Info Node 
Particle Info Node 
Point Info 

RGB Node 

Tangent Node 
Texture Coordinate Node 
UV Map Node 

Value Node 

Color Attribute Node 
Volume Info Node 
Wireframe Node 


Ambient Occlusion 


The Ambient Occlusion shader 
computes how much the hemisphere 
above the shading point is occluded. 
This can be used for procedural 
texturing, for example to add Samples 
weathering effects to corners only. mene 


Y Ambient Occlusion 


Color 


Only Local 


For Cycles, this is an expensive shader 
and can slow down render significantly. Cor 
If render time is a concern, using e Distance 1.000 
Pointiness from the Geometry node or Normal 

baking Ambient Occlusion will result in 
faster renders. 


Note 


Cycles Only The Ambient Occlusion node will not produce a 
valid result on objects that are either a Caustic caster or 
Caustic receiver while the scene contains a active Caustic 
caster, Caustic receiver, and Shadow Caustic Light. 


Inputs 


Color 
Tint for AO output color. 


Distance 
Distance up to which other objects are considered to 
occlude the shading point. 


Normal 
Normal used for ambient occlusion; if nothing is 
connected the default shading normal is used. 


Properties 


Samples 
Number of samples to use for ray-traced ambient 
occlusion sampling. Keep as low as possible for optimal 
performance. 


Inside 
Detect convex rather than concave shapes, by 
computing occlusion inside mesh. 


Only Local Cycles Only 
Only detect occlusion from the object itself, and not 
others. 


Outputs 


Color 
Ambient occlusion with color tint. 


AO 
Ambient occlusion factor without color tint. 


Example 


White AO shader. 


Attribute Node 


The Attribute node allows you to 
retrieve attributes attached to an 
object or mesh. 


Y Attribute 


Alpha 


Type: Geometry v 


Name: 


Inputs 


This node has no inputs. 


Properties 


Name 
Name of the attribute. 


Type 
Specifies the type of the attribute. 


Geometry: The attribute is associated with the 
geometry of the object, and its value 
varies from vertex to vertex, or within 
the volume of the object. 

Most geometry attributes are directly 
accessible through the various input 
nodes, except for these: 


Object: 


Instancer: 


Ocean Foam 
Gives a scalar defining where foam 
might appear when using an Ocean 
Modifier. This depends on the name 
you give this property. 


See also 

For a full list of options see This 
Thread on the Blender Stack 
Exchange. 


The attribute name specifies a custom 
property name, or an RNA path to a 
built-in property (like the single 
property driver variables). 

The values of attributes of this type are 
defined once per object. The name or 
path is looked up first in the object 
data-block, followed by the mesh data- 
block if not found. Custom properties 
have priority over built-in ones. 

The property value must be an integer, 
float, boolean, or a vector of 1 to 4 
floats or ints; properties of other types 
are ignored. If a suitable property is not 
found, all sockets of the node, including 
Alpha, output 0. 


Tip 

The color attribute will output the 
value of the Color field in the Viewport 
Display panel of the object, unless 
overridden by a custom property. 


View Layer: 


Similar to Object, but the attribute is 
looked up in the instancer particle 
system settings, followed by Geometry 
Node instance attributes (Searching 
from the innermost instancing layer to 
outer ones), and finally in the instancer 
object. If the current object is not 
instanced, or the property is not found, 
it falls back to the Object mode. 


Warning 
Currently only up to 4 layers of 


Geometry Node instancing are 
searched. 


The attribute is looked up in the current 
View Layer, Scene and World, using the 
same lookup logic as Object. Attributes 
of this type have the same uniform 


value throughout the whole Render 
Layer. 


Tip 
This gives access to a number of 
useful built-in properties, for example: 
color OF world.color 
Outputs the value of the Color field 
in the Viewport Display panel of 
the World properties. 
render.resolution_x, render.resolution_y 
Outputs the current rendering 
resolution. 
camera.data.angle_x, 
camera.data.angle_y, 


Outputs the effective field of view 
of the active Camera. 


Outputs 


Color 
RGB color interpolated from the attribute. 


Vector 
XYZ vector interpolated from the attribute. 


Factor 
Scalar value interpolated from the attribute. 


Alpha 


Alpha channel of the attribute, when available. If the 
attribute has no alpha channel, generally defaults to 1. 


Warning 


Currently, only View Layer attributes are supported in 
Shaders used for the World or Light Objects. 


Bevel Node 


Cycles Only 


The Bevel shader node can be used for 
rendering rounded corners. Like bump 
mapping, this does not modify the 
actual geometry, only the shading is Samples 4 
affected. Slight rounding on edges o MIT wauEs 
helps to capture specular highlights re 

that you would also see in the real 
world. 


Normal 


Note that this is a very expensive shader, and may slow 
down renders by 20% even if there is a lot of other 
complexity in the scene. For that reason, we suggest to 
mainly use this for baking or still frame renders where 
render time is not as much of an issue. The Bevel modifier is 
a faster option when it works, but sometimes fails on 
complex or messy geometry. 


Note 


The Bevel node will not produce a valid result on objects 
that are either a Caustic caster or Caustic receiver while 
the scene contains a active Caustic caster, Caustic 
receiver, and Shadow Caustic Light. 


Inputs 


Radius 
Width of the bevel effect on edges. 


Normal 
Normal to apply bevel on top of, to be combined with a 
Bump node for example. 


Properties 


Samples 
Number of samples to take for each shader evaluation. 
More samples give more accurate results, but are also 
slower to render. The default value of 4 works well for 
most cases, with any noise resolved by using more AA 
samples. 


Outputs 


Normal 
Standard normal output. 


Examples 


Bevel shader bringing out specular highlights on the 
edges. 


Camera Data Node 


The Camera Data node returns 
information about the shading point 
relative to the camera. This could be 
used for example to change the 
Shading of objects further away from 
the camera, or make custom fog 
effects. 


Y Camera Data 


View Vector 


View Z Depth @ 


View Distance ® 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


View Vector 
A normalized vector, in camera space, from the camera 
to the shading point. 


View Z Depth 
The distance each pixel is away from the camera. 


View Distance 
Distance from the camera to the shading point. 


Fresnel Node 


The Fresnel or Dielectric Fresnel node 
computes how much light is reflected 
off a layer, where the rest will be 
refracted through the layer. The e 
resulting weight can be used for Normal 
layering shaders with the Mix Shader 
node. It is dependent on the angle 
between the surface normal and the 
viewing direction. 


Y Fresnel 


The most common use is to mix between two BSDFs using it 
as a blending factor in a Mix Shader node. For a simple glass 
material you would mix between a glossy refraction and 
glossy reflection. At grazing angles more light will be 
reflected than refracted as happens in reality. 


For a two-layered material with a diffuse base and a glossy 
coating, you can use the same setup, mixing between a 
diffuse and glossy BSDF. By using the Fresnel as the 
blending factor you are specifying that any light which is 
refracted through the glossy coating layer would hit the 
diffuse base and be reflected off that. 


Inputs 


IOR 
Index of refraction (IOR) of the material being entered. 


Normal 
Input meant for plugging in bump or normal maps which 
will affect the output. 


Properties 


This node has no properties. 


Outputs 


Factor 
Fresnel weight, indicating the probability with which light 
will reflect off the layer rather than passing through. 


Geometry Node 


The Geometry node gives geometric 
information about the current shading 
point. All vector coordinates are in 
World Space. For volume shaders, only 
the position and incoming vector are 
available. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Position 
Position of the shading point. 


Normal 


Y Geometry 
Position 
Normal 
Tangent 
True Normal 
Incoming 


Parametric 


Backfacing 


Pointiness 


Random Per Island 


Shading normal at the surface (includes smooth normals 
and bump mapping). 


Tangent 
Tangent at the surface. 


True Normal 
Geometry or flat normal of the surface. 


Incoming 
Vector pointing towards the point the shading point is 
being viewed from. 


Parametric 
Parametric coordinates of the shading point on the 
surface. To area lights it outputs its UV coordinates in 
planar mapping and in spherical coordinates to point 
lights. 


Backfacing 
1.0 if the face is being viewed from the back side, 0.0 for 
the front side. 


Pointiness Cycles Only 
An approximation of the curvature of the mesh per 
vertex. Lighter values indicate convex angles, darker 
values indicate concave angles. It allows you to do 
effects like dirt maps and wear-off effects. 


Random per Island Cycles Only 
A random value for each connected component (island) 
of the mesh. It is useful to add variations to meshes 
composed of separated units like tree leaves, wood 
planks, or curves of multiple splines. 


VL /|I\\N 


vy Geometry 
Position 
Normal 
Tangent 
True Normal 
Incoming 


Parametric 


Backfacing 


Pointiness @ 


Random Per Island 


Material 


vy Emission 


Color 


Strength 


Emission 


1.000 


y Material Output 
All 
Surface 
Volume 


Displacement 


Add Modifier 

, fae Ge 
Apply 

Fit Type: Fixed Count 


Count 


Constant Offset 


UVs: 
U Offset 
V Offset 


Start Cap: 
End Cap: 


ba 


¥ Relative Offset 


1.200 
0.000 
0.000 


Object Offset 


Get a random value for each instance of the 


mesh when using an Array modifier. 


Curves Info Node 


The Curves Info node gives access to 
Hair information. 


Y Hair Info 
Is Strand 
Intercept 
Length 


Thickness 


Tangent Normal 


Random 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Is Strand 
Outputs 1 when the shader is acting on a strand, 
otherwise 0. 


Intercept 
The point along the strand where the ray hits the strand 
(1 at the tip and O at the root). 


Length 


The total measurement from the root to the tip of the 
strand, interpreted as a grayscale value from 0 to infinity. 


Thickness 
The thickness of the strand at the point where the ray 
hits the strand. 


Tangent Normal 
Tangent normal of the strand. 


Random 
A random per-curve value in the range from 0 to 1. It can 
for example be used in combination with a color ramp, to 
randomize the curve’s color. 


Layer Weight Node 


The Layer Weight node outputs a 
weight typically used for layering 
Shaders with the Mix Shader node. 


Y Layer Weight 


Fresnel @ 
Facing @ 
& Blend 0.500 


Normal 


Inputs 


Blend 
Bias the output towards all 0 or all 1. Useful for uneven 
mixing of shaders. 


Normal 
Input meant for plugging in bump or normal maps which 
will affect the output. 


Properties 


This node has no properties. 


Outputs 


Fresnel 
Dielectric Fresnel weight, useful for example for layering 
diffuse and glossy shaders to create a plastic material. 
This is like the Fresnel node, except that the input of this 
node is in the often more convenient 0.0 to 1.0 range. 


Facing 
Weight that blends from the first to the second shader as 
the surface goes from facing the viewer to viewing it ata 
grazing angle. 


Light Path Node 


The Light Path node is used to find out 
for which kind of incoming ray the 
Shader is being executed; particularly 
useful for non-physically-based tricks. 


Y Light Path 


Is Camera Ray 


Is Shadow Ray 


More information about the meaning of bli 
each type is in the Light Paths is Glossy Ray 
documentation. Is Singular Ray 


Is Reflection Ray 

Is Transmission Ray 
Ray Length 

Ray Depth 

Diffuse Depth 


Glossy Depth 


Transparent Depth 


Transmission Depth 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Is Camera Ray 


1.0 if shading is executed for a camera ray, otherwise 
0.0. 


Is Shadow Ray 


1.0 if shading is executed for a shadow ray, otherwise 
0.0. 


Is Diffuse Ray 
1.0 if shading is executed for a diffuse ray, otherwise 0.0. 


Is Glossy Ray 
1.0 if shading is executed for a glossy ray, otherwise 0.0. 


Is Singular Ray Cycles Only 
1.0 if shading is executed for a singular ray, otherwise 
0.0. 


Is Reflection Ray Cycles Only 
1.0 if shading is executed for a reflection ray, otherwise 
0.0. 


Is Transmission Ray Cycles Only 
1.0 if shading is executed for a transmission ray, 
otherwise 0.0. 


Ray Length Cycles Only 
Distance traveled by the light ray from the last bounce or 
camera. 


Ray Depth 
Number of times the ray has been reflected or 
transmitted on interaction with a surface. 


Note 


Passing through a transparent shader does not count as 
a normal “bounce”. 


Diffuse Depth Cycles Only 
Number of times the ray has gone through diffuse 
reflection or transmission. 


Glossy Depth Cycles Only 
Number of times the ray has gone through glossy 
reflection or transmission. 


Transparent Depth Cycles Only 
Returns the number of transparent surfaces passed 
through. 


Transmission Depth Cycles Only 
Replace a Transmission light path after X bounces with 
another shader, e.g. a Diffuse one. This can be used to 
avoid black surfaces, due to low amount of max bounces. 


Eevee Support 


Eevee has no real concept of rays. But in order to ease the 
workflow between Cycles and Eevee some of the outputs 
are only supported in particular cases. This node makes it 
possible to tweak indirect lighting in the shader. 


Only a subset of the outputs are supported and the ray 
depth does not exactly have the same meaning. In order for 
the Is Camera, Is Shadow, Is Diffuse, and Is Glossy outputs 
to work, the object must be inside an Irradiance Volume and 
Indirect Lighting must be baked. 


e |s Camera: Supported. 
e Is Shadow: Supported. 
e Is Diffuse: Supported. 


Is Glossy: Supported. 

Is Singular: Not Supported. Same as Is Glossy. 

Is Reflection: Not Supported. Same as Is Glossy. 

Is Transmission: Not supported. Same as Is Glossy. 

Ray Length: Not supported. Defaults to 1.0. 

Ray Depth: Indicates the current bounce when baking 

the light cache. 

e Diffuse Depth: Same as Ray Depth but only when baking 
diffuse light. 

e Glossy Depth: Same as Ray Depth but only when baking 

specular light. 

Transparent Depth: Not supported. Defaults to 0. 

Transmission Depth: Not supported. Same as Glossy 

Depth. 


Note 


Is Glossy does not work with Screen Space 
Reflections/Refractions but does work with reflection 
planes (whether used with SSR or not). 


Object Info Node 


The Object Info node gives information 
about the object instance. This can be 
useful to give some variation to a 
single material assigned to multiple 


Y Object Info 


Location 


Color 


instances, either manually controlled neil 
through the object index, based on the Object Index 
object location, or randomized for each Material Index 


instance. For example a Noise texture Random 
can give random colors or a Color 
Ramp can give a range of colors to be 
randomly picked from. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Location 
Location of the object in world space. 


Color 
Object color, same as Color in the Properties » Object 
Properties » Viewport Display. 


Alpha 
The Alpha Channel component of the object’s viewport 
display color (see the Co/or output for more details). 


Object Index 
Object pass index, same as Pass Index in the Properties > 
Object Properties » Relations. 


Material Index 
Material pass index, same as Pass Index in the Properties 
> Material >» Settings. 


Random 
Random number unique to a single object instance. 


Note 


Note that this node only works for material shading nodes; 
it does nothing for light and world shading nodes. 


Example 


y Material Output 
Surface 


Volume 


Object Index ©@ 


Material Index @ 


Random @ 


Example blend-file. 


Particle Info Node 


Cycles Only 


The Particle Info node can be used in 
the material node tree for objects that 
are used as the instancing objects, 
when you use Object or Group Render 


Y Particle Info 


Index 


Random 


mode of a particle system. as 

Lifetime 
This node gives access to the data of Location 
the particle that spawned the object Size 
instance. It can be useful to give some Velocity 
variation to a single material assigned Angular Velocity 


to multiple instances of instancing 
object. 


Note 


This node currently only supports parent particles. Info 
from child particles is not available. 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Index 
Index number of the particle (from 0 to number of 
particles). 


Random 
A random per-particle value in the range from 0 to 1. It 
can for example be used in combination with a color 
ramp, to randomize the particle color. 


Age 
Age of the particle in frames. 


Lifetime 
Total lifespan of the particle in frames. 


Location 
Location of the particle. 


Size 
Size of the particle. 


Velocity 
Velocity of the particle. 


Angular Velocity 
Angular velocity of the particle. 


Point Info 


Cycles Only 


The Point Info node can be used in the 
material node tree for point cloud 
objects and gives access to the data of 
individual points. It can be useful to 
give some variation to a single iesnlacatell Gy 
material assigned a point cloud object. 


Y Point Info 


Position 


Radius @ 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Location 
Location of the particle. 


Radius 
Size of the particle. 


Random 
A random per-point value in the range from 0 to 1. It can 
for example be used in combination with a color ramp, to 
randomize the point color. 


RGB Node 


Inputs 


This node has no input sockets. 


Properties 


The RGB node uses the color picker widget. 


Outputs 


Color / RGBA 
A single RGBA color value. 


Tangent Node 


The Tangent node generates a 
tangent direction for the Anisotropic 
BSDF. Tangent 


Radial v X Y Be 


Y Tangent 


Inputs 


This node has no inputs. 


Properties 


Direction Type 
The tangent direction can be derived from a cylindrical 
projection around the X, Y, or Z axis (radial), or froma 
manually created UV Map for full control. 


Outputs 


Tangent 
The tangent direction vector. 


Texture Coordinate Node 


The Texture Coordinate node is 
commonly used for the coordinates of 
textures, typically used as inputs for 
the Vector input for texture nodes. 


Y Texture Coordinate 
Generated 
Normal 
UV 
Object 
Camera 
Window 


Reflection 


Object: ‘w 


From Instancer 


Inputs 


This node has no inputs. 


Properties 


Object 
Specific object to use for object space coordinates. This 
only affects the Object output. 


From Instancer Cycles Only 
If the object is generated by instancing from vertices or 
faces, use texture coordinates from instancer. This only 
affects the Generated and UV outputs. 


From left to right: Sohere with a UV-mapped 
texture. Small spheres instanced to the faces of 
the textured sphere using instancing from faces. 
Small spheres with From Instancer enabled, using 
the UV map of the large sphere. 


Note 


From Instancer only works with the UV output when the 
object is instanced, either from particles or from faces. 


Outputs 


Generated 


Automatically-generated texture coordinates from the 
vertex positions of the mesh without deformation, 
keeping them sticking to the surface under animation. 
Range from 0.0 to 1.0 over the bounding box of the 
undeformed mesh. See Texture Spaces for more 
information. 


Normal 


Object space normal, for texturing objects with the 
texture staying fixed on the object as it transformed. The 
Normal output can be used on Point and Spot lights. The 
coordinates will take the rotation of the light into 
account. 


UV 
UV texture coordinates from the active render UV map. 
See UV Mapping for more information. 


Note 


In order to select UV map other than the active map 
you must use the UV Map node. 


Object 
Uses an object as a source for coordinates. Often used 
with an empty, this is an easy way to place a small image 
at a given point on the object. This object can also be 
animated, to move a texture around or through a 
surface. 


Camera 
Position coordinate in camera space. 


Window 
Location of shading point on the screen, ranging from 0.0 
to 1.0 from the left to right side and bottom to top of the 
render. This is well suited for blending two objects. 


Reflection 
Uses the direction of the reflection vector as coordinates. 
This is useful for adding reflection maps. You will need 
this input when using environment maps. 


UV Map Node 


The UV Map node is used to retrieve 
specific UV maps. Unlike the Texture 
Coordinate Node which only provides 
the active UV map, this node can From Instancer 
retrieve any UV map belonging to the 
object using the material. 


Yv UV Map 


Inputs 


This node has no inputs. 


Properties 


From Instancer Cycles Only 
See the From Instancer option of the Texture Coordinate 
Node. 


UV Map 
UV map to use. 


Outputs 


UV 
UV mapping coordinates from the specified UV map. 


Value Node 


The Value Node is a simple node to input 
numerical values to other nodes in the 
tree. Value @ 


vy Value 


0.500 


Inputs 


This node has no input sockets. 


Properties 


Single numerical value (floating-point). 


Outputs 


Value 
The value set in the node properties. 


Example 


In the following example the Va/ue Node is used to control 
multiple values at once, this makes the node a useful 
organizational tool. 


¥ Use Alpha 


image 


e Alpha 1.000 


e vA 1.000 


Example of the Value node. 
Tip 
From this you can also make different values proportional 


to each other by adding a Math Node in between the 
different links. 


Color Attribute Node 


The Color Attribute node provides 
access to Color Attributes as well as 
their alpha value. 


Y Vertex Color 


Color 


Alpha ® 


Inputs 


This node has no inputs. 


Properties 


Color Attribute 
The target Color Attribute. The listed Color Attributes are 
those of the mesh of the active object. If the active 
object has no mesh, a warning will be displayed. If the 
property is marked in red, it means the Color Attribute is 
not available in the mesh of the active object, but it may 
be available in other meshes of objects that share this 
material! 


Outputs 


Color 
Standard color output. 


Alpha 
Alpha value. 


Volume Info Node 


The Volume Info node provides 
information about Smoke Domains. 


Y Volume Info 


Color 


Density @ 


Flame @ 


Temperature ® 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Color 
Gives the color of the smoke inside the Fluid Domain. The 
color and vector outputs are the same. The Factor output 
is an average of the channels. 


Density 
Gives a scalar defining the density of any smoke inside 
the Eluid Domain. 


Flame 


Gives a scalar defining the density of any fire inside the 
Fluid Domain. All three outputs are the same. 


Temperature 
Gives a scalar defining the temperature of the volume. 
Values in the range O - 1 map to O - 1000 kelvin. This 
may be used to render physically-based fire with the 
Blackbody or Principled Volume shaders. All three outputs 
are the same. 


Example 


vy Volume Info vy Volume Absorption 
Color Volume 


Density @ Color 


Flame @ @ Density 


Temperature @ 


Smoke density. 


y Volume Info 


Color 


Density 


Flame 


Temperature 


vy Map Range 


vy Blackbody vy Volume Absorption 


Result @ Volume 


Clamp @ Temperature Color 


@ Density 
Value 


From Min 0.000 
From Max 1.000 
To Min 0.000 
To Max 1000.000 


Computing the color of fire using the Blackbody 


node. Since the Blackbody node expects its input in 
Kelvin, the temperature output has to be remapped 
first. 


Wireframe Node 


The Wireframe node is used to retrieve 
the edges of an object as it appears to 
Cycles. As meshes are triangulated 
before being processed by Cycles, Pixel Size 
topology will always appear < 
triangulated when viewed with the 
Wireframe node. 


Y Wireframe 


Size 


Inputs 


This node has no inputs. 


Properties 


Pixel Size 
When enabled, the size of edge lines is set in screen 
Space. 


Size 
Thickness of the edge lines. 


Outputs 


Factor 
Black-and-white mask showing white lines representing 
edges according to the object’s Topology. 


Examples 


Using the Wireframe node to showcase the topology 
of a mesh. 


Output 


Output nodes are the final node in every node tree. 
Although you can add more than one, only one will be used 
(indicated by a colored or darkened header). Output nodes 
are always preceded by Shaders except in the case of the 
Displacement of a Material Output. 


AOV Output Node 
Material Node 
Light Node 

World Node 


AOV Output Node 


Shader AOVs (Arbitrary Output 
Variables) provide custom render 
passes for arbitrary shader node 
components. As an artist this can bea Color 

good way to debug or tweak very fine e Value —_—-0.000 
details of a scene in post-processing. 
To use shader AOVs create the pass in 
the Shader AOV panel then reference 
that pass with the AOV Output shading node. Shader AOVs 
can be added or removed in the Shader AOV panel. 


Y AOV Output 


Name: 


Tip 


The AOV Output node can be used in Material and World 
Shader nodes. 


Inputs 


Color 
Output a color variable; as the name suggest can be 
used for a color but also a normal value. 


Value 
Output a single numerical value. 


Properties 


Name 


The name of the render pass to assign the input value to. 
This property has the same Name that is specified in the 
Shader AOV panel. 


Outputs 


This node has no outputs. 


Material Node 


The Material Output node is used to 
output surface material information to 
a surface object. 


Y Material Output 
All 


Surface 


Volume 


Displacement 


Inputs 


Surface 
Shading for the surface of the object. 


Volume 
Shading for the volume inside the object. 


Displacement 
Used to create bump mapping or actual subdivided 
displacement. 


Properties 


Target 
Render engine the input shaders are used for. By default 
Shaders are shared between Cycles and Eevee, with 
multiple output nodes specialized shader setups can be 
created for each. 


Outputs 


This node has no outputs. 


Light Node 


The Light Output node is used to 
output light information to a light 
object. 


Y Light Output 


All 


Surface 


Inputs 


Surface 
Shading for the surface of the light object. 


Properties 


Target 
Render engine the input shaders are used for. By default 
Shaders are shared between Cycles and Eevee, with 
multiple output nodes specialized shader setups can be 
created for each. 


Outputs 


This node has no outputs. 


World Node 


The World Output node is used to 
output light a color information to the 
scene’s World. 


Y World Output 


All 


Surface 


Volume 


Inputs 


Surface 
The appearance of the environment, usually preceded by 
a Background shader. 


Volume 
Used to add volumetric effects to the world. See the 
shaders Volume Absorption and Volume Scatter for more 
information. 


Note 

It is not possible to have an HDR and volumetric due to 
the fact that HDR’s are assumed to be an infinite 
distance from the camera. 


Properties 


Target 
Render engine the input shaders are used for. By default 
Shaders are shared between Cycles and Eevee, with 


multiple output nodes specialized shader setups can be 
created for each. 


Outputs 


This node has no outputs. 


Shader 


Add Shader 
Anisotropic BSDF 
Background 
Diffuse BSDF 
Emission 

Glass BSDF 

Glossy BSDF 

Hair BSDF 

Holdout 

Mix Shader 
Principled BSDF 
Principled Hair BSDF 
Principled Volume 
Refraction BSDF 
Specular BSDF 
Subsurface Scattering 
Toon BSDF 
Translucent BSDF 
Transparent BSDF 
Velvet BSDF 
Volume Absorption 
Volume Scatter 


Add Shader 


The Add node is used to add two 
Shaders together. 


Y Add Shader 


Shader 
Shader 
Shader 


Inputs 


Shaders 
Standard shader inputs. 


Properties 
This node has no properties. 


Outputs 


Shader 
Standard shader output. 


Example 


A mix of a glossy and a diffuse shader makes a nice 
ceramic material. 


Anisotropic BSDF 


Cycles Only Y Anisotropic BSDF 

The Anisotropic BSDF is used to add a ad 
glossy reflection, with separate GGX 2 
control over U and V direction — 


roughness. The tangents used for 
shading are derived from the active 
UV map. If no UV map is available, 
they are automatically generated 
using a sohere mapping based on the 
mesh bounding box. 


a Roughness 0.500 


a Anisotropy 0.500 


@ Rotation 0.000 
Normal 


Tangent 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability that light is reflected for each wavelength. 


Roughness 
Sharpness of the reflection; perfectly sharp at 0.0 and 
smoother with higher values. 


Anisotropy 
Amount of anisotropy in the reflection; 0.0 gives a round 
highlight. Higher values give elongated highlights 
orthogonal to the tangent direction; negative values give 
highlights shaped along the tangent direction. 


Rotation 


Rotation of the anisotropic tangent direction. Value 0.0 
equals 0° rotation, 0.25 equals 90° and 1.0 equals 360° 
= 0°. This can be used to texture the tangent direction. 


Normal 
Normal used for shading; if nothing is connected the 
default shading normal is used. 


Tangent 
Tangent used for shading; if nothing is connected the 
default shading tangent is used. 


Properties 


Distribution 
Microfacet distribution to use. Sharp results in perfectly 
Sharp reflections like a mirror, while Beckmann, GGX and 
Ashikhmin-Shirley can use the Roughness input for blurry 
reflections. 


Outputs 


BSDF 
Standard shader output. 


Examples 


Anisotropic rotation 


Anisotropic rotation 
on 0. 


on 0.25 (90°). 


Anisotropic shading with 0° rotation, 90° rotation 
and textured rotation of the tangent direction. 
Example blend-file. 


Background 


The Background shader node is used 
to add background light emission. This 
node should only be used for the world 


surface output. cir 


® Strength 1.000 


Y Background 


Background 


Inputs 


Color 
Color of the emitted light. 


Strength 
Strength of the emitted light. 


Properties 


This node has no properties. 


Outputs 


Background 
Standard shader output. 


Diffuse BSDF 


The Diffuse BSDF node is used to add 


Lambertian and Oren-Nayar diffuse Bie Smee nde 


reflection. 


® Roughness 0.000 


Normal 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability that light is reflected or transmitted for each 
wavelength. 


Roughness Cycles Only 
Surface roughness; 0.0 gives standard Lambertian 
reflection, higher values activate the Oren-Nayar BSDF. 
Normal 


Normal used for shading; if nothing is connected the 
default shading normal is used. 


Properties 


This node has no properties. 


Outputs 


BSDF 
Standard shader output. 


Examples 


v— 


Lambertian Diffuse shader behavior. 
reflection. 


Oren-Nayar 
reflection. 


Emission 


The Emission node is used to add 

Lambertian emission shader. This can 
for example, be used for material and 
light surface outputs. Color [a 


& Strength 1.000 


Y Emission 


Emission 


Light strength for point, spot and area 
lights is specified in Watts. 


Sun lights are specified in Watts/m2, which require much 
smaller values like 1 W/m?2. This can be confusing, but 
specifying strength in Watts would not have been 
convenient; the real sun for example has strength 
384.6x1024W. Emission shaders on meshes are also in 
Watts/m2. 


Inputs 


Color 
Color of the emitted light. 


Strength 
Strength of the emitted light. For point and area lights, 
the unit is Watts. For materials, a value of 1.0 will ensure 
that the object in the image has the exact same color as 
the Color input, i.e. make it ‘shadeless’. 


Properties 


This node has no properties. 


Outputs 


Emission 
The Emission shader output can both be plugged into the 
Surface Input as well as the Volume Input of the Material 
Output node. 


Examples 


Emission shader, Emission shader, 
with strength at 1.0. with strength at 3.0. 


Glass BSDF 


The Glass BSDF is used to adda 


Glass-like shader mixing refraction 
and reflection at grazing angles. Like 
the transparent shader, only pure Beckmann 

white will make it transparent. The — | 
glass shader tends to cause noise due 
to caustics. Since the Cycles path 
tracing integrator is not very good at 
rendering caustics, it helps to 
combine this with a transparent 
shader for shadows; for more details 
see here. 


Y Glass BSDF 


® Roughness 0.000 
@ IOR 1.450 


Normal 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability that light is transmitted for each wavelength. 


Roughness 
Influences sharpness of the refraction; perfectly sharp at 
0.0 and smoother with higher values. 


IOR 
Index of refraction (IOR) defining how much the ray 
changes direction. At 1. 0 rays pass straight through like 
transparent; higher values give more refraction. 


Normal 
Normal used for shading. 


Properties 


Distribution 

Microfacet distribution to use. 

Sharp: Results in perfectly sharp reflections 
like a mirror. The Roughness value is 
not used. 

GGX: GGX microfacet distribution. 


Multiple-scattering GGX: 
Cycles Only Takes multiple bounce 
(scattering) events between 
microfacets into account. This gives a 
more energy conserving results, which 
would otherwise be visible as excessive 
darkening. 

Beckmann: Cycles Only Beckmann microfacet 
distribution. 

Ashikhmin-Shirley: 
Cycles Only Ashikhmin-Shirley 
microfacet distribution. 


Outputs 


BSDF 
Standard shader output. 


Examples 


Sharp Glass Sharp Glass behavior. 


example. 


Rough Glass Rough Glass behavior. 
example. 


Glossy BSDF 


reflection with microfacet distribution, 
used for materials such as metal or 
mirrors. GGX 


Y Glossy BSDF 


® Roughness 0.500 


Normal 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability that light is reflected for each wavelength. 


Roughness 
Input for the surface roughness resulting in sharp to 
blurry reflections. 


Normal 
Normal used for shading. 


Properties 


Distribution 
Microfacet distribution to use. 


Sharp: Results in perfectly sharp reflections 
like a mirror. The Roughness value is 
not used. 


GGX: GGX microfacet distribution. 

Multiple-scattering GGX: 
Cycles Only Takes multiple bounce 
(scattering) events between 
microfacets into account. This gives a 
more energy conserving results, which 
would otherwise be visible as excessive 
darkening. 

Beckmann: Cycles Only Beckmann microfacet 
distribution. 

Ashikhmin-Shirley: 
Cycles Only Ashikhmin-Shirley 
microfacet distribution. 


Outputs 


BSDF 
Standard shader output. 


Examples 


Sharp Glossy Sharp Glossy behavior. 
example. 


Rough Glossy behavior. 


Rough Glossy 
example. 


Hair BSDF 


Cycles Only Y Hair BSDF 
The Hair BSDF node is used to add 


Shading for Hair. Reflection 
Color 


© Offset 


a Roughness 0.100 


o Roughness 1.000 


Tangent 


Inputs 


Color 
Color of the hair. 


Offset 
Controls the way the light is rotated (angular shift) for 


the reflection/transmission. 


r 
\ 
if 


Reflection Offset. 


Transmission Offset. 


Roughness U/V 


Controls the roughness in the direction light is skewed, 
and perpendicular to it. 


Reflection Transmission 


Roughness. Roughness. 
Tangent 


Input tangent. 


Properties 


Component 


There are two components that can be used to control 
the look of the hair. Usually you are going to want each of 
these and use a Mix Node. 


Reflection: The light that bounces off the surface 
of the hair. 

Transmission: The light that passes through the hair 
and exits on the other side. 


With Mix node: O is full Reflection, 1 is full 
Transmission. 


Outputs 


BSDF 
Standard shader output. 


Holdout 


The Holdout shader node is used to 
create a “hole” in the image with zero 
alpha transparency, which is useful for 
compositing (see Aloha Channel). 


Y Holdout 


Holdout 


Note that the holdout shader can only create alpha when 
Properties » Render > Film >» Transparent is enabled. If it is 
disabled, the holdout shader will be black. 


Inputs 
This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Holdout 
Standard shader output. 


Examples 


The checkered area is a region with zero alpha. 


Mix Shader 


The Mix node is used to mix two 
shaders together. Mixing can be used 
for material layering, where the Factor 
input may, for example, be connected e | Fac 0.500 
to a Blend Weight node. Shader 


Shader 


Y Mix Shader 


Shader 


Inputs 


Shader 
Shaders to mix, such that incoming rays hit either with 
the specified probability in the Factor socket. 


Factor 
Blend weight to use for mixing two shaders; at zero it 
uses the first shader entirely and at one the second 
shader. 


Properties 
This node has no properties. 


Outputs 


Shader 
Standard shader output. 


Examples 


A mix of a glossy and a diffuse shader makes a nice 
ceramic material. 


Principled BSDF 


single easy to use node. It is based on the Disney principled 
model also Known as the “PBR” shader, making it 
compatible with other software such as Pixar’s Renderman® 
and Unreal Engine®. Image textures painted or baked from 
software like Substance Painter® may be directly linked to 
the corresponding parameters in this shader. 


This “Uber” shader includes multiple layers to create a wide 
variety of materials. The base layer is a user controlled mix 
between diffuse, metal, subsurface scattering and 
transmission. On top of that there is a specular layer, sheen 
layer and clearcoat layer. 


Note 


The emphasis on compatibility with other software means 
that it interprets certain input parameters differently from 
older Blender nodes. 


Y Principled BSDF 


GGX 
Random Walk 
Base Color 


Subsurface 


Subsurface Radius 


) Slibsurface IOR 


Subsurface Anisotropy 


Metallic 


Specular Tint 
Anisotropic 
Anisotropic Rotation 


Sheen 


Clearcoat 


( Clearcoat Roughness 


IOR 
Transmission 
Transmission Roughness 
Emission 
Emission Strength 
Alpha 
Normal 
Clearcoat Normal 


Tangent 


Inputs 


Base Color 
Diffuse or metal surface color. 


Subsurface 
Mix between diffuse and subsurface scattering. Rather 
than being a simple mix between Diffuse and Subsurface 
Scattering, it acts as a multiplier for the Subsurface 
Radius. 


Subsurface Radius 
Average distance that light scatters below the surface. 
Higher radius gives a softer appearance, as light bleeds 
into shadows and through the object. The scattering 
distance is specified separately for the RGB channels, to 
render materials such as skin where red light scatters 
deeper. The X, Y and Z values are mapped to the R, G 
and B values, respectively. 


Subsurface Color 
Subsurface scattering base color. 


Subsurface IOR Cycles Only 
Index of refraction for Subsurface Scattering. 


Subsurface Anisotropy Cycles Only 
Controls the directionality of subsurface scattering. 


Metallic 
Blends between a non-metallic and metallic material 
model. A value of 1.0 gives a fully specular reflection 
tinted with the base color, without diffuse reflection or 
transmission. At 0.0 the material consists of a diffuse or 
transmissive base layer, with a specular reflection layer 
on top. 


Specular 


Amount of dielectric specular reflection. Specifies facing 


(along normal) reflectivity in the most common 0 - 8% 
range. 


Hint 
To compute this value for a realistic material with a 
known index of refraction, you may use this special 


case of the Fresnel formula: \(specular = ((ior - 1)/(ior + 
1))*2 / 0.08\) 


For example: 


e water: ior = 1.33, specular = 0.25 
e glass: ior = 1.5, specular = 0.5 
e diamond: ior = 2.417, specular = 2.15 


Since materials with reflectivity above 8% do exist, the 
field allows values above 1. 


Specular Tint 


Tints the facing specular reflection using the base color, 
while glancing reflection remains white. 


Normal dielectrics have colorless reflection, so this 
parameter is not technically physically correct and is 
provided for faking the appearance of materials with 
complex surface structure. 


Roughness 
Specifies microfacet roughness of the surface for diffuse 
and specular reflection. 


Anisotropic Cycles Only 


Amount of anisotropy for specular reflection. Higher 
values give elongated highlights along the tangent 


direction; negative values give highlights shaped 
perpendicular to the tangent direction. 


Anisotropic Rotation Cycles Only 
Rotates the direction of anisotropy, with 1.0 going full 
circle. 


Hint 

Compared to the Anisotropic BSDF node, the direction 
of highlight elongation is rotated by 90°. Add 0.25 to 
the value to correct. 


Sheen 
Amount of soft velvet like reflection near edges, for 
simulating materials such as cloth. 


Sheen Tint 
Mix between white and using base color for sheen 
reflection. 


Clearcoat 
Extra white specular layer on top of others. This is useful 
for materials like car paint and the like. 


Clearcoat Roughness: 
Roughness of clearcoat specular. 


IOR 
Index of refraction for transmission. 


Transmission 
Mix between fully opaque surface at zero and fully glass 
like transmission at one. 


Transmission Roughness Cycles Only 


With GGX distribution controls roughness used for 
transmitted light. 


Emission 
Light emission from the surface, like the Emission shader. 


Emission Strength 
Strength of the emitted light. A value of 1.0 will ensure 
that the object in the image has the exact same color as 
the Emission Color, i.e. make it ‘shadeless’. 


Alpha 
Controls the transparency of the surface, with 1.0 fully 
opaque. Usually linked to the Alpha output of an Image 
Texture node. 


Normal 
Controls the normals of the base layers. 


Clearcoat Normal 
Controls the normals of the Clearcoat layer. 


Tangent 
Controls the tangent for the Anisotropic layer. 


Properties 


Distribution 
Microfacet distribution to use. 


GGX: A method that is faster than Multiple- 
scattering GGX but is less physically 
accurate. Selecting it enables the 
Transmission Roughness input. 

Multiple-scattering GGX: 


Subsurface Method 


Takes multiple bounce (scattering) 
events between microfacets into 
account. This gives a more energy 
conserving results, which would 
otherwise be visible as excessive 
darkening. 


Rendering method to simulate subsurface scattering. 


Note 


Eevee does use not support the Random Walk methods. 


Christensen-Burley: 


An approximation to physically-based 
volume scattering. This method is less 
accurate than Random Walk however, 
in some situations this method will 
resolve noise faster. 


Random Walk (Fixed Radius): 


Random Walk: 


Provides accurate results for thin and 
curved objects. Random Walk uses true 
volumetric scattering inside the mesh, 
which means that it works best for 
closed meshes. Overlapping faces and 
holes in the mesh can cause problems. 
Behaves similarly to Random Walk 
(Fixed Radius) but modulates the 
Subsurface Radius based on the Color, 
Subsurface Anisotropy, and Subsurface 
IOR. This method thereby attempts to 
retain greater surface detail and color 
than Random Walk (Fixed Radius). 


Outputs 


BSDF 
Standard shader output. 


Examples 


Below are some examples of how all the Principled BSDF’s 
parameters interact with each other. 


subsurface 
metallic 


specular 


specular tint 


roughness 

anisotropic 
sheen 

sheen tint 


clearcoat 


clearcoat 
roughness 
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Principled Hair BSDF 


Cycles Only 


Y Principled Hair BSDF 


a physically-based, easy-to- Direct Coloring 
use shader for rendering 
hair and fur. 


Color 

Roughness 
7 Radial Roughness 
Tip Coat 
Realistic hair should have 
a minimum of variance 
between each strand. The 
shader allows for this by 
specifying two values, 
Random Color and 
Random Roughness, which remap the specified 
Melanin/Roughness values to the range \(Color/Roughness 
\pm Randomization\%\). 


Offset 


Random Roughness 


® 
@ 
© 
® IOR 
@ 
@ 
© 


Random 


Inputs 


Color 
The RGB color of the strand. Only used in Direct coloring. 


Hint 
The chosen color is converted to an absorption 


coefficient with the following formula (section 4.2 of 
[CBTB16]): 


\[\sigma_{a} = \frac{\In(Color)} {\left(5.969 - 
0.215\beta {N} + 2.532\beta {N}*{2} - 

10.73\beta {N}*{3} + 5.574\beta_ {N}*{4} + 
0.245\beta_{N}*{5}\right)*{2}}\] 

where \(\beta_{N}\) is the radial roughness of the hair 
after applying randomization (if specified). 


(0, 0.5, 0.25, 1) (0, 0.25, 0.5, 1) (0.5, 0, 0.25, 1) (0.5, 0.25, 0, 1) (0.25, 0, 0.5, 1) 


Coloring hair using the Direct coloring 
parametrization. (The numbers on top are the 
RGB values.) 


Melanin 
Absolute quantity of pigment. Range \([0, 1]\) equivalent 
to \([O\%, 100\%)]\). 


Hint 
This is a linear mapping to the underlying exponential 
function: 


\[melanin\_qty = -\In(\max(1.0 - Melanin, 0.0001))\] 


Melanin. 


Melanin Redness 
Ratio of pheomelanin to eumelanin. Range \([0, 1]\) 
equivalent to \([O\%, 100\%)\). 


Hint 

The ratio formula is: \((eumelanin = Melanin*(1.0- 
MelaninRedness)\), \(pheomelanin = 
Melanin*MelaninRedness\). 


The resulting quantities are converted (after 
randomization, if specified) to absorption concentration 
via the following formula (section 6.1 of [EFHLA11], 
adjusted for the range \([0, 1]\)): 


\[\begin{split}\sigma_ {a} = eumelanin * 
\left[\begin{ matrix} 0.506 \\ 0.841 \\ 1.653 \\ 
\end{matrix}\right] + pheomelanin * 
\left[\begin{ matrix} 0.343 \\ 0.733 \\ 1.924 \\ 
\end{matrix}\right]\end{split}\] 


Melanin Redness. 


Tint 
Color used for dyeing the hair after applying the melanin 
pigment. It is not subject to randomization. It can be 
disabled by setting the color to white. 


Hint 

This is converted via the Color mapping above and 
added to the absorption coefficient of the melanin 
concentration. 


(0, 0.5, 0.25, 1) (0, 0.25, 0.5, 1) (0.5, 0, 0.25, 1) (0.5, 0.25, 0, 1) (0.25, 0, 0.5, 1) 


Tint, using Melanin 0.1 and the corresponding 
RGB values. 


Absorption Coefficient 
Attenuation coefficient \(\sigma\). 


Roughness 
Specify how much the glints are smoothed in the 
direction of the hair shaft. Too low values will smoothen 
the hair to the point of looking almost metallic, making 
glints look like Fireflies; while setting it too high will result 
in a Lambertian look. 


Roughness. 


Radial Roughness 
Specify how much the glints are smoothed in the 
direction of the hair normal. Too low values will 
concentrate the glint; while setting it too high will spread 
the light across the width of the strand. 


Hint 
Mathematically, this parameter is mapped to the 


logistic distribution’s scale factor \(s\) (section 4.1 of 
[CBTB16]). 


‘wa 
\\ \a ‘ m es, 


Radial Roughness. 


Coat 
Simulate a shiny coat of fur, by reducing the Roughness 
to the given factor only for the first light bounce (diffuse). 
Range \([0, 1]\) equivalent to a reduction of \([0\%, 
100\%]\) of the original Roughness. 


Coat. 


IOR 
Index of refraction (LOR) defining how much the ray 
changes direction. At 1.0 rays pass straight through like 
in a transparent material; higher values give more 
refraction. Default value is \(1.55\). 


Offset 
Tilts the glint of the hair by increasing the angle of the 
scales of the hair’s cuticle with respect to the hair shaft. 
Human hair usually has low values. 


Random Color 
For each strand, vary the melanin concentration by \ 
(RandomFactor\). Range \([0, 1]\) equivalent to \([0\%, 
100\%]\) of the initial melanin concentration. 


Hint 

The melanin concentration is multiplied by \ 
(randomFactor\), where \(randomFactor = 1.0 + 2.0* 
(Random - 0.5) * RandomColor\). 


Random Color. 


Random Roughness 
For each strand, vary both Roughness values by \ 
(RandomFactor\). Range \([0, 1]\) equivalent to \([0\%, 
100\%]\) of the initial roughness values. 


Hint 
The applied formula is the same one as for Random 
Color. 


Random Roughness. 


Random 
Random number source. If no node is connected here, it 
is automatically instanced with the value obtained from 
Hair Info » Random. 


Properties 


Color Parametrization 


The shader provides three different ways, or 
parametrizations, to color the hair strands. 


Direct Coloring: 
Choose the desired RGB color and the 
shader will approximate the necessary 
absorption coefficient (below). 


Melanin Concentration: 
This mode defines the color as the 
quantity and ratio of the pigments 
which are commonly found in hair and 
fur, eumelanin (prevalent in brown- 
black hair) and pheomelanin (red hair). 
The quantity is specified in the Melanin 
input, and the ratio between them in 
Melanin Redness. Increasing 
concentrations darken the hair (the 
following are with Melanin Redness \ 
(1\)): 
e White (Melanin \(0\)) 
e Blonde (Melanin \(0.25\)) 
e Reddish (Melanin \(0.5\)) 
e Brown (Melanin \(0.75\)) 
e Black (Melanin \(1\)) 
Additionally, the Tint inputs allows to 
dye the hair with the desired color. 


Absorption Coefficient: 


Specifies the attenuation coefficient \ 
(\sigma_{a}\), as applied by the Beer- 
Lambert law. This mode is intended 
mainly for technical users who want to 
use coefficients from the literature 
without any sort of conversion. 


Outputs 


BSDF 
Standard shader output. 


References 


This shader is an implementation of the paper by Chiang et 
al. [(CBTB16], which was used in the Disney film, 
“Zootopia”®. 


[CBTB16] (1,2,3) Chiang, M. J. , Bitterli, B. , Tappan, C. and 
Burley, B. (2016), A Practical and Controllable Hair and 
Fur Model for Production Path Tracing. Computer Graphics 
Forum, 35: 275-283. doi:10.1111/cgf.12830 


[EFHLA11] d’Eon, E. , Francois, G. , Hill, M. , Letteri, J. and 
Aubry, J. (2011), An Energy-Conserving Hair Reflectance 
Model. Computer Graphics Forum, 30: 1181-1187. 
doi:10.1111/j.1467-8659.2011.01976.x 


Principled Volume 


The Principled Volume 
shader combines all 


Y Principled Volume 


volume shading eles 
components into a single Color aah 
easy to use node. Volumes Color Attribute 

like smoke and fire can be Density 

rendered with a single Density Attribu... density 

shader node, which Anisotropy 

includes scattering, Absorption Colo 


absorption and blackbody Emission Strength 0.000 


emission. Emission Color Lee 


Blackbody Intensity 0.000 


Temperature 1000.000 


Temperature A... temperature 


Inputs 


Color 
Volume scattering color. 


Color Attribute 
Volume grid for coloring the volume. Use “color” for 
smoke simulations. 


Density 
Density of the volume. 


Density Attribute 
Volume grid to define the density, typically “density”. 


Anisotropy 
Backward or forward scattering direction. 


Absorption Color 
Volume shadow color tint. 


Emission Strength 
Amount of light to emit. 


Emission Color 
Emission color tint. 


Blackbody Intensity 
Blackbody emission for fire. Set to 1 for physically 
accurate intensity. 


Blackbody Tint 
Color tint for blackbody emission. 


Temperature 
Temperature in kelvin for blackbody emission, higher 
values emit more. 


Temperature Attribute 
Volume grid to define the temperature, typically 
“temperature”. 


Properties 


This node has no properties. 


Outputs 


Volume 
Standard shader output. 


Examples 


Refraction BSDF 


The Refraction BSDF is used to add 


_. SEREananee na Y Refraction BSDF 
glossy refraction with sharp or 


microfacet distribution, used for BSDF 


materials that transmit light. For best Beckmann : 
results this node should be Color 
considered as a building block and © Mhsagine=RwNd 


not be used on its own, but rather 
mixed with a glossy node using a 
Fresnel factor. Otherwise it will give 
quite dark results at the edges for 
glossy refraction. 


a IOR 1.450 


Normal 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability that light is refracted for each wavelength. 


Roughness 
Influences sharpness of the refraction; perfectly sharp at 
0.0 and smoother with higher values. 


Normal 
Normal used for shading; if nothing is connected the 
default shading normal is used. 


Properties 


Distribution 


Microfacet distribution to use. Sharp results in perfectly 
Sharp refractions, while Beckmann and GGX can use the 
Roughness input for blurry refractions. 


Outputs 


BSDF 
Standard shader output. 


Examples 


Refraction Shader. 


Specular BSDF 


Eevee Only Y Specular BSDF 

The Specular BSDF combines multiple sas 

layers into a single easy to use node. Base. 
Specula 

It is similar to the Principled BSDF Roughnes 0.200 


node but uses the specular workflow 
instead of the metallic. It has far fewer 
parameters and supports less features. 
Both might be merged into one node 
in the future. 


Emissl... 


Transpare 0.000 


Normal 
Clear Coat 0.000 
Clear Coat 0.000 


The specular workflow functions by Sone einneel 
specifying the facing (along normal) Snananiennamnes 
reflection color. The result may not be 
physically plausible because there is 
no energy conservation. 


Inputs 


Base Color 


Diffuse surface color. For conductor materials (metals) it 
should be black. 


Specular 


Amount of specular reflection. Specifies facing (along 
normal) reflectivity. Conductor materials (metals) can 
have colored specular reflection. 


Hint 


To compute this value for a realistic material with a 
known index of refraction, you may use this special 
case of the Fresnel formula: \(specular = ((ior - 1)/(ior + 
1))*2\) 


For example: 


e water: ior = 1.33, specular = 0.02 
e glass: ior = 1.5, specular = 0.04 
e diamond: ior = 2.417, specular = 0.17 


Roughness 


Specifies microfacet roughness of the surface for diffuse 
and specular reflection. 


Hint 
When converting from the older Glossy BSDF node, use 
the square root of the original value. 


Emissive Color 


Color of the emitted light. This light is added to the BSDF 
result. 


Transparency 


Transparency factor. This is the inverse of the alpha 
channel (1 - alpha) you find in an image. Use an Invert 
node to convert alpha to transparency. This will only have 
an effect if the material uses a blend mode other than 
Opaque. 


Normal 
Controls the normals of the base layers. 


Clear Coat 


Extra white specular layer on top of others. This is useful 
for materials like car paint and the like. 


Clear Coat Roughness: 
Roughness of clear coat specular. 


Clear Coat Normal 
Controls the normals of the Clear Coat layer. 


Ambient Occlusion 


Amount of occlusion to apply to indirect lighting. Usually 
a bake ambient occlusion map. The final occlusion factor 
is the minimum of this input and the runtime ambient 
occlusion effect. 


Properties 
This node has no properties. 


Outputs 


BSDF 
Standard shader output. 


Subsurface Scattering 


The Subsurface Scattering node is 
used to add simple subsurface 
multiple scattering, for materials such 
as Skin, wax, marble, milk and others. Random Walk a 
For these materials, rather than light ee 

being reflect directly off the surface, ae 

it will penetrate the surface and 
bounce around internally before 
getting absorbed or leaving the 
surface at a nearby point. 


Y Subsurface Scattering 


BSSRDF 


Radius 


IOR 1.400 


o Anisotropy 0.000 


Normal 


How far the color scatters on average 
can be configured per RGB color 
channel. For example, for skin, red colors scatter further, 
which gives distinctive red-colored shadows, and a soft 
appearance. 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability that light is reflected for each wavelength. 


Scale 
Global scale factor for the scattering radius. 


Radius 
Average distance that light scatters below the surface. 
Higher radius gives a softer appearance, as light bleeds 
into shadows and through the object. The scattering 
distance is specified separately for the RGB channels, to 


render materials such as skin where red light scatters 
deeper. The X, Y and Z values are mapped to the R, G 
and B values, respectively. 


lIOR Cycles Only 
Index of refraction for Subsurface Scattering. 


Anisotropy Cycles Only 
Controls the directionality of subsurface scattering. 


Normal 
Normal used for shading; if nothing is connected the 
default shading normal is used. 


Properties 


Subsurface Method 
Rendering method to simulate subsurface scattering. 


Note 
Eevee does use not support the Random Walk methods. 


Christensen-Burley: 
An approximation to physically-based 
volume scattering. This method is less 
accurate than Random Walk however, 
in some situations this method will 
resolve noise faster. 

Random Walk (Fixed Radius): 


Random Walk: 


Outputs 


BSSRDF 


Examples 


Provides accurate results for thin and 
curved objects. Random Walk uses true 
volumetric scattering inside the mesh, 
which means that it works best for 
closed meshes. Overlapping faces and 
holes in the mesh can cause problems. 
Behaves similarly to Random Walk 
(Fixed Radius) but modulates the 
Radius based on the Color, Anisotropy, 
and JOR. This method thereby attempts 
to retain greater surface detail and 
color than Random Walk (Fixed 
Radius). 


Random walk subsurface scattering. 


Toon BSDF 


Cycles Only 


Y Toon BSDF 


The Toon BSDF is used to create 


Diffuse and Glossy materials with Diffuse 
cartoon light effects. or 


@ Size 0.500 


@ Smooth 0.000 


Normal 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability that light is reflected for each wavelength. 


Size 
Parameter between 0.0 and 1.0 that gives an angle of 
reflection between 0° and 90°. 


Smooth 
This value specifies an angle over which a smooth 
transition from full to no reflection happens. 


Normal 
Normal used for shading; if nothing is connected the 
default shading normal is used. 


Properties 


Component 
The material component to base the toon effect. 


Diffuse: Use shading based on the Diffuse BSDF. 
Glossy: Use shading based on the Glossy BSDF 
for specular reflection. 
Outputs 
BSDF 


Standard shader output. 


Examples 


Example of Toon Shader. 


Translucent BSDF 


The Translucent BSDF is used to add 


. Ce enitineaimntec ; . Y Translucent BSDF 
Lambertian diffuse transmission. 
BSDF 


Normal 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability that light is transmitted for each wavelength. 


Normal 
Normal used for shading; if nothing is connected the 
default shading normal is used. 


Properties 
This node has no properties. 


Outputs 


BSDF 
Standard shader output. 


Examples 


Translucent shader 
behavior. 


Translucent shader 
example. 


sebeneassteabatin BSDF 


transparency without refraction, 
passing straight through the surface, 
as if there were no geometry there. Ll 
Useful with alpha maps, for example. 
This shader affects light paths 

somewhat differently than other 
BSDFs. Note that only pure white transparent shaders are 
completely transparent. 


Y Transparent BSDF 


BSDF 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability for each wavelength that light is blocked or 
passes straight through the surface. 


Properties 
This node has no properties. 


Outputs 


BSDF 
Standard shader output. 


Examples 


Transparent shader 
behavior. 


Transparent shader 
(pure white). 


Transparent shader 
(gray). 


Velvet BSDF 


Cycles Only 


Y Velvet BSDF 


The Velvet BSDF is used to add 


reflection to materials such as cloth. It Color 
is meant to be used together with e Sigma 1.000 
other shaders (such as a Diffuse Normal 

Shader) and is not particularly useful 
on its own. 


Inputs 


Color 
Color of the surface, or physically speaking, the 
probability that light is reflected for each wavelength. 


Sigma 
Variance of the normal distribution, controlling the 


Sharpness of the peak. It can be thought of as a kind of 
roughness. 


Normal 
Normal used for shading; if nothing is connected the 
default shading normal is used. 


Properties 


This node has no properties. 


Outputs 


BSDF 
Standard shader output. 


Examples 


i 


The Velvet shader 
The Velvet shader behavior. 
example. 


Volume Absorption 


The Volume Absorption node allows 
light to be absorbed as it passes 
through the volume. Typical usage for 
this node would be water and colored or im 
glass. ® Density 1.000 


Y Volume Absorption 


Volume 


Inputs 


Color 
Color of the volume. 


Density 
The density of the absorption effect. 


Properties 


This node has no properties. 


Outputs 


Volume 
The Volume Shader output must be plugged into the 
Volume Input of the Material or World Output node. 


Examples 


~ 


aa itor 


Example of Volume Absorption. 


Volume Scatter 


The Volume Scatter node allows light 
to be scattered as it passes through 
the volume. Typical usage would be to 
add fog to a scene. It can also be used or im 
with the Volume Absorption node to e Density 1.000 
create smoke. Anisotrop 0.000 


Y Volume Scatter 


Volume 


Inputs 


Color 
Color of the volume. 


Density 
The density of the scatter effect. 


Anisotropy 
Controls the look of the scatter effect depending on the 
direction of the light passing through it. 


Properties 


Volume 
The Volume Shader output must be plugged into the 
Volume Input of the Material or World Output node. 


Examples 


Example of Volume Scatter. 


Texture 


Brick Texture Node 
Checker Texture Node 
Environment Texture Node 
Gradient Texture Node 
IES Texture Node 

Image Texture Node 
Magic Texture Node 
Musgrave Texture Node 
Noise Texture Node 

Point Density Node 

Sky Texture Node 

Voronoi Texture Node 
Wave Texture Node 
White Noise Texture Node 


Brick Texture Node 


The Brick Texture is used to add a 
procedural texture producing bricks. 


Y Brick Texture 


Offset 


Frequency 2 


Squash 1.000 


Frequency 2 


Vector 


Color2 


Mortar 
Scale 
Mortar Size 
Mortar Smo 
Bias 
Brick Width 
Row Height 


Inputs 


Color 1/2 
Color of the bricks. 


Mortar 
The color of the area between bricks. 


Scale 
Overall texture scale. 


Mortar Size 
The size of the filling between the bricks known as 
“mortar”; 0 means no mortar. 


Mortar Smooth 
Blurs/softens the edge between the mortar and the 
bricks. This can be useful with a texture and 
displacement textures. 


Bias 
The color variation between Co/or 1/2. Values of -1 and 1 
only use one of the two colors; values in between mix the 
colors. 


Brick Width 
The ratio of brick’s width relative to the texture scale. 


Row Height 
The ratio of brick’s row height relative to the texture 
scale. 


Properties 


Offset 
Determines the brick offset of the various rows. 


Frequency 
How often rows are offset; a value of 2 gives an 
even/uneven pattern of rows. 


Squash 
Factor to adjust the brick’s width for particular rows 
determined by the Frequency 


Frequency 
How often rows consist of “squished” bricks. 


Outputs 


Color 
Texture color output. 


Factor 
Mortar mask (1 = mortar). 


Examples 


Brick texture: Colors changed, Squash 0.62, Squash 
Frequency 3. 


Checker Texture Node 


The Checker Texture is used to add a 
checkerboard texture. 


Y Checker Texture 
Color 
Fac @ 


Vector 


Color2 


S Scale 


Inputs 


Vector 
Texture coordinate to sample texture at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


Warning 

This node can have precision issues with some vector 
inputs. See the notes for the White Noise Texture for 
ways to mitigate this issue. 


Color1, Color 2 
Color of the checkers. 


Scale 
Overall texture scale. The scale is a factor of the 
bounding box of the face divided by the scale. For 
example, a scale of 15 will result in 15 alternate patterns 


over the overall UV bounding box. Different patterns 
could be achieved using other nodes to give different 
input patterns to this socket. For example, using the 
Math Node. 


Properties 


This node has no properties. 


Outputs 


Color 
Texture color output. 


Factor 
Checker 1 mask (1 = Checker 1). 


Examples 


Default Checker texture. 


Environment Texture Node 


The Node Environmental 
Texture is used to light 
your scene using an 
environment map image Aly + New 
file as a texture. 


Y Environment Texture 


Linear 


Equirectangular 


Vector 


Inputs 


Vector 
Texture coordinate for texture look-up. If this socket is left 
unconnected, the image is mapped as environment with 
the Z axis as up. 


Properties 


Image 
Image data-block used as the image source. Additional 
settings can be found in Sidebar > Item > Properties: 
These include options to control the alpha channel along 
with addition options for the color space. These addition 
options are documented with the rest of Common Image 
Settings. 


Color Space 
Type of data that the image contains, either Color or Non- 
Color Data. For most color textures the default of Color 


should be used, but in case of e.g. a bump or alpha map, 
the pixel values should be interpreted as Non-Color Data, 
to avoid doing any unwanted color space conversions. 


The list of color spaces depends on the active OCIO 
contig. The default supported color spaces are described 
in detail here: Default OpenColorlO Configuration 


Texture Interpolation 


Interpolation method used for the environment texture. 
The following interpolations are available: 


Linear: Regular quality interpolation. 

Closest: No interpolation, use closest pixel. 

Cubic: Smoother, better quality interpolation. 

Smart: Bicubic when magnifying, otherwise 
Bilinear is used. This is only available 
for OSL. 


Projection Method 


Allows you to use different types of environmental maps. 
The following methods are supported: 


Equirectangular: 
Projection from an Equirectangular 
photo. 

Mirror Ball: Projection from an orthographic photo 
or mirror ball. 


Outputs 


Color 
RGB color from the image. 


Examples 


HDR image from OpenFootage.net. 


Gradient Texture Node 


The Gradient Texture node generates 
interpolated color and intensity values 
based on the input vector. 


Y Gradient Texture 


Color 


Fac @ 


Linear v 


Vector 


Inputs 


Vector 
Texture coordinate to sample texture at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


Properties 
Type 
Controls the type of gradient generated. 
Linear: Directly outputs the input X coordinate. 
Quadratic: Interpolates the input X coordinate 
quadratically. 
Easing: Uses a combination of quadratic and 


linear interpolation to generate a 
smooth gradient from the input X 
coordinate. 

Diagonal: Averages the input X and Y 
coordinates. 


Spherical: Creates an inverse gradient using the 
length of the input vector; the 
maximum value is at (0, 0, 0). 

Quadratic Sphere: 
The same as Spherical, except 
interpolated quadratically. 

Radial: Outputs a value based on the angle of 
the input around the Z axis. 


Outputs 


Color 
Texture color output. 


Factor 
Texture intensity output. 


Examples 


- = J a | 


~~ | 


~- 
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Gradient texture using object coordinates. 


IES Texture Node 


The JES Texture is used to match real 


Vv IES Texture 


IES files store the directional intensity 
distribution of light sources. Internal External 


Fac @ 


Vector 
@ Strength 1.000 


Inputs 


Vector 
Texture coordinate for lookup in the light distribution. 
Defaults to the normal. 


Strength 
Light strength multiplier. 


Properties 


Mode 
The location to load the IES file from. 


Internal: Use IES profile from a file embedded in 
a text data-block in the blend-file, for 
easy distribution. 

External: Load IES profile from a file on the drive. 


Outputs 


Factor 
Light intensity, typically plugged into the Strength input 
of an Emission node. 


Examples 


Lights with different IES profiles. 


Image Texture Node 


The Image Texture is used 
to add an image file as a 
texture. 


Y Image Texture 
Color 


Alpha @ 


Aly + New Open 


Linear 
Flat 
Repeat 


Vector 


Inputs 


Vector 
Texture coordinate for texture look-up. If this socket is left 
unconnected, UV coordinates from the active UV render 
layer are used. 


Properties 


Image 
Image data-block used as the image source. More 
settings can be found in Sidebar > Item > Properties: 
These include options to control the alpha channel along 
with addition options for the color space. These addition 
options are documented with the rest of Common Image 
Settings. 


Interpolation 


Method to scale images up or down for rendering. 


Linear: 
Cubic: 


Closest: 


Smart: 


Projection 


Regular quality interpolation. 
Smoother, better quality interpolation. 
For bump maps this should be used to 
get best results. 

No interpolation, use only closest pixel 
for rendering pixel art. 

Cycles Only Only for Open Shading 
Language. Use cubic interpolation 
when scaling up and linear when 
scaling down, for a better performance 
and sharpness. 


Projection to use for mapping the textures. 


Flat: 
Box: 


Sphere: 


Uses the XY coordinates for mapping. 


Maps the image to the six sides of a 

virtual box, based on the normal, using 

XY, YZ and XZ coordinates depending 

on the side. 

Blend 
For Box mapping, the amount to 
blend between sides of the box, to 
get rid of sharp transitions between 
the different sides. Blending is 
useful to map a procedural-like 
image texture pattern seamlessly on 
a model. 0.0 gives no blending; 
higher values give a smoother 
transition. 


Tube: 


Extension 


Sphere mapping is the best type for 
mapping a sphere, and it is perfect for 
making planets and similar objects. It is 
often very useful for creating organic 
objects. 


Maps the texture around an object like 
a label on a bottle. The texture is 
therefore more stretched on the 
cylinder. This mapping is of course very 
good for making the label on a bottle, 
or assigning stickers to rounded 
objects. However, this is nota 
cylindrical mapping so the ends of the 
cylinder are undefined. 


Extension defines how the image is extrapolated past the 


Original bounds: 


Repeat: 
Extend: 


Clip: 


Color Space 


Will repeat the image horizontally and 
vertically giving tiled-looking result. 
Will extend the image by repeating 
pixels on its edges. 

Clip to the original image size and set 
all the exterior pixels values to 
transparent black. 


Type of data that the image contains, either Color or Non- 
Color Data. For most color textures the default of Color 
should be used, but in case of e.g. a bump or alpha map, 
the pixel values should be interpreted as Non-Color Data, 
to avoid doing any unwanted color space conversions. 


The list of color spaces depends on the active OCIO 
config. The default supported color spaces are described 


in detail here: Default OpenColorlO Configuration 


Alpha 
If the source file has an Alpha (transparency) channel, 
you can choose how the alpha channel is encoded in the 
image. 
Straight Alpha or Premultiplied Alpha 


Outputs 


Color 
RGB color from image. If the image has alpha, the color 
is premultiplied with alpha if the Alpha output is used, 
and unpremultiplied or straight if the Alpha output is not 
used. 


Alpha 
Alpha channel from image. 


Examples 


ae 


Image texture from GoodTextures.com. 


Magic Texture Node 


The Magic Texture node is used to add 
a psychedelic color texture. 


Y Magic Texture 
Color 


Fac @ 


Depth 2 


Vector 
® Scale 5.000 
® Distortion 1.000 


Inputs 


Vector 
Texture coordinate to sample texture at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


Scale 
Scale of the texture. 


Distortion 
Amount of distortion. 


Properties 


Depth 
Number of iterations. 


Outputs 


Color 
Texture color output. 


Factor 
Texture intensity output. 


Examples 


Magic texture: Depth 10, Distortion 2.0. 


Musgrave Texture Node 


The Musgrave Texture node evaluates 
a fractal Perlin noise at the input 


‘YY Musgrave Texture 


texture coordinates. Unlike the Noise ae 
Texture, which is also a fractal Perlin 3D " 
noise, the Musgrave Texture allows nee ; 


greater control over how octaves are 


3 Vector 
combined. 


Scale 5.000 
Detail 2.000 
Dimension 2.000 


Lacunarity 2.000 


Inputs 


The inputs are dynamic, they become available if needed 
depending on the node properties. 


Vector 
Texture coordinate to evaluate the noise at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


W 
Texture coordinate to evaluate the noise at. 


Scale 
Scale of the base noise octave. 


Detail 


Number of noise octaves. The fractional part of the input 
is multiplied by the magnitude of the highest octave. 
Higher number of octaves corresponds to a higher render 
time. 


Dimension 
The difference between the magnitude of each two 
consecutive octaves. Larger values corresponds to 
smaller magnitudes for higher octaves. 


Lacunarity 
The difference between the scale of each two 
consecutive octaves. Larger values corresponds to larger 
scale for higher octaves. 


Offset 
An added offset to each octave, determines the level 
where the highest octave will appear. 


Gain 
An extra multiplier to tune the magnitude of octaves. 


Properties 


Dimensions 
The dimensions of the space to evaluate the noise in. 


1D: Evaluate the noise in 1D space at the 
input W. 

2D: Evaluate the noise in 2D space at the 
input Vector. The Z component is 
ignored. 

3D: Evaluate the noise in 3D space at the 


input Vector. 
4D: 


Evaluate the noise in 4D space at the 
input Vector and the input W as the 
fourth dimension. 


Higher dimensions corresponds to higher render time, so 
lower dimensions should be used unless higher dimensions 
are necessary. 


Type 


Type of the Musgrave texture. 


FBM (Fractal Brownian Motion): 
Produces an unnatural homogeneous 
and isotropic result. Uses an additive 
cascade, the values are simply added 
together. 

Multifractal: The result is more uneven (varies with 
location), more similar to a real terrain. 
Uses a multiplicative cascade. 

Hybrid Multifractal: 
Creates peaks and valleys with 
different roughness values, like real 
mountains rise out of flat plains. 
Combines the additive cascade with a 
multiplicative cascade. 

Ridged Multifractal: 
Creates sharp peaks. Calculates the 
absolute value of the noise, creating 
“canyons”, and then flips the surface 
upside down. 

Hetero Terrain (Heterogeneous Terrain): 
Similar to Hybrid Multifractal creates a 
heterogeneous terrain, but with the 
likeness of river channels. 


Outputs 


Height 
Texture value. 


Examples 


Remapped Musgrave texture such that most values are 
visible. 


Scale 8.440 
Detail 6.600 
Dimension 2.000 


Lacunarity 1,550 


Musgrave 
Nodes for the image to the texture. 
right. 


Musgrave Types 


Different Musgrave types with the same parameters. 


fBM (fractal Multifractal. 
Brownian Motion). 


Heterogeneous 
Terrain. 


Hybrid Multifractal. 


Ridged Multifractal. 


See also 


Displacement 


Noise Texture Node 


The Noise Texture node evaluates a 
fractal Perlin noise at the input texture 
coordinates. 


Y Noise Texture 


Vector 
Scale 5.000 
Detail 2.000 


Roughnes 0.500 


Distortion 0.000 


Inputs 


The inputs are dynamic, they become available if needed 
depending on the node properties. 


Vector 
Texture coordinate to evaluate the noise at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


W 
Texture coordinate to evaluate the noise at. 


Scale 
Scale of the base noise octave. 


Detail 
Number of noise octaves. The fractional part of the input 
Is multiplied by the magnitude of the highest octave. 


Higher number of octaves corresponds to a higher render 
time. 


Roughness 
Blend between a smoother noise pattern, and rougher 
with sharper peaks. 


Distortion 
Amount of distortion. 


Properties 


Dimensions 
The dimensions of the space to evaluate the noise in. 


1D: Evaluate the noise in 1D space at the 
input W. 

2D: Evaluate the noise in 2D space at the 
input Vector. The Z component is 
ignored. 

3D: Evaluate the noise in 3D space at the 
input Vector. 

4D: Evaluate the noise in 4D space at the 


input Vector and the input W as the 
fourth dimension. 


Note 


Higher dimensions corresponds to higher render time, 
so lower dimensions should be used unless higher 
dimensions are necessary. 


Outputs 


Factor 
Value of fractal noise. 


Color 
Color with different fractal noise in each component. 


Examples 


Fac @ 
Color @ 
3D 
Vector 
Scale 5.000 
Detail 16.000 


Roughness 0.500 


Distortion 0.000 


Noise Texture with high detail. 


Notes 


While the noise is random in nature, it follows a certain 
pattern that might not evaluate to random values in some 
configurations. For instance, consider the following 
configuration where a grid of objects have a material that 
evaluates a noise texture at their locations. One might 
expect the objects to have random values since they have 
different locations, but this is not the case. 


An example configuration where the noise evaluates 
to a constant value. 


It seems all objects have a value of 0.5. To understand why 
this happens, let us look at the following plot of a 1D noise 
texture. 


A plot of a 1D noise with zero details and zero 
distortion. 


The horizontal line denotes a value of 0.5 and the vertical 
lines denotes whole numbers assuming a noise scale of 1. 
As can be seen, the noise always intersects the 0.5 line at 
whole numbers. Since the aforementioned objects were 
distributed on a grid and have whole number locations, they 
all evaluate to 0.5. Which explains the issue at hand. 


Generally, any discrete evaluation of noise at integer 
multiples of the reciprocal of the noise scale will always 
evaluate to 0.5. It also follows that evaluations closer to that 
will have values close to 0.5. In such cases, it is almost 
always preferred to use the White Noise Texture. 


Regardless, one can mitigate this issue in a number of ways: 


e Adjust the scale of the noise to avoid aligning the noise 
with the evaluation domain. 

e Add an arbitrary offset to the texture coordinates to 
break the alignment with the evaluation domain. 

e Evaluate the noise at a higher dimension and adjust the 
extra dimension until a satisfactory result is achieved. 


Constant value neta ale 
issue. y adjusting the 
scale. 


Mitigating the issue Mitigating the issue 
by adding an by evaluating ata 
arbitrary offset. higher dimension. 


Similarly, in other configurations, one might experience 
some banding patterns in the noise, where there are bands 
of high contrast areas followed by banding of low contrast 
areas. For instance, planar surfaces that are slightly tilted 
along one of the axis will have such a banding pattern. 


®) 
@ 
Fac @ 


» Viewer 


y Material Output 


Color @ 
3D 
Vector 
e Scale 168.008 
@ Detail 8.008 
@ Roughness 8.580 
@ Distortion 8.000 


An example configuration where the noise have a 
banding pattern. 


This happens because the slight tilt along one of the axis 
causes values along the perpendicular axis to change very 
slowly making the grid structure of the noise more apparent. 
The easiest way to mitigate this issue to rotate the 
coordinates by an arbitrary amount. 


Mitigating the issue by rotating the coordinates by 
an arbitrary amount. 


Point Density Node 


The Point Density node is used to add 
volumetric points for each particle or 
vertex of another object. 


Y Point Density 
Color 
Density @ 
Particle S... Object Ve... 


Object 


Space: Object Sp... v 


Radius 0.300 
Interp... Linear v 
Resolution 100 
Color... Particle Age v 


Vector 


Inputs 


Vector 
Texture coordinate to sample texture at; defaults to 
global position (Position output of Geometry node) if the 
socket is left unconnected. 


Properties 


Point Data 
Where to get points from. 


Particle System 


Use each particle position from the specified particle 
system. 


Object Vertices 
Use each vertex position from the specified object. 


Object 
Which object’s vertices or particle system will be used. 


Particle System 
Particle positions from this system will be used. 


Space 
The coordinate system for mapping points. 


World Space: Map each point exactly where the 
source particle or vertex is. 

Object Space: Fit the points from the source 
particles/vertices inside the bounding 
box of the object with the point density 
texture. 


Radius 
Size of the points. 


Interpolation 
Texel filtering type. 


Closest: No interpolation, use nearest texel. 
Produces blocky looking points. 

Linear: Interpolate linearly between texels, 
producing soft, round points. 

Cubic: Use cubic falloff, producing very soft 


points. Useful when points are very 
densely packed. 


Resolution 


The dimensions of the texture holding the point data. 


Color Source 
Which attribute of the particle system or mesh is used to 
color the output. 


Particle Color Sources 

Particle Age: Lifetime mapped as (0.0 - 1.0) 
intensity. 

Particle Speed: 
Particle soeed (absolute magnitude 
of velocity) mapped as (0.0 - 1.0) 
intensity. 

Particle Velocity: 
XYZ velocity mapped to RGB colors. 


Vertex Color Sources 
Vertex Color: Use a Color Attribute for coloring the 
point density texture. 


Note 

Color Attributes are defined per 
face corner. A single vertex can 
have as many different colors as 
faces it is part of. The actual color 
of the point density texture is 
averaged from all vertex corners. 


Vertex Weight: Use weights from a vertex group as 
intensity values. 


Vertex Normals: 
Use object-space vertex normals as 
RGB values. 


Outputs 


Color 
Texture color output. 


Density 
Density of volume. 


Examples 


Domain object with Point Density texture using 
vertices from ball as points. 


Sky Texture Node 


The Sky Texture node adds a 
procedural Sky texture. 


Y Sky Texture 


Nishita ¥v 


A Nishita not availabi... 


¥ Sun Disc 

Sun Size 0.545° 
Sun Intensi 1.000 
Sun Elevation 15° 
Sun Rotation 0° 
Altitude Om 
Air 

Dust 


Ozone 


Inputs 


Vector 
Texture coordinate to sample texture at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


Properties 


Sky Type 
Sky model to use. 


Preetham: Based on the 1999 paper by Preetham 


et al. 

Hosek/Wilkie: Based on the 2012 paper by Hosek and 
Wilkie. 

Nishita: Improved version of the 1993 model by 
Nishita et al. 


Sun Direction 
Sun direction vector. 


Turbidity 
Atmospheric turbidity. 


e 2: Arctic like 
e 3: clear sky 
e 6: warm/moist day 
e 10: hazy day 
Ground Albedo 
Amount of light reflected from the planet surface back 
into the atmosphere. 


Sun Disc Cycles Only 
Enable/Disable sun disc lighting. 


Sun Size 
Angular diameter of the sun disc (in degrees). 


Sun Intensity 
Multiplier for sun disc lighting. 


Sun Elevation 
Rotation of the sun from the horizon (in degrees). 


Sun Rotation 
Rotation of the sun around the zenith (in degrees). 


Altitude 


The distance from sea level to the location of the 
camera. For example, if the camera is placed on a beach 
then a value of 0 should be used. However, if the camera 
is in the cockpit of a flying airplane then a value of 10 km 
will be more suitable. Note, this is limited to 60 km 
because the mathematical model only accounts for the 
first two layers of the earth’s atmosphere (which ends 
around 60 km). 


Air 
Density of air molecules. 


e Onoair 
e 1 clear day atmosphere 
e 2 highly polluted day 
Dust 
Density of dust and water droplets. 


e 0 no dust 
e 1 clear day atmosphere 
e 5 city like atmosphere 
e 10 hazy day 
Ozone 
Density of ozone molecules; useful to make the sky 
appear bluer. 


e 0 no ozone 
e 1 clear day atmosphere 
e 2 city like atmosphere 


Outputs 


Color 
Texture color output. 


Examples 


Example of Sky Texture. 


See also 


Sun Position add-on 


Voronoi Texture Node 


The Voronoi Texture node evaluates a Worley Noise at the input 
texture coordinates. 


Color 


Position 


v 


Euclidean 
Vector 
Scale 5.000 


Randomn 1.000 


Inputs 


The inputs are dynamic, they become available if needed depending on the node 
properties. 


Vector 
Texture coordinate to evaluate the noise at; defaults to Generated texture coordinates if 
the socket is left unconnected. 


Ww 
Texture coordinate to evaluate the noise at. 


Scale 
Scale of the noise. 


Smoothness 
The smoothness of the noise. 


Smoothness: Smoothness: Smoothness: Smoothness: 
0.0. 0.25. 0.5. 1.0. 


Smoothness: Smoothness: Smoothness: Smoothness: 
0.0. 0.25. 0.5. 1.0. 


Exponent 
Exponent of the Minkowski distance metric. 


Exponent: Exponent: Exponent: Exponent: 
0.5. 1.0. 2.0. 32.0. 
Randomness 


The randomness of the noise. 


ze 


Randomness: Randomness: Randomness: Randomness: 


1.0. 0.5. 0.25. 0.0. 
Properties 
Dimensions 


The dimensions of the space to evaluate the noise in. 


1D: Evaluate the noise in 1D space at the input W. 

2D: Evaluate the noise in 2D space at the input Vector. The Z component 
is ignored. 

3D: Evaluate the noise in 3D space at the input Vector. 

4D: Evaluate the noise in 4D space at the input Vector and the input W as 


the fourth dimension. 


Higher dimensions corresponds to higher render time, so lower dimensions should be 
used unless higher dimensions are necessary. 


Feature 
The Voronoi feature that the node will compute. 


Fl: The distance to the closest feature point as well as its position and 
color. 


Distance. Color. Position. 


F2: The distance to the second closest feature point as well as its position 
and color. 


, a 
* < 

diet 
oe 


Distance. 


Smooth F1: A smooth version of F1. 


Distance. Color. Position. 


Distance to Edge: 
The distance to the edges of the Voronoi cells. 


| 
d 


Distance smaller than 
0.05. 


Distance. 


N-Sphere Radius: 
The radius of the n-sphere inscribed in the Voronoi cells. In other 
words, it is half the distance between the closest feature point and the 
feature point closest to it. 


The n-sphere radius can Node tree for the shader 


be used to create tightly to the left. 
packed n-spheres. 


Distance Metric 
The distance metric used to compute the texture. 


Euclidean: Use the Euclidean distance metric. 

Manhattan: Use the Manhattan distance metric. 

Chebychev: Use the Chebychev distance metric. 

Minkowski: Use the Minkowski distance metric. The Minkowski distance is a 


generalization of the aforementioned metrics with an Exponent as a 
parameter. Minkowski with an exponent of one is equivalent to the 
Manhattan distance metric. Minkowski with an exponent of two is 
equivalent to the Euclidean distance metric. Minkowski with an infinite 
exponent is equivalent to the Chebychev distance metric. 


Minkowski 


Evsonenn Minkowski Minkowski Te 
ae Exponent: Exponent: pikewee 
(Minkowski 1.0 2.0 ee 
Euclidean). 
1/2). (Manhattan). ( ) of Chebychev). 
Outputs 
Distance 
Distance. 


Color 
Cell color. The color is arbitrary. 


Position 
Position of feature point. 


Ww 
Position of feature point. 


Radius 
N-Sphere radius. 


Notes 


In some configurations of the node, especially for low values of Randomness, rendering 
artifacts may occur. This happens due to the same reasons described in the 
in the White Noise Texture page and can be fixed in a similar manner as described there. 


Examples 


y Voronoi Texture vy Voronoi Texture 


Distance @ Distance @ Value @ Value @ 
— es Subtract , Less Than 


Position ©@ Position ©@ 
Clamp Clamp 


2D 2D @ Value @ Value 


Smooth F1 Fl v @® Value e Value 
Euclidean v Euclidean 

@ Vector @ Vector 
Scale 5.000 e Scale 5.000 


The difference between F1 and Smooth F1 can be used to create beveled Voronoi 
cells. 


¥ Voronoi Texture vy Glossy BSDF 
Distance @ Normal 


Color ; 
Power v Invert GGX 


Position 
Clamp Strength 0.200 Color Peo 


3D @ Value e Distance 0.700 Roughness 0.400 


Smooth F1 y @ Value @ Height Normal 


Normal 


Euclidean 


Vector 

Scale 5.000 
Smoothness 0.200 
Randomness 1.000 


Creating a hammered metal shader using the Voronoi Texture node. 


Wave Texture Node 


The Wave Texture node adds 
procedural bands or rings with noise 
distortion. 


Y Wave Texture 


Bands 
Xx 
Sine 
Vector 
Scale 5.000 
Distortion 0.000 
Detail 2.000 


Detail Scale 1.000 
Detail Roug 0.500 
Phase Offse 0.000 


Inputs 


Vector 
Texture coordinate to sample texture at; defaults to 
Generated texture coordinates if the socket is left 
unconnected. 


Scale 
Overall texture scale. 


Distortion 
Amount of distortion of the wave. 


Detail 


Amount of distortion noise detail. 


Detail Scale 
Scale of distortion noise. 


Roughness 
Blend between a smoother noise pattern, and rougher 
with sharper peaks. 


Phase Offset 
Position of the wave along the Bands Direction. This can 
be used as an input for more control over the distortion. 


Properties 


Type 
Bands or Rings shaped waves. 


Bands/Rings Direction 
The axis the bands or rings propagate from i.e. which 
axis they are perpendicular to. When using Bands a 
Diagonal axis is an option and when using Rings the rings 
can propagate outwards from a single point by using 
Spherical direction. 


Wave Profile 
Controls the look of the wave type. 


Saw: Uses a sawtooth profile. 

Sine: Uses the standard sine profile. 
Outputs 
Color 


Texture color output. 


Texture intensity output. 


Factor 


Examples 


M 


= 


| 
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i 
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y 
NS 
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Wave Texture. 


White Noise Texture Node 


The White Noise Texture node returns a random number 
based on an input Seed. The seed can be a number, a 2D 
vector, a 3D vector, or a 4D vector; depending on the 
Dimensions property. The output number ranges between 
zero and one. 


Y White Noise Texture 


Value @ 


Color 


oe 


Inputs 


The inputs are dynamic, they become available if needed 
depending on the node properties. 


Vector 
Vector used as seed in 2D, 3D, and 4D dimensions. 


W 
Value used as seed in 1D and 4D dimensions. 


Properties 


Dimensions 
The dimensions of the space to evaluate the noise in. 


1D: 
2D: 


3D: 
4D: 


Outputs 


Value 


The W input is used as seed. 

The X and Y components of the Vector 
input are used as seed. 

The Vector input is used as seed. 

Both the Vector input and the W input 
are used as seed. 


Output random value. 


Color 


Output random color. 


Notes 


The slightest difference in seed values would result in 
completely different outputs. Consequently, bad precision 
may have significant impact on the output. Usually, we can 
mitigate this issue by: 


e Eliminating the problematic seed value. If the 
problematic seed value is constant, it should be 
eliminated by choosing a lower dimension or multiplying 


it by zero. 


e Adding an arbitrary value to the seed. The issue might 
only happen at certain boundaries, like unit boundaries, 
So simply adding an arbitrary value might solve the 


issue. 


e Taking the absolute value of the seed. In computing, 
zero may be positive or negative, so taking the absolute 
values unifies the zero into a single value. 


Precision issue due 
to signed zeros on 
the Z axis. 


Mitigating the issue 
by adding an 
arbitrary value. 


Examples 


Mitigating the issue 
by eliminating the Z 
axis. 


Mitigating the issue 
by taking the 
absolute value. 


Generating cell noise using the Snap vector 
operation and the White Noise node. 


Color 


Bright/Contrast Node 
Gamma Node 

Hue Saturation Value Node 
Invert Node 

Light Falloff Node 

Mix Node 

RGB Curves Node 


Bright/Contrast Node 


Y Bright/Contrast 
Image 


¥Y Convert Premulti... 


a Bright 0.000 
@ Contrast 0.000 


Inputs 


Image 
Standard color input. 


Brightness 
An additive-type factor by which to increase the overall 
brightness of the image. Use a negative number to 
darken an image. 


Contrast 
A scaling type factor by which to make brighter pixels 
brighter, but keeping the darker pixels dark. Higher 
values make details stand out. Use a negative number to 
decrease the overall contrast in the image. 


Properties 


Convert Premultiplied 


By default, it is supposed to work in premultiplied alpha. 
If the Convert Premul checkbox is not enabled, it is 
supposed to work in straight alpha. 


See Alpha Channel. 


Outputs 


Image 
Standard color output. 


Notes 


It is possible that this node will put out a value set that has 
values beyond the normal range, i.e. values greater than 
one and less than zero. If you will be using the output to mix 
with other images in the normal range, you should clamp 
the values using the Map Value node (with the Min and Max 
enabled), or put through a Color Ramp node (with all normal 
defaults). 


Clamp the values to normal range. 


Either of these nodes will scale the values back to normal 
range. In the example image, we want to intensify the 
specular pass. The bottom thread shows what happens if we 
do not clamp the values; the specular pass has a value 
much less than one in the dark areas; when added to the 
medium gray, it makes black. Passing the brightened image 
through either the Map Value or the Color Ramp node 
produces the desired effect. 


Example 


vy Render Layers CP) y Bright/Contrast 
Image Image 


Alpha @ ize i 
¥ Convert Premul 

Depth @ 
Image 


e Bright 5.000 
Ss Ss Sw e Contrast -10.000 


i \ a ] Y Use Alpha 
a 2 mage 
oe “=z 


& , Scene 


View Layer 


A basic example. 


Gamma Node 


Use this node to apply a gamma 
correction. 


Image 


ca) Gamma 1.000 


Inputs 


Image 
Standard color input. 


Gamma 
An exponential brightness factor. 


Properties 


This node has no properties. 


Outputs 


Image 
Standard color output. 


Examples 


Example of a Gamma node. 


Hue Saturation Value 
Node 


The Hue Saturation Value Node 

applies a color transformation in the 

HSV Color Model. Image 
Image al 


Hue 0.500 


Y Hue Saturation Value 


Saturatio 1.000 
Value 1.000 
Fac 1.000 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 
output image. 


Image 
Standard color input. 


Properties 


The transformations are relative shifts. In the shader and 
texture context the following properties are available as 
input sockets. 


Hue 


Specifies the hue rotation of the image. 360° are mapped 
to (0 to 1). The hue shifts of 0 (-180°) and 1 (+180°) 
have the same result. 


Saturation 
A saturation of 0 removes hues from the image, resulting 
in a grayscale image. A shift greater than 1.0 increases 
saturation. 


Value 
Value is the overall brightness of the image. 
De/Increasing values shift an image darker/lighter. 


Outputs 


Image 
Standard color output. 


Hue/Saturation Tips 


Some things to keep in mind that might help you use this 
node better: 


Hues are vice versa 
A blue image, with a Hue setting at either end of the 
spectrum (0 or 1), is output as yellow (recall that white, 
minus blue, equals yellow). A yellow image, with a Hue 
setting at 0 or 1, is blue. 


Hue and Saturation work together. 
So, a Hue of 0.5 keeps the blues the same shade of blue, 
but Saturation can deepen or lighten the intensity of that 
color. 


Gray & White are neutral hues 
A gray image, where the RGB values are equal, has no 
hue. Therefore, this node can only affect it with Value. 


This applies to all shades of gray, from black to white; 
wherever the values are equal. 


Changing the effect over time 
The Hue and Saturation values can be animated with a 
Time Node or by animating the property. 


Note 

Tinge 

This HSV node simply shifts hues that are already there. To 
colorize a gray image, or to add a tint to an image, use a 


Mix node to add in a static color from an RGB input node 
with your image. 


HSV Example 


A basic example. 


¥ Hue Saturatior 


Imag 
Hue 0.500 
Saturation 0.100 


Value 0.300 


¥ vu 


y Viewer Image 


@ RGB 
ci Alpha 


Alpha 


Mask @ 


ox : @ Use Alpha 


1.000 


Motion Blur 1.000 


¥ Use Alpha 


Imi 


e Alpha 1.000 


4 1.000 


An example of using the Factor input for masking. 


Invert Node 


The Invert Node inverts the colors in 
the input image, producing a 
negative. 


Y Invert 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 
output image. 


Color 
Standard color input. 


Properties 


In the compositing context this node has the following 
properties. 


RGB 
De/activation of the color channel inversion. 


Alpha 
De/activation of the alpha channel inversion. 


Outputs 


Color 
Standard color output. 


Example 


@ | Hue 0.500 
@ | Saturation 0.100 
@ [Value 0.300 
@ Fac 


© 


_ 


@ Use Alpha 
Image 

e Alpha 1.000 

ez 1.000 


@% Use Alpha 
Image 

© Alpha 1.000 

1.000 


The Invert node is used to invert the mask. 


Light Falloff Node 


Cycles Only 


The Light Falloff node allows you to 
manipulate how light intensity 
decreases over distance. In reality 
light will always fall off quadratically; 


¥Y Light Falloff 


Quadratic @ 


Linear @ 


however, it can be useful to Silicnl | 
manipulate as a non-physically-based @ Strength 100.000 
lighting trick. Note that using Linear @ Smooth 0.000 


or Constant falloff may cause more 
light to be introduced with every 
global illumination bounce, making 
the resulting image extremely bright if many bounces are 
used. 


Inputs 


Strength 
Light strength before applying falloff modification. 


Smooth 
Smooth intensity of light near light sources. This can 
avoid harsh highlights, and reduce global illumination 
noise. 0.0 corresponds to no smoothing; higher values 
smooth more. The maximum light strength will be 
strength/smooth. 


Properties 


This node has no properties. 


Outputs 


Quadratic 
Quadratic light falloff; this will leave strength unmodified 
if smooth is 0.0 and corresponds to reality. 


Linear 
Linear light falloff, giving a slower decrease in intensity 
over distance. 


Constant 
Constant light falloff, where the distance to the light has 
no influence on its intensity. 


Examples 


Todo <2.8 add. 


Mix Node 


The Mix Node mixes images by © 
working on the individual and 
corresponding pixels of the two input 


Image 


images. Called “Mix Color” in the Mix aX 
shader, geometry, and texture cane 
context. 
@ 
Important whip 


Image 


As of Blender 3.4 this node has 
been updated in Shader and 
Geometry node editors. Files saved 
with the new node are not forward compatible. 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output image. 

Image 
The background image. The image size and resolution 
sets the dimensions of the output image. 


Image 
The foreground image. 


Properties 


Mix 
The Blend modes can be selected in the select menu. 
See Color Blend Modes for details on each blending 
mode. 


Add, Subtract, Multiply, Screen, Divide, Difference, 
Darken, Lighten, Overlay, Color Dodge, Color Burn, Hue, 
Saturation, Value, Color, Soft Light, Linear Light 


Use Alpha 
If activated, by clicking on the Color and Alpha icon, the 
Alpha channel of the second image is used for mixing. 
When deactivated, the default, the icon background is a 
light gray. The alpha channel of the base image is always 
used. 


Clamp 
Limit the output value between 0.0 and 1.0. 


Outputs 


Image 
Standard color output. 


Examples 


Below are samples of common mix modes and uses, mixing 
a color or checker with a mask. 


Some explanation of the mixing methods above might help 
you use the Mix node effectively: 


Add 
Adding blue to blue keeps it blue, but adding blue to red 
makes purple. White already has a full amount of blue, so 
it stays white. Use this to shift a color of an image. 
Adding a blue tinge makes the image feel colder. 


Subtract 
Taking Blue away from white leaves Red and Green, 
which combined make Yellow. Taking Blue away from 
Purple leaves Red. Use this to desaturate an image. 
Taking away yellow makes an image bluer and more 
depressing. 


Multiply 


Black (0.0) times anything leaves black. Anything times 
White (1.0) is itself. Use this to mask out garbage, or to 
colorize a black-and-white image. 


Hue 
Shows you how much of a color is in an image, ignoring 
all colors except what is selected: makes a monochrome 
picture (style ‘Black & Hue’). 


Mix 
Combines the two images, averaging the two. 


Lighten 
Like bleach makes your whites whiter. Used with a mask 
to lighten up a little. 


Difference 
It takes out a color. The color needed to turn Yellow into 
White is Blue. Use this to compare two very similar 
images to see what had been done to one to make it the 
other; sort of like a change log for images. You can use 
this to see a watermark (See Watermark images) you 
have placed in an image for theft detection. 


Darken 
With the colors set here, it’s like looking at the world 
through rose-colored glasses. 


Note 


Only add, subtract, multiply and divide are suitable for 
Scene Referenced images. 


Contrast Enhancement 


Here is a small node tree showing the effects of two other 
common uses for the RGB Curve: Darken and Contrast 
Enhancement. You can see the effect each curve has 
independently, and the combined effect when they are 
mixed equally. 


Example node setup showing “Darken”, “Enhance 
Contrast” and “Mix” nodes for composition. 


As you can hopefully see, our original magic monkey was 
overexposed by too much light. To cure an overexposure, 
you must both darken the image and enhance the contrast. 


In the top RGB curve, Darken, only the right side of the 
curve was lowered; thus, any X input along the bottom 
results in a geometrically less Y output. The Enhance 
Contrast RGB (S-shaped) curve scales the output such that 
middle values of X change dramatically; namely, the middle 
brightness scale is expanded, and thus, whiter whites and 


blacker blacks are output. To make this curve, simply click 
on the curve and a new control point is added. Drag the 
point around to bend the curve as you wish. The Mix node 
combines these two effects equally, and Suzanne feels 
much better. 


Watermark Images 


In the old days, a pattern was pressed into the paper mush 
as it dried, creating a mark that identified who made the 
paper and where it came from. The mark was barely 
perceptible except in just the right light. Probably the first 
form of subliminal advertising. Nowadays, people watermark 
their images to identify them as personal intellectual 
property, for subliminal advertising of the author or hosting 
service, or simply to track their image’s proliferation 
throughout the web. Blender provides a complete set of 
tools for you to both encode your watermark and to tell if an 
image has your watermark. 


Encoding your Watermark in an Image 


First, construct your own personal watermark. You can use 
your name, a word, or a shape or image not easily 
replicated. While neutral gray works best using the encoding 
method suggested, you are free to use other colors or 
patterns. It can be a single pixel or a whole gradient; it is up 
to you. In the example below, we are encoding the 
watermark in a specific location in the image using the 
Translate node; this helps later because we only have to 
look at a specific location for the mark. We then use the 
RGB to BW node to convert the image to numbers that the 
Map Value node can use to make the image subliminal. In 
this case, it reduces the mark to one-tenth of its original 
intensity. The Add node adds the corresponding pixels, 


making the ones containing the mark ever-so-slightly 
brighter. 


Embedding your mark in an image using a mark and 
specific position. 


Of course, if you want people to notice your mark, do not 
scale it So much, or make it a contrasting color. There are 
also many other ways, using other mix settings and fancier 


rigs. Feel free to experiment! 
Hint 
Additional uses 


You can also use this technique, using settings that result 
in visible effects, in title sequences to make the words 
appear to be cast on the water’s surface, or as a special 
effect to make words appear on the possessed girl’s 


forearm. 


Decoding an Image for your Watermark 


When you see an image that you think might be yours, use 
the node tree below to compare it to your stock image (pre- 


watermarked original). In this tree, the Mix node is set to 
Difference, and the Map Value node amplifies any 
difference. The result is routed to a viewer, and you can see 
how the original mark clearly stands out. 


Checking an image for your watermark. 


Various image compression algorithms lose some of the 
Original; the difference shows as noise. Experiment with 
different compression settings and marks to see which 
works best for you by having the encoding node group in 
one scene, and the decoding group in another. Use them 
while changing Blender’s image format settings, reloading 
the watermarked image after saving, to get an acceptable 
result. In the example above, the mark was clearly visible all 
the way up to JPEG compression of 50%. 


RGB Curves Node 


The RGB Curves Node allows 
color corrections for each color 
channel and levels 
adjustments in the Standard Filmlike 
compositing context. 

P g mR G B @MOe - 


Y RGB Curves 


Image 


& Fac 


Image 


White Level 


Black Level 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output image. 


Image 
Standard color input. 


Black Level Compositor Only 


Defines the input color that is (linear) mapped to black. 


White Level Compositor Only 
Defines the input color that is (linear) mapped to white. 


Tip 


To define the levels, use the eyedropper to select a color 
sample of a displayed image. 


Properties 


Tone Compositor Only 
Standard: TODO 2.8 
Film Like: TODO 2.8 


Channel 
Clicking on one of the channels displays the curve for 
each. 


C (Combined RGB), R (Red), G (Green), B (Blue) 


Curve 
A Bézier curve that varies the input levels (X axis) to 
produce an output level (Y axis). For the curve controls 
see: Curve widget. 


Outputs 


Image 
Standard color output. 


Examples 


Below are some common curves you can use to achieve 
desired effects. 


From left to right: 1. Lighten shadows 2. Negative 3. 
Decrease contrast 4. Posterize. 


Color Correction using Curves 


Image 
Standard Film like 


CcRicis @©9Ov ex 


) as 


¥Y Use Alpha 
Image 
Alpha 1.000 
z 1.000 


Color correction with curves. 


In this example, the image has too much red in it, so we run 
it through an RGB Curves node and reduce the Red channel. 


Also, read on for examples of the Darken and Contrast 
Enhancement curves, here. 


Color Correction using Black/White Levels 


y RGB Curves 
Image 


Standard Film like 


Gros OOS 


Color correction with Black/White Levels. 


Manually adjusting the RGB curves for color correction can 
be difficult. Another option for color correction is to use the 
Black and White Levels instead, which really might be their 
main purpose. 


In this example, the White Level is set to the color of a 
bright spot of the sand in the background, and the Black 
Level to the color in the center of the fish’s eye. To do this 
efficiently it is best to bring up the Image Editor showing the 
Original input image. You can then use the levels’ color 
picker to easily choose the appropriate colors from the input 
image, zooming into pixel level if necessary. The result can 
be fine-tuned with the R, G, and B curves like in the previous 
example. 


The curve for C is used to compensate for the increased 
contrast that is a side effect of setting Black and White 
Levels. 


Effects 


Image 


vy Render Layers © 


Standard Film like 


Image 


C RG B 


O9Nv ex 


X 1.00000 Y 0.00000 


@ | Fac 1.000 


Image 


Changing colors by inverting the 


¥ Use Alpha 
Image 

Die) Alpha 

® Z 


red channel. 


Vector 


Bump Node 

Displacement Node 
Mapping Node 

Normal Node 

Normal Map Node 

Vector Curves Node 
Vector Displacement Node 
Vector Rotate Node 
Vector Transform Node 


Bump Node 


The Bump node generates a perturbed 
normal from a height texture, for bump 
mapping. The height value will be 
sampled at the shading point and two Invert 
nearby points on the surface to ® Strength 1.000 
determine the local direction of the e GUST aIGG 
normal. @ Height 


Normal 


Normal 


Inputs 


Strength 
Strength of the bump mapping effect, interpolating 
between no bump mapping and full bump mapping. 


Distance 
Multiplier for the height value to control the overall 
distance for bump mapping. 


Height 
Scalar value giving the height offset from the surface at 
the shading point; this is where you plug in textures. 
Normal 
Standard normal input. 


Properties 


Invert 


Invert the bump mapping, to displace into the surface 
instead of out. 


Outputs 


Normal 
Standard normal output. 


Tip 


If the Height input is not connected, the node becomes a 
no-op that outputs its Normal input as is, or defaults to the 
geometry normal if not connected. Routing a node group 


input via a no-op Bump node before doing math effectively 
makes it default to normal. 


Examples 


BSDF 
@ = Roughn 0.000 
@ | Strength 0.400 aE 


o Distance 1.000 


@ Height 


The above node setup will only bump the diffuse part of the 
shader, simulating a bumpy diffuse surface coated with a 
smooth glossy “glaze” layer. 


Displacement Node 


The Displacement node is used to 
displace the surface along the surface 
normal, to add more detail to the 
geometry. Both procedural textures Object Space ¥ 
and baked displacement maps can be e Height 0.000 
used. 


Y Displacement 


Displacement 


2 Midlevel 0.500 


For best results the mesh must be ae 


subdivided finely to bring out the 
detail in the displacement texture. 


Normal 


It is also possible to use the displacement as bump mapping 
only by changing the material settings, so that no high 
resolution mesh is needed. 


See also 


Material Displacement for more details on displacement 
workflows. 


Inputs 


Height 
Distance to displace the surface along the normal. This is 
where a texture node can be connected. 


Midlevel 
Neutral displacement value that causes no displacement. 
With the default 0.5, any lower values will cause the 


surfaces to be pushed inwards, and any higher values 
will push them outwards. 


Scale 
Increase or decrease the amount of displacement. 


Normal 
Standard normal input. 


Properties 


Space 
Object Space means the displacement scales along with 
the object. When using World Space the object scale is 
ignored. 


Outputs 


Displacement 
Displacement offset to be connected into the Material 
Output. 


Examples 


Bump only, displacement only, and displacement 
and bump combined. 


Mapping Node 


The Mapping node transforms the input vector by applying 
translation, rotation, and scaling. 


Y Mapping 


Type: Point 


Vector: 
0.000 
0.000 
0.000 


Location: 


Inputs 


The inputs of the node are dynamic. In particular, the 
Location input is only available in the Texture and Point 
vector types. 


Vector 


The vector to be transformed. 


Location 


The amount of translation along each axis. 


Rotation 


The amount of rotation along each axis. XYZ order. 


Scale 


The amount of scaling along each axis. 


Properties 


Vector Type 


The node applies the transformation differently 
depending on the semantic type of the input vector. 


Point: 


For this vector type, the node performs 
a straightforward transformation. 
Transforming a texture coordinates is 
analogous to transforming a UV map. 
For instance, translating the texture 
coordinates along the positive X axis 
would result in the evaluated texture to 
move in the negative X axis, much like 
if one translated a UV map. Similarly, 
scaling the texture coordinates up 
would result in the evaluated texture to 
scale down. So transforming the 
texture coordinates would appear to 
have the opposite effect on the 
evaluated texture. 

The order of transformation is: Scale -> 
Rotate -> Translate, which means: 


Texture: 


Vector: 


Normal: 


e Translation moves the input along the 
local rotation axis. 

e Rotation rotates the input around the 
origin of the space. 

e Scaling scales the input along the 
global axis. 


For this vector type, the node performs 
an inverse transformation. 
Inverse transforming a texture 
coordinates would, as opposed to the 
Point type, transform the evaluated 
texture itself. For instance, translating 
the texture coordinates along the 
positive X axis would result in the 
evaluated texture to move in the 
positive X axis, aS one would expected. 
Similarly, scaling the texture 
coordinates up would result in the 
evaluated texture to scale up, as one 
would expect. 
The order of transformation is: 
Translate -> Rotate -> Scale, which 
means: 
e Translation moves the input along the 
global axis. 
e Rotation rotates the input around the 
translation vector. 
e Scaling scales the input along the 
local rotation axis. 


For this vector type, a Point 
transformation is performed, but with 
zero translation. 


For this vector type, the node performs 
the inverse transpose of the 
transformation and normalize the 
result. Such transformation ensures 
correct normals after non-uniform 
scaling. So this type should be used 
when transforming normals. 


Outputs 


Vector 
The input vector after transformation. 


Examples 


VvvVvVvVvVvVv 
0660604 
999999 
9999999 
999999D 
999999D 
99999OD 


4, 4y 4» 4 Ay fy 


Mapping node example. 


Normal Node 


The Normal node generates a normal 
vector and a dot product. 


Y Normal 


Normal 


Dot @ 


> 


Inputs 


Normal 
Normal vector input. 


Properties 


Normal Direction 
To manually set a fixed normal direction vector. LMB click 
and drag on the sphere to set the direction of the normal. 
Holding ctrl while dragging snaps to 45 degree rotation 
increments. 


Outputs 


Normal 
Normal vector output. 


Dot 


Dot product output. The dot product is a scalar value. 


e If two normals are pointing in the same direction the 
dot product is 1. 

e If they are perpendicular the dot product is zero (0). 

e If they are antiparallel (facing directly away from 
each other) the dot product is -1. 


Normal Map Node 


The Normal Map node generates a 
perturbed normal from an RGB 
normal map image. This is usually 
chained with an Image Texture node Tangent Space v 
in the color input, to specify the 
normal map image. For tangent space 
normal maps, the UV coordinates for 
the image must match, and the 
image texture should be set to Non- 
Color mode to give correct results. 


Y Normal Map 


Normal 


@ Strength 1.000 


Inputs 


Strength 
Strength of the normal mapping effect. 


Strength is set to 0, 0.5, 1, 2 (from left to right). 


Color 
RGB color that encodes the normal map in the specified 
space. 


Properties 


Space 


The input RGB color can be in one of three spaces: 
Tangent, Object and World space. Tangent space normal 
maps are the most common, as they support object 
transformation and mesh deformations. Object space 
normal maps keep sticking to the surface under object 
transformations, while World normal maps do not. 


UV Map 
Name of the UV map to derive normal mapping tangents 
from. When chained with an Image Texture node, this UV 


map should be the same as the UV map used to map the 
texture. 


Outputs 


Normal 
Normal that can be used as an input to BSDF nodes. 


Example 


Simplified Mesh Simplified Mesh with 
21K Trian 


Normal Map 
les 


21K Triangles gh 


The Normal Map Strength is set to 1. 


Vector Curves Node 


The Vector Curves node maps 
an input vector components to 
a Curve. Vector 


Y Vector Curves 


Use this curve node to slow 
things down or speed them up 
from the original scene. 


Vector: 


Inputs 


In the shader context the node also has an additional Factor 
property. 


Factor 
Controls the amount of influence the node exerts on the 
output vector. 


Vector 
Standard vector input. 


Properties 


Channel 
xX, Y,Z 


Curve 
For the curve controls see: Curve widget. 


Outputs 


Vector 
Standard vector output. 


Vector Displacement Node 


The Vector Displacement node is used 
to displace the surface along arbitrary 
directions, unlike the regular 
Displacement node which only Tangent Space v 
displaces along the surface normal. Puce 


Y Vector Displacement 


Displacement 


3 Midlevel 0.000 


It is typically used to apply vector 
displacement maps created by other 
sculpting software. Vector 
displacement maps can fully represent 
the high resolution detail to be applied on a smooth base 
mesh, unlike regular displacement maps. 


& Scale 1.000 


For best results the mesh must be subdivided finely to bring 
out the detail in the displacement texture. 


See also 


Material Displacement for more details on displacement 
workflows. 


Inputs 


Vector 
Vector specifying the displacement along three axes. This 
is where a texture node can be connected. 


Typically a baked vector displacement image texture is 
used. For Object Space, RGB colors in the image are 
interpreted as an XYZ offset in object space. For Tangent 


Space, R is an offset along the tangent, G along the 
normal and B along the bitangent. 


Midlevel 
Neutral displacement value that causes no displacement. 
With the default 0.0, any lower values will cause the 
surfaces to be pushed inwards, and any higher values 
will push them outwards. 


Scale 
Increase or decrease the amount of displacement. 


Properties 


Space 
Object Space maps work for static meshes, and will 
render slightly faster with less memory usage. Tangent 
Space maps can be used for meshes that will be 
deformed, like animated characters, so the displacement 
follows the deformation. 


Outputs 


Displacement 
Displacement offset to be connected into the Material 
Output. 


Examples 


Regular and exaggerated vector displacement on a 
smooth base mesh. 


Vector Rotate Node 


Y Vector Rotate 


Vector 


Type: Axis Angle v 


Invert 
Vector 


Center: 


The Vector Rotate Node provides the ability to rotate a 
vector around a pivot point (Center). 


Inputs 


Vector 
Vector to be rotated. 


Center 
Point to rotate around. 


Axis 
Axis to rotate around. 


Angle 
Angle to rotate the input vector by. 


Rotation 
When Type is set to Euler, rotate the input vector by 
these angles around the X, Y, then Z axes in that order. 


Properties 


Type 
The type of angle input. 


X/Y/Z Axis: Rotates the vector around the defined 
axis and the amount of rotation is 
defined by the Angle input. 

Axis Angle: Rotates the vector around an arbitrary 
axis defined by the Axis input vector. 
The amount of rotation is defined by 
the Angle input. 

Euler: Rotates the vector about a center point 
defined by the Center input vector. The 
amount of rotation on each axis is 
defined by the Rotation input vector. 


Invert 
Inverts the rotation angle. 


Outputs 


Vector 
The rotated vector. 


Examples 


vy Vector Rotate vy Vector Rotate vy Vector Rotate 


Vector Vector Vector 


Type: Axis Angle + Type: Z Axis Type: XYZ Euler 


Vector Vector Vector 

Center: Center: Center: 
0.000 0.000 0.000 
0.000 0.000 0.000 
0.000 0.000 0.000 

@ Angle : Rotation: 
0.000 X 
1.000 Y 
0.000 Z 
@ Angle 


Vector Rotate node example. 


Vector Transform Node 


The Vector Transform node allows 
converting a vector, point, or normal 
between world and camera and object 
coordinate space. Point [Vector Norm... 


World ¥v 


Y Vector Transform 


Vector 


Object v 


Vector: 
0.500 
0.500 
0.500 


Inputs 


Vector Input 
Standard vector input. 


Properties 

Type 
Specifies the input/output type. 
Vector, Point, Normal. 


Convert From 
Coordinate Space to convert from: 


World, Object, Camera. 


Convert To 
Coordinate Space to convert to: 


World, Object, Camera. 


Outputs 


Vector Output 
The transformed output vector. 


Examples 


Todo <2.8 add. 


Converter 


Blackbody Node 
Clamp Node 


Color Ramp Node 
Combine Color Node 
Combine XYZ Node 
Float Curve 

Map Range Node 
Math Node 

Mix Node 

RGB to BW Node 
Separate Color Node 
Separate XYZ Node 
Shader To RGB 
Vector Math Node 
Wavelength Node 


Blackbody Node 


The Blackbody node converts a 
blackbody temperature to RGB value. 
This can be useful for materials that 
emit light at natural occurring @ — Temper 1500.000 
frequencies. 


Y Blackbody 


Color 


Inputs 


Temperature 
The temperature in Kelvin. 


Properties 


This node has no properties. 


Outputs 


Color 
RGB color output. 


Examples 


2-3-4 2-D- 


Example of the color ranges of the Blackbody node. 


Clamp Node 


The Clamp node clamps a value 
between a minimum and a maximum. 


Y Clamp 


Result @ 


Min Max 


Value 


Inputs 


Value 
The input value to be clamped. 


Min 
The minimum value. 


Max 
The maximum value. 


Properties 


Clamp Type 
Method to clamp. 


Min Max: Constrain values between Min and Max. 

Range: Constrain values between Min and Max. 
When Min is greater than Max, 
constrain between Max and Min 
instead. 


Outputs 


Result 
The input value after clamping. 


Examples 


The Voronoi Texture node outputs a value whose minimum 
is zero. We can use the Clamp node to clamp this value such 
that the minimum is 0.2. 


y Voronoi Texture 


Distance @ Result @ 


Color 
Position ©® 
3D 
Fl 
Euclidean 
@ Vector 
Scale 5.000 


Example of Clamp node. 


Color Ramp Node 


The Color Ramp Node is 
used for mapping values 
to colors with the use of a image 

gradient. Alpha @ 


Y ColorRamp 


Inputs 


Factor 
The Factor input is used as an index for the color ramp. 


Properties 


Color Ramp 
For controls see Color Ramp Widget. 


Outputs 


Image 
Standard color output. 


Alpha 


Standard alpha output. 


Examples 


Creating an Alpha Mask 


An often overlooked use case of the Color Ramp is to create 
an alpha mask, or a mask that is overlaid on top of another 
image. Such a mask allows you to select parts of the 
background to be shown through. 


Using the Color Ramp node to create an alpha mask. 


In the map above, a black-and-white swirl image, which is 
lacking an alpha channel, is fed into the Color Ramp node as 
a Factor. 


The Color Ramp node is set to a purely transparent color on 
the left end of the gradient, and a fully red color on the 
right. As you can see in the Viewer node, the Color Ramp 
node puts out a mask that is fully transparent where the 
image is black. Black is zero, so Color Ramp outputs the 
color at the left end of the gradient, which is set to 
transparent. The Color Ramp image is fully red and opaque 
where the image is white (which is 1). 


You can verify that the output image mask is indeed 
transparent by overlaying it on top of another image. 


Colorizing an Image 


In this example multiple colors are added to the color 
gradient converting a black-and-white image into a flaming 
swirl. 


1) 


Image 


Alpha @ 


Depth @ 


The shades of gray in the input image are mapped to three 
colors: blue, yellow, and red, all fully opaque (alpha of 1). 
Where the image is black, Color Ramp substitutes blue (the 
first color stop). Where it is some shade of gray, Color Ramp 
outputs a corresponding color from the gradient (bluish, 


yellow, to reddish). Where the image is fully white, the Color 
Ramp outputs red. 


Combine Color Node 


The Combine Color Node combines an v Combine Color 
image from its composite color 

channels. The node can combine 
multiple Color Models depending on v 
the Mode property. 


Color 


Inputs 


The outputs of this node depends on the Mode property (see 
below). 


Alpha 
The color channel that that is responsible for the image’s 
transparency. 


Properties 
Mode 
The color model to output. 
RGB: Combine the three inputs: Red, Green, 
and Blue color channels into a single 
color. 


HSV: 


Combine the three inputs: Hue, 
Saturation, and Value color channels 
into a single color. 

HSL: Combine the three inputs: Hue, 
Saturation, and Lightness color 
channels into a single color. 


Output 


Color 
Standard color output. 


Combine XYZ Node 


The Combine XYZ Node combines a 

vector from its individual 

components. ca 
0.000 


Y Combine XYZ 


0.000 
0.000 


Inputs 


eee 
N ~< xX 


Properties 


This node has no properties. 


Output 


Vector 
Standard vector output. 


Note 


The vector is not normalized. 


Float Curve 


The Float Curve node maps 
an input float to a curve 
and outputs a float value. 


Y Float Curve 


Value @ 


ONe -v 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output value. 


Value 
Standard float input. 


Properties 


Curve 
For the curve controls see: Curve widget. 


Outputs 


Float 
Standard float output. 


Map Range Node 


The Map Range node remaps a value 
from a range to a target range. 


Y Map Range 


Result @ 


Float v 


Linear v 


¥ Clamp 


Value 1.000 
From Min 0.000 
From Max 1.000 
To Min 0.000 
To Max 1.000 


Inputs 


Value/Vector 
The input value or vector to be remapped. 


From Min 
The lower bound of the range to remap from. 


From Max 
The higher bound of the range to remap from. 


To Min 
The lower bound of the target range. 


To Max 
The higher bound of the target range. 


Steps 
The number of values allowed between To Min and To 
Max when using Stepped Linear interpolation. A higher 
value will give a smoother interpolation while lower 
values will progressively quantize the input. 


Properties 


Data Type 
Map Range supports both Float and Vector data types. 
Changing the data type will also update the sockets to 
reflect the data type chosen. 


Interpolation Type 
The mathematical method used to transition between 
gaps in the numerical inputs. 


Linear: Linear interpolation between From Min 
and From Max values. 

Stepped Linear: 
Stepped linear interpolation between 
From Min and From Max values. 

Smooth Step: Smooth Hermite edge interpolation 
between From Min and From Max 
values. 

Smoother Step: 
Smoother Hermite edge interpolation 
between From Min and From Max 
values. 


Clamp 
If enabled, the output is clamped to the target range. 


Outputs 


Result/Vector 
The input value after remapping. 


Examples 


The Noise Texture node outputs a value in the range [0, 1]. 
We can use the Map Range node to remap this value into 
the range [-1, 1]. 


Fac @ Result @ 


Color @ 
¥ Clamp 


Position Vector From Min 0.000 
@ Scale 5.000 From Max 1.000 
e Detail 2.000 To Min -1.000 
8 Distortion 0.000 To Max 1.000 


Example of Map Range node. 


Math Node 


The Math Node performs math 


operations. 
Value @ 


v 


Clamp 


o Value 0.500 
@ Value 0.500 


Inputs 


The inputs of the node are dynamic. Some inputs are only 
available in certain operations. For instance, the Addend 
input is only available in the Multiply Add operator. 


Value 
Input Value. Trigonometric functions read this value as 
radians. 


Addend 
Input Addend. 


Base 
Input Base. 


Exponent 
Input Exponent. 


Epsilon 
Input Epsilon. 


Distance 
Input Distance. 


Min 
Input Minimum. 


Max 
Input Maximum. 


Increment 
Input Increment. 


Scale 
Input Scale. 


Degrees 
Input Degrees. 


Radians 
Input Radians. 


Properties 


Operation 


The mathematical operator to be applied to the input 


values: 


Functions 
Add: 
Subtract: 


Multiply: 
Divide: 


Multiply Add: 


The sum of the two values. 

The difference between the two 
values. 

The product of the two values. 

The division of the first value by the 
second value. 

The sum of the product of the two 
values with Addend. 


Power: 
Logarithm: 
Square Root: 
Inverse Square 


Absolute: 


Exponent: 


Comparison 
Minimum: 


Maximum: 


Less Than: 


Greater Than: 


Sign: 


Compare: 


The Base raised to the power of 
Exponent. 

The log of the value with a Base as 
its base. 

The square root of the value. 

Root: 

One divided by the square root of 
the value. 

The input value is read without 
regard to its sign. This turns 
negative values into positive values. 
Raises Euler’s number to the power 
of the value. 


Outputs the smallest of the input 
values. 

Outputs the largest of two input 
values. 

Outputs 1.0 if the first value is 
Smaller than the second value. 
Otherwise the output is 0.0. 
Outputs 1.0 if the first value is larger 
than the second value. Otherwise 
the output is 0.0. 

Extracts the sign of the input value. 
All positive numbers will output 1.0. 
All negative numbers will output 
-1.0. And 0.0 will output 0.0. 
Outputs 1.0 if the difference 
between the two input values is less 
than or equal to Epsilon. 


Smooth Minimum: 


Smooth Minimum. 


Smooth Maximum: 


Smooth Maximum. 


Rounding 


Round: 
Floor: 
Ceil: 
Truncate: 
Fraction: 


Modulo: 


Wrap: 


Snap: 


Ping-pong: 


Trigonometric 


Sine: 
Cosine: 
Tangent: 
Arcsine: 
Arccosine: 


Arctangent: 


Arctan2: 


Rounds the input value to the 
nearest integer. 

Rounds the input value down to the 
nearest integer. 

Rounds the input value up to the 
nearest integer. 

Outputs the integer part of the 
value. 

Returns the fractional part of the 
value. 

Outputs the remainder once the first 
value is divided by the second 
value. 

Outputs a value between Min and 
Max based on the absolute 
difference between the input value 
and the nearest integer multiple of 
Max less than the value. 

Rounds the input value down to the 
nearest integer multiple of 
Increment. 

The output value is moved between 
0.0 and the Scale based on the input 
value. 


The Sine of the input value. 

The Cosine of the input value. 

The Tangent of the input value. 
The Arcsine of the input value. 
The Arccosine of the input value. 
The Arctangent of the input value. 
Outputs the Inverse Tangent of the 
first value divided by the second 
value measured in radians. 


Hyperbolic Sine: 
The Hyperbolic Sine of the input 
value. 

Hyperbolic Cosine: 
The Hyperbolic Cosine of the input 
value. 

Hyperbolic Tangent: 
The Hyperbolic Tangent of the input 


value. 
Conversion 
To Radians: Converts the input from degrees to 
radians. 
To Degrees: Converts the input from radians to 
degrees. 
Clamp 


Limits the output to the range (0.0 to 1.0). See Clamp. 


Outputs 


Value 
Numerical value output. 


Mix Node 


The Mix Node mixes values, colors and vectors inputs using 
a factor to control the amount of interpolation. The Color 
mode has additional blending modes. 


Result @ Result @ 


Float Vector 


Y Clamp Factor Uniform 
Y Clamp Factor Clamp Result 
Y Clamp Factor 


Factor 1.000 


Important 


This is a new node as of Blender 3.4. The previous Mix RGB 
node is automatically converted to the Color version of this 
node in Shader and Geometry node editors. Files saved 
with the new node are not forward compatible. 


Inputs 


Factor 
Controls the amount of mixing between the A and B 
inputs. 


A/B 
The two inputs that are mixed together. 


Properties 


Data Type 
The data type that is used for mixing. The node supports 
float, vector and color data types. 


Factor Mode (Vector only) 
The factor mode can be set to Uniform and Non-Uniform. 
In uniform mode, a single float controls the factor. In non- 
uniform mode, a vector controls the factor for each XYZ 
channel separately. 


Mix (Color only) 
The Blend modes can be selected in the select menu. 
See Color Blend Modes for details on each blending 
mode. 


Add, Subtract, Multiply, Screen, Divide, Difference, 
Darken, Lighten, Overlay, Color Dodge, Color Burn, Hue, 
Saturation, Value, Color, Soft Light, Linear Light 


Clamp Factor 
Limit the factor value between 0.0 and 1.0. If this option 
is unchecked then the node operates using Extrapolation. 


Clamp Result (Color only) 
Limit the Result to the range between 0.0 and 1.0. 


Outputs 


Result 
Output the result of the mix using the data type selected. 


Examples 


See the Color > Mix page for additional examples: Mix Color 
Node 


RGB to BW Node 


The RGB to BW Node maps an RGB color 
image to a gray-scale by the luminance. 


Y RGB to BW 


Inputs 


Image 
Color image input. 


Properties 


This node has no properties. 


Outputs 


Value 
Gray-scale value output. 


Separate Color Node 


The Separate Color Node splits an \ Separate Color 
image into its composite color 
channels. The node can output 
multiple Color Models depending on 
the Mode property. ates 


Red © 
Green © 


Alpha © 


vw 


Inputs 


Color 
Standard color input. 


Properties 
Mode 

The color model to output. 

RGB: Split the input colors into it’s three 
outputs: Red, Green, and Blue color 
channels. 

HSV: Split the input colors into it’s three 


outputs: Hue, Saturation, and Value 
color channels. 

HSL: Split the input colors into it’s three 
outputs: Hue, Saturation, and Lightness 
color channels. 


Outputs 


The outputs of this node depends on the Mode property (see 
above). 


Alpha 
The color channel that that is responsible for the image’s 


transparency. 


Separate XYZ Node 


The Separate XYZ Node splits a 
vector into its individual components. 


v Separate XYZ 


Vector: 
0.000 
0.000 
0.000 


Input 


Vector 
Standard vector input. 


Properties 


This node has no properties. 


Outputs 


eee 
N ~< &X 


Shader To RGB 


Beas i Y Shader to RGB 

The Shader to RGB node is typically Color 
used for non-photorealistic rendering, Alpha @ 
to apply additional effects on the Shader 


output of BSDFs. For example, a color 
ramp on the output of a diffuse BSDF 
can be used to create a flexible toon 
shader. 


makes the result unpredictable when used in combination 
with effects such as ambient occlusion, contact shadows, 
soft shadows and screen space refraction. 


Some effects require multiple samples to converge, and 
applying arbitrary changes to noisy input may not convert 
to a smooth result. 


Warning 


If a Shader to RGB node is used, any upstream BSDF will 
be invisible to the following effects: 


e Screen Space Reflection 
e Subsurface Scattering 
e Alpha Clip and Alpha Hashed blend modes 


Shader to RGB node doesn’t give expected results in 
render passes. 


Inputs 


Shader 
Any shader such as a BSDF or Emission node can be 


linked here. 


Properties 


This node has no properties. 


Outputs 


Color 
Surface color computed from BSDFs and lighting. 


Alpha 


Alpha transparency from any Transparent BSDFs in the 
input. 


Examples 


Simple toon shading with Shader to RGB and 
Freestyle. 


Vector Math Node 


The Vector Math node performs the 
selected math operation on the input 
vectors. 


Inputs 


The inputs of the node are dynamic. Some inputs are only 
available in certain operations. For instance, the Scale input 
is only available in the Scale operator. 


Vector 
Input vector \(A = \begin{pmatrix} A x\\A y\\A z 
\end{pmatrix}\). 


Vector 
Input vector \(B = \begin{pmatrix} B x \\B_ y\\B z 
\end{pmatrix}\). 


Scale 
Input Scale \(s\). 


Properties 


Operation 


The vector math operator to be applied on the input 


vectors. 


Add: 


Subtract: 


Multiply: 


Divide: 


Multiply Add: 


Cross Product: 


Project: 
Reflect: 


Refract: 


The sum of A and B. \(\begin{pmatrix} 
AX+Bx\AYtBy\N\AZ+B2Z 
\end{pmatrix}\) 

The difference between A and B. \ 
(\oegin{pmatrix} Ax-B x\\Ay-By 
\\A_z - B_z \end{pmatrix}\) 

The entrywise product of A and B. \ 
(\oegin{pmatrix} A_x \cdot B_ x \\A_y 
\cdot B y \\A z \cdot B z 
\end{pmatrix}\) 

The entrywise division of A by B. 
Division by zero results in zero. \ 
(\oegin{pmatrix} Ax/B x\\A y/B_y 
\\A_z/B_z \end{pmatrix}\) 

The entrywise combination of the 
multiply and addition operations. \(A * 
B + C\) 

The cross product of A and B. \ 
(\oegin{pmatrix} A_y \cdot B_z-Az 
\cdot B_y \\A z \cdot B _x - A x \cdot 

B z\\A_x\cdot B y-A y \cdot B x 
\end{pmatrix}\) 

The projection of A onto B. 

The reflection of A around the normal 
B. B need not be normalized. 

For a given incident vector A, surface 
normal B and ratio of indices of 
refraction (IOR), refract outputs the 
refraction vector R. 


Faceforward: 


Dot Product: 


Distance: 
Length: 


Scale: 


Normalize: 


Wrap: 


Snap: 


Floor: 
Ceil: 


Modulo: 
Fraction: 


Absolute: 
Minimum: 


Maximum: 


Orients a vector A to point away from a 
surface B as defined by its normal C. 
Computes \((dot(B, C) < 0) ? A: -A\). 
The dot product of A and B. \(A_x \cdot 
Bx+A y\cdot B y +A z\cdot B Z\) 
The distance between A and B. 

The length of A. \(\sqrt{A_x*2 + A _y*2 
+ A 2*2}\) 

The result of multiplying A by the scalar 
input Scale. \(\begin{ pmatrix} s \cdot 
A x\\s\cdotA y \\s \cdot A z 
\end{pmatrix}\) 

The result of normalizing A. The result 
vector points to the same direction as 
A and has a length of 1. If A is (0, 0, 0), 
the result is (0, 0, 0) as well. 

The entrywise output of a value 
between Min and Max based on the 
absolute difference between the input 
value and the nearest integer multiple 
of Max less than the value. 

The result of rounding A to the largest 
integer multiple of B less than or equal 
A. 

Rounds the input value entrywise down 
to the nearest integer. 

Rounds the input value entrywise up to 
the nearest integer. 

The entrywise modulo of A by B. 
Returns the fractional part of the va/ue 
entrywise. 

The entrywise absolute value of A. 

The entrywise minimum value from A 
and B. 

The entrywise maximum value from A 
and B. 


Sine: The entrywise Sine of A. 


Cosine: The entrywise Cosine of A. 
Tangent: The entrywise Tangent of A. 
Outputs 


The output of the node is dynamic. It is either a vector ora 
scalar depending on the operator. For instance, the Length 
operator has a scalar output while the Add operator has a 
vector output. 


Vector 
Output vector. 


Value 
Output value. 


Wavelength Node 


The Wavelength node converts a 
wavelength value to an RGB value. 
This can be used to achieve a specific 
color on the light spectrum. ° eee 


Y Wavelength 


Color 


Inputs 


Wavelength 
The color wavelength from 380 to 780 nanometers. 


Properties 


This node has no properties. 


Outputs 


Color 
RGB color output. 


Examples 


Example of Wavelength node. 


Group 


Group Nodes are a collection of nodes that can be combined 
into a single node while selectively exposing inputs of the 
embedded nodes. Group nodes can simplify a node tree by 
allowing instancing and hiding parts of the tree. 


Make Group 


Creates a node group from the selected nodes, see Make 
Group for more information. 


Ungroup 


Removes the selected nodes from a group, see Ungroup for 
more information. 


Group Input 


Adds a group input node, this serves as a convenient way to 
re-add the input node in case it is accidentally deleted. 
Note, groups can only have one input, if more than one is 
added they are duplicates of each other. 


Group Output 


Adds a group output node, this serves as a convenient way 
to re-add the output node in case it is accidentally deleted. 
Note, groups can only have one output, if more than one is 
added they are duplicates of each other. 


Node Groups 


This section lists all the node groups either from the current 
blend-file or Linked or Appended from another blend-file. 


Open Shading Language 


Cycles Only 


It is also possible to create your own nodes using Open 
Shading Language (OSL). Note that these nodes will only 
work for CPU rendering; there is no support for running OSL 
code on the GPU. 


To enable it, select Open Shading Language as the shading 
system in the render settings. 


Script Node 


OSL was designed for node-based 
Shading, and each OSL shader 
corresponds to one node in a node 
setup. To add an OSL shader, add a is 
script node and link it to a text data- 
block or an external file. Input and 
output sockets will be created from the 
shader parameters on clicking the update button in the 
Node or the Text editor. 


Y Script 


Internal External 


OSL shaders can be linked to the node in a few different 
ways. With the Internal mode, a text data-block is used to 
store the OSL shader, and the OSO bytecode is stored in the 
node itself. This is useful for distributing a blend-file with 
everything packed into it. 


The External mode can be used to specify a .os1 file from a 
drive, and this will then be automatically compiled into a 
.oso file in the same directory. It is also possible to specify a 


path to a .oso file, which will then be used directly, with 
compilation done manually by the user. The third option is 
to specify just the module name, which will be looked up in 
the shader search path. 


The shader search path is located in the same place as the 
scripts or configuration path, under: 


Linux 
$HOME/.config/blender/3.4/shaders/ 
Windows 


C:\Users\$user\AppData\Roaming\Blender 
Foundation\Blender\3.4\shaders\ 


macOS 


/Users/$USER/Library/App lication 
Support/Blender/3.4/shaders/ 


Tip 


For use in production, we suggest to use a node group to 
wrap shader script nodes, and link that into other blend- 
files. This makes it easier to make changes to the node 
afterwards as sockets are added or removed, without 
having to update the script nodes in all files. 


Writing Shaders 


For more details on how to write shaders, see the OSL 
specification. Here is a simple example: 


shader simple material ( 
color Diffuse Color = color(0.6, 0.8, 0.6), 


float Noise Factor = 0.5, 
output closure color BSDF = diffuse(N) ) 
€ 


color material color = Diffuse Color * mix(1.9, noise(P * 
10.0), Noise Factor); 

BSDF = material color * diffuse(N); 
} 


Closures 


OSL is different from, for example, RSL or GLSL, in that it 
does not have a light loop. There is no access to lights in the 
scene, and the material must be built from closures that are 
implemented in the renderer itself. This is more limited, but 
also makes it possible for the renderer to do optimizations 
and ensure all shaders can be importance sampled. 


The available closures in Cycles correspond to the shader 
nodes and their sockets; for more details on what they do 
and the meaning of the parameters, see the shader nodes 
manual. 


BSDF 


e diffuse(N) 

e oren_nayar(N, roughness) 

e diffuse ramp(N, colors[8]) 

e phong ramp(N, exponent, colors[8]) 
e diffuse toon(N, size, smooth) 

e glossy toon(N, size, smooth) 

e translucent (N) 

e reflection(N) 

e refraction(N, ior) 

e transparent () 

e microfacet ggx(N, roughness) 

e microfacet ggx aniso(N, T, ax, ay) 


e microfacet ggx _refraction(N, roughness, ior) 

e microfacet_beckmann(N, roughness) 

e microfacet beckmann aniso(N, T, ax, ay) 

e microfacet_beckmann_refraction(N, roughness, ior) 
e ashikhmin shirley(N, T, ax, ay) 

e ashikhmin velvet(N, roughness) 


Hair 
e hair _reflection(N, roughnessu, roughnessv, T, offset) 
e hair transmission(N, roughnessu, roughnessv, T, offset) 


e principled hair(N, absorption, roughness, radial roughness, 
coat, offset, IOR) 


BSSRDF 


e bssrdf_cubic(N, radius, texture blur, sharpness) 
e bssrdf_gaussian(N, radius, texture blur) 


Volume 


e henyey_greenstein(g) 
e absorption() 


Other 


e emission() 

e ambient occlusion() 
e holdout() 

e background () 


Attributes 


Some object, particle and mesh attributes are available to 
the built-in getattribute() function. UV maps and Color 
Attributes can be retrieved using their name. Other 
attributes are listed below: 


geom: generated 
Generated texture coordinates. 


geom: uv 
Default render UV map. 


geom:dupli generated 
For instances, generated coordinate from instancer 
object. 


geom:dupli uv 
For instances, UV coordinate from instancer object. 


geom: trianglevertices 
Three vertex coordinates of the triangle. 


geom:numpolyvertices 
Number of vertices in the polygon (always returns three 
currently). 


geom:polyvertices 
Vertex coordinates array of the polygon (always three 
vertices currently). 


geom:name 
Name of the object. 


geom:is curve 
Is object a strand or not. 


geom:curve intercept 
Point along the strand, from root to tip. 


geom: curve thickness 
Thickness of the strand. 


geom:curve tangent normal 
Tangent Normal of the strand. 


path: ray length 
Ray distance since last hit. 


object: Location 
Object location. 


object: index 
Object index number. 


object: random 
Per object random number generated from object index 
and name. 


material:index 
Material index number. 


particle: index 
Particle instance number. 


particle:age 
Particle age in frames. 


particle: lifetime 
Total lifespan of particle in frames. 


particle: Location 
Location of the particle. 


particle:size 
Size of the particle. 


particle:velocity 


Velocity of the particle. 


particle:angular velocity 
Angular velocity of the particle. 


Trace 


We support the trace(point pos, vector dir, ...) function, to 
trace rays from the OSL shader. The “shade” parameter is 
not supported currently, but attributes can be retrieved from 
the object that was hit using the getmessage("trace", ..) 
function. See the OSL specification for details on how to use 
this. 


This function cannot be used instead of lighting; the main 
purpose is to allow shaders to “probe” nearby geometry, for 
example to apply a projected texture that can be blocked by 
geometry, apply more “wear” to exposed geometry, or 
make other ambient occlusion-like effects. 


Color Management 


Color management is important to create renders and 
assets that are physically accurate and look great on 
multiple display devices. It is used both to ensure all parts of 
the pipeline interpret colors correctly, and to make artistic 
changes like exposure and color grading. 


Blender 
’s color 
manag 
ement 
iS 

based 
on the 
OQpenCo 
lorlO 
library. 


Different views and exposures of the same render. 


Same OpenColorlO configuration in multiple applications, 
the same color spaces and transforms will be available for 
consistent results. 


Workflow 


Scene Linear Color Space 


For correct results, different Color Soaces are needed for 
rendering, display and storage of images. Rendering and 
compositing is best done in scene linear color space, which 


corresponds more closely to nature, and makes 
computations more physically accurate. 


PNG Diffuse Texture Rendering & Compositing Monitor, Projector, TV 


am, 


Baked Normal Map OpenEXR Intermediate Movie File, Web Image 


An example of a linear workflow. 


If the colors are linear, it means that if in reality, we double 
the number of photons, the color values are also doubled. 
Put another way, if we have two photos/renders each with 
one of two lights on, and add those images together, the 
result would be the same as a render/photo with both lights 
on. It follows that such a radiometrically linear space is best 
for photorealistic rendering and compositing. 


However, these values do not directly correspond to human 
perception or the way display devices work. and image files 
are often stored in different color spaces. So we have to 
take care to do the right conversion into and out of this 
scene linear color space. 


Display Transforms 


Transforming scene linear colors to display involves both 
technical and artistic choices. 


Correct display of renders requires a conversion to the 
display device color space. A computer monitor works 
differently from a digital cinema projector or HDTV, and so 
needs a different conversion. 


There is also an artistic choice to be made. Partially that is 
because display devices cannot display the full soectrum of 
colors and only have limited brightness, so we can squeeze 
the colors to fit in the gamut of the device. Besides that, it 
can also be useful to give the renders a particular look, e.g. 
as if they have been printed on real camera film. The 
default Filmic transform does this. 


Rendering & Compositing Artistic Look Display Transform Monitor, Projector, TV 


BoE eeee Display Device 
NSS. Gamma 
View 


Conversion from linear to display device space. 


Image Color Spaces 


When loading and saving media formats it is important to 
have color management in mind. File formats such as PNG 
or JPEG will typically store colors in a color space ready for 
display, not in a linear space. When they are used as 
textures in renders, they need to be converted to linear first, 
and when saving renders for display on the web, they also 
need to be converted to a display space. 


For intermediate files in production, it is recommended to 
use OpenEXR files. These are always stored in scene linear 
color spaces, without any data loss. That makes them 
Suitable to store renders that can later be composited, color 
graded and converted to different output formats. 


Images can also contain data that is not actually a color. For 
example normal or displacement maps merely contain 
vectors and offsets. Such images should be marked as Non- 


Color Data so that no color space conversion happens on 
them. 


Render Settings 


Reference 

Editor: Properties 

Panel: Render Properties » Color Management 
These are color ¥ Color Management 
management settings that Display Device sRGB 

are used across Blender. 
These color management View Transform — Filmic 
settings are Scene specific Look None 

so settings can be Exposure 0.000 
customized per Scene. Gamma 1.000 


Color management can 
also be overridden when 
saving images; this loee Plata 
behavior can be set in the 
Output Color Management 
Properties. 


Sequencer 


Color Management properties. 


Display Device 
The device that the image is being viewed on. 


Most computer monitors are configured for the sRGB 
color space, and so when working on a computer usually 
this option should just be left to the default. It would 
typically be changed when viewing the image on another 
display device connected to the computer, or when 
writing out image files intended to be displayed on 
another device. 


SRGB: Used by most displays. 
XYZ: Commonly used by digital projectors. 
None: Disables color management. 


View Transform 
These are different ways to view the image on the same 
display device. 


Standard: Does no extra conversion besides the 
conversion for the display device. Often 
used for non-photorealistic results or 
video editing where a specific look is 
already baked into the input video. 

Filmic: For photorealistic results and better 
handling of high dynamic range colors. 
The contrast can be adjusted by 
changing the Look option for the Filmic 
view transform. 

Filmic Log: Converts to Filmic log color space. This 
can be used for export to color grading 
applications, or to inspect the image by 
flattening out very dark and light areas. 

Raw: Intended for inspecting the image but 
not for final export. Raw gives the 
image without any color space 
conversion. 

False Color: Shows a heat map of image intensities, 
to visualize the dynamic range. 


Look 
Choose an artistic effect from a set of measured film 
response data which roughly emulates the look of certain 
film types. Applied before color space conversion. 


Exposure 


Used to control the image brightness (in stops) applied 
before color space conversion. It is calculated as follows: 
\(output\_value = render\ value x 2“ {(exposure) }\) 


Gamma 
Extra gamma correction applied after color space 
conversion. Note that the default display transforms 
already perform the appropriate conversion, so this 
mainly acts as an additional effect for artistic tweaks. 


Sequencer 
The color space that the Sequencer operates in. By 
default, the Sequencer operates in SRGB space, but it 
can also be set to work in Linear space like the 
Compositing nodes, or another color space. Different 
color spaces will give different results for color correction, 
crossfades, and other operations. 


The list of color spaces depends on the active OCIO 
contig. The default supported color spaces are described 
in detail here: Default OpenColorlO Configuration 


Use Curves 


Adjust RGB Curves to control the image colors before the 
color space conversion. Read more about using the Curve 
Widget. 


Image Files 


When working with image files, the default color space is 
usually the right one. If this is not the case, the color space 
of the image file can be configured in the image settings. A 
common situation where manual changes are needed is 
when working with or baking normal maps or displacement 


maps, for example. Such maps do not actually store colors, 
just data encoded as colors. Those images should be 
marked as Non-Color Data. 


Image data-blocks will always store float buffers in memory 
in the scene linear color space, while a byte buffer in 
memory and files in a drive are stored in the specified color 
space setting. 


By default, only renders are displayed and saved with the 
render View Transformation applied. These images are the 
“Render Result” and “Viewer” image data-blocks, and the 
files saved directly to a drive with the Render Animation 
operator. However, when loading a render saved to an 
intermediate OpenEXR file, Blender cannot detect 
automatically that this is a render (it could be e.g. an image 
texture or displacement map). We need to specify that this 
is a render and that we want the transformations applied, 
with these two settings: 


View as Render 
Display the image data-block (not only renders) with view 
transform, exposure, gamma, RGB curves applied. Useful 
for viewing rendered frames in linear OpenEXR files the 
Same as when rendering them directly. 


Save as Render 
Option in the image save operator to apply the view 
transform, exposure, gamma, RGB curves. This is useful 
for saving linear OpenEXR to e.g. PNG or JPEG files in 
display space. 


OpenColorlO Configuration 


Blender comes with a standard OpenColorlO configuration 
that contains a number of useful display devices and view 
transforms. The reference linear Color Space used is the 
linear color space with Rec. 709 chromaticities and D65 
white point. 


However, OpenColorlO is also designed to give a consistent 
user experience across multiple applications, and for this, a 
single shared configuration file can be used. Blender will use 
the standard OCIO environment variable to read an 
OpenColorlO configuration other than the default Blender 
one. More information about how to set up such a workflow 
can be found on the OpenColorlO website. 


Blender currently use the following color space rules: 


scene linear 
Color space used for rendering, compositing, and storing 
all float precision images in memory. 


data 
Color space for non-color data. 


aces interchange 
ACES2065-1 color space. Used to derive chromaticities of 
the scene _linear color space, for effects such as 
blackbody emission. 


color picking 
Defines the distribution of colors in color pickers. It is 
expected to be approximately perceptually linear, have 
the same gamut as the scene linear color space, map 
0..1 values to 0..1 values in the scene linear color space 
for predictable editing of material albedos. 


default sequencer 


Default color space for the Sequencer, scene _linear if not 
specified. 


default byte 
Default color space for byte precision images and files, 
texture_paint if not specified. 


default_float 
Default color space for float precision images and files, 
scene _linear if not specified. 


The standard Blender configuration includes support for 
Saving and loading images in ACES (code and 
documentation) color spaces. However, the ACES gamut is 
larger than the Rec. 709 gamut, so for best results, an ACES 
specific configuration file should be used. OpenColorlO 
provides an ACES configuration file, though it may need a 
few more tweaks to be usable in production. 


Default OpenColorlO 
Configuration 


Color Spaces 
Blender’s OCIO configuration file is equipped by default 
to read/write files in these color spaces: 


SRGB: Standard RGB display space using Rec. 
709 chromaticities and a D65 white 
point. 

Linear: Blender’s native linear soace meaning 


there is no gamma mapping, using 
Linear Rec. 709 chromaticities and a 
D65 white point. 

Linear ACES: 


Linear ACEScg: 


XYZ: 
Non-Color: 
Raw: 
Filmic Log: 


Filmic SRGB: 


Also known as ACES2065-1, which is an 
ACES color space using the APO color 
primaries, a D60 white point and a 
linear transfer function. This color 
Space is meant to store and transfer 
data with the most amount of possible 
color information. 


An ACES color space that is designed to 
be used for rendering and compositing. 
It uses the AP1 color primaries, a D60 
white point, and a linear transfer 
function. While similar to ACES2065-1, 
this color space has a smaller color 
gamut. The smaller gamut allow it to 
better represent the colors that fit 
inside the CIE 1931 chromaticities 
diagram. Colors that lie outside the CIE 
1931 chromaticities are generally not 
important to rendering and 
compositing because the human 
stimulus cannot represent these colors. 
Standard linear XYZ space. 

Color space used for images which 
contains non-color data (e.g. normal 
maps). 

Does not automatically convert to 
linear; same as Non-Color. 
Intermediate log color space of Filmic 
view transform. 

Similar to SRGB but uses the Filmic 
view transform. 


Freestyle 


Introduction 
o The Big Picture 
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Introduction 


Freestyle is an edge/line-based non-photorealistic (NPR) 
rendering engine. It relies on mesh data and Z-depth information 
to draw lines on selected edge types. Various line styles can be 
added to produce artistic (“hand drawn”, “painted”, etc.) or 
technical (hard line) looks. 


Freestyle can generate a powerful diversity of line styles and 
results. There are currently, two ways to define the way lines 
look; the first uses a series of parameter to create a Line Style. 
This mode allows intuitive editing of features such as dotted 
lines and easy setup of multiple line types and edge definitions. 
On top of all of that, with line style modifiers, the sky is the limit! 


The second method of generating lines is by using Python 
Scripting. This method is much more advanced but Blender 
includes many pre-scripted styles such as Japanese big brush, 
cartoon, blueprint, and thickness-with-depth. 


ATV buggy by 
Rylan Wright 
(RONIN). CC BY. By mato.sus304. CC BY-SA. 
(File: AtvBuggy.Zip) (File: Mato_sus304_cut02.zip) 


A cartoon scene 
from OHA Studio 
© Mechanimotion 
Entertainment. 
(blend-file) 


Blueprint render of Martin 
M-130 from 1935 by 
LightBWK. CCO. Warning: 
heavy file! designed for 
stress test Blender to the 
limits and may crash 
Blender. (File:M- 
130Blueprint.zip) 


The Big Picture 


e Activate Freestyle by the Properties » Render > Freestyle 
checkbox. 

e Freestyle settings are located in the View Layer properties. 

e One view layer can only have one view map. A view map 
holds the edge detection settings (Crease Angle, Culling 
toggle, Face Smoothness toggle, Material Boundaries toggle, 
Sphere Radius, and Kr Derivative Epsilon advanced options). 

e A view map can have multiple Line Sets. 

e A line set controls which line types and selections will be 
rendered, from lines based on your scene. 

e Each line set uses one line style (which can be shared 
between multiple Line Sets). 

e Aline style tells Freestyle how to render the linked Line Sets 
in terms of color, alpha, thickness and other aspects. 


Stroke rendering 
2D line drawing 


Block diagram of Freestyle view map and processes. 


Known Limitations 


e Highly memory demanding: All mesh objects in a view layer 
are loaded at once. 

e Only faced mesh objects are supported. 

e No edges at face intersections are detected yet. 

e Freestyle rendering results do not have any Z depth 
information. 

e Panoramic cameras are not supported. 


Render Properties 


Reference 


Panel: Properties » Render » Freestyle 


Freestyle can be activated with the checkbox in the header 
of the Freestyle panel in the Render tab. 


vY Freestyle 


Line Thickness Mode Absolute Relative 


Line Thickness 1.000 px 


Freestyle Render Properties. 


Line Thickness Mode 
There are two different modes for defining the base line 
thickness: 


Absolute: The line thickness is given by a user- 
specified number of pixels. 
Relative: The unit line thickness is scaled by the 


proportion of the present vertical 
image resolution to 480 pixels. For 
instance, the “unit line thickness” is 1.0 
when the image height set to 480px, 
1.5 with 720px and 2.0 with 960px. 


Line Thickness 
Line thickness to use for rendering (only for Absolute line 
thickness). 


View Layer Properties 


e Freestyle 
o Edge Detection 


e Line Set 
o Visibility 
o Edge Types 
o Face Marks 
o Collection 

e Line Style 
o Introduction 
o Properties 
o Modifiers 


Freestyle 


Reference 


Panel: Properties >» View Layer > Freestyle 


There is only one view map per view layer. It controls the 
edge detection parameters. Freestyle can be 
enabled/disabled per View Layer by toggling the checkbox 
in the panel header. 


Y Freestyle 


Control Mode: Parameter Editor Mode 
View Map Cache 
Edge Detection Options: 
Crease Angle: 134° 
Culling 


Advanced Options 


View Layer: Freestyle panel. 


Control Mode 
Which detected edges are actually rendered, and how, 
can be controlled either through: 


Parameter Editor Mode: 
Lines are rendered via parameters 
defined in a user-friendly interface to 
define and control Line Sets and line 
styles. 
A view map (hence a view layer) can 
have multiple Line Sets, and each line 
set is linked to one line style. 


Python Scripting Mode: 


Lines are rendered via Python scripting, 
powerful but complex. 


View Map Cache 


A 
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An option to reuse a previously computed view map for 
Subsequent rendering. The cache is automatically 
updated when the mesh geometry of the input 3D scene 
has been changed. 


This functionality offers a major performance boost for 
Freestyle animation rendering when the camera-space 
mesh geometry is static, as well as for repeated still 
renders with updates of line stylization options. 


Although the View Map Cache checkbox is a view layer 
option, the cache memory is shared by all view layers 
and scenes. This means that if Freestyle is used for two 
or more view layers (possibly in different scenes through 
the Compositor), then the cached view map for one view 
layer is replaced by a new view map for another view 
layer and hence no performance gain is expected. 


Render Pass 

Freestyle lines will not immediately be visible on top of 
the render image. Instead, Freestyle lines are rendered 
as a Render Pass which can be composited with the 
rendered image with an Alpha Over node. 


Edge Detection 


Crease Angle 


If two adjacent faces form an angle less than the defined 
Crease Angle, the edge between them will be rendered 
when using Crease edge type selection in a line set. The 
value also affects Si/houette edge type selection. 


Culling 
Ignore the edges that are out of view. (Saves some 
processing time and memory, but may reduce the quality 
of the result in some cases.) 


Face Smoothness 
Takes Smooth Shading into account for edges calculation. 


Sphere Radius 
Affects the calculation of curvatures for Ridge, Valley and 
Suggestive Contour edge type selection in a line set. The 
curvature at each vertex is computed by averaging the 
Shape of the surface within the specified radius. 
Increasing the value reduces noise and detail. 
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Derivative Epsilon 

Controls the threshold on the minimum rate of change of 
curvature used to filter the output of the Suggestive 
Contour edge type selection. Increasing the value 
reduces the amount of rendered lines, starting from 
smoother areas of the object (further information in this 
pdf). 


Line Set 


Reference 


Panel: 


Properties >» View Layer » Freestyle Line 


A line set selects, among the lines (edges) detected by 
Freestyle, which ones will be rendered using its attached 
line style, through various methods. 


Y Freestyle Line Set 


LineSet 


Selection By: 
Visibility 
Visibility: 
Visible 
Edge Types: 
Inclusive 
Silhouette 
Border 
Contour 
Suggestive Contour 
Ridge & Valley 
Face Marks: 
Inclusive 
Collection: 


— 
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Face Marks Collection 


Hidden 


Logical OR 


¥Y Crease 


Edge Mark 


External Contour 


Material Boundary 


One Face 


Inclusive 


Freestyle Line Set panel. 


Select By 
Image Border 


Image Border 


QI Range 


Logical AND 


Both Faces 


Exclusive 


Causes Freestyle to only take geometry within the 
image border into consideration for line calculation. 
This reduces render times but increases continuity 


problems when geometry is moved out of and into 
camera view. 


Visibility 


Type 
Determine how to use visibility for feature edge 
selection. 


Visible: Only lines occluded by no surfaces are 
rendered. 
Hidden: Lines occluded by at least one surface 


are rendered. 


Proof of concept of visible and 
hidden edges by LightBWK 
(blend-file). 


QI Range: QI stands for Quantitative Invisibility. 
Lines occluded by a number of surfaces 
in the given range are rendered. 

Start, End 
Min/max number of occluding 
surfaces for a line to be rendered. 


I 


QI Range proof of concept 
demo, Start: 3, End: 7, by 
LightBWK (blend-file). 


Edge Types 


Edge types are basic algorithms for the selection of lines 
from geometry. When using the parameter editor you have 
to choose at least one edge type in order to get a render 
output, but several edge types can be combined in one line 
set. Edge types can also be excluded from calculation by 
pressing the X next to them. 


fenat | 


Examples of some basic edge types: Silhouette 
(green), Crease (black), Border (blue) and Edge 
Marks (red) (blend-file by LightBWK). 


Type 

Silhouette 
Draws silhouettes around your closed objects by 
rendering lines where the surface normal transitions 
between pointing toward and away from the camera. 
It is often good for organic objects (like Suzanne & 
Sphere), and bad for sharp edges, like a box. It cannot 
render open mesh objects like open cylinders and flat 
planes. 


Crease 
Shows only edges whose adjacent faces form an angle 
Sharper than the defined view map’s Crease Angle. 


Crease Angle proof of concept for 121° by 
LightBWK (blend-file). 


Border 
Border shows open mesh edges, i.e. edges that 
belong to only one face. An open cylinder has open 
edges at the top and bottom, and a plane is open all 
around. Suzanne’s eye socket is an open edge. 


Edge Marks 
Renders marked edges. See Edge Marks for details. 


Contour 
Draws lines around each object, separating it from 
other objects behind it, or the scene background. 


External Contour 
Draws lines around all objects, separating them from 
the scene background, but not each other. 


Left pair: Contour; Right pair: External Contour. 


Material Boundary 
Draws lines where two materials meet on the same 
object. 


Suggestive Contour 
Draws some lines which would form the Si/houette of 
the mesh if the view point was shifted. Depends on 
your view map settings for Kr Derivative Epsilon and 
Sphere Radius (further information: File:Manual-2.6- 


Render-Freestyle-PrincetownLinestyle.pdf). 


Ridge & Valley 
Draws lines marking crests of ridges and valleys, i.e. 
places where the surface curvature is at its minimum 
or maximum. Depends on your Sphere Radius view 
map settings. 


Edge Marks 


In Edit Mode you can mark “Freestyle Edges” in the same 
manner you can mark “Seams” for UV unwrapping or 
“Sharp” for edge split. These marked edges are available to 
render when you select Edge Mark. 


This is done as follows: 


1. Select the mesh object and enter Edit Mode. 


2. Select the edges you want to be marked. 
3. Press Ctri-E and select Mark Freestyle Edge. 


Edge marks are useful when you want to draw lines along 
particular mesh edges. The examples below explain the use 
of edge marks. 


Marking Freestyle Edges in Edit Mode; the edge 
marks are highlighted in green. 


With Edge Marks enabled, the previously-marked lines are 
always rendered. You can see the black contour lines and 
the blue lines that are made with edge marks. 


Render without Edge Render with Edge 
Marks. Marks enabled. 


What are edge marks good for? 


e When you need to render marks on an almost-flat plane, 
when other edge types cannot detect any line. 

e When you want full control of edge rendering. Often 
used for edges of squarish shapes. 

e Mark the whole base mesh to be rendered for base 
mesh preview. 


What are edge marks not good for? 


e Round outer edges (use instead Contour/External 
Contour/Silhouette). 


Face Marks 


Face marks are useful for removing lines from certain areas 
of a mesh. 


To set a face mark: 


1. Select a mesh object and enter Edit Mode. 
2. Select the faces you want to be marked. 
3. Press Ctri-F and select Face Data » Mark Freestyle Face. 


In this example, two faces of the default cube are marked 
like the image on the left. On the right is a render without 
face marks activated. 


Render output. 


Marked faces (Edit 
Mode). 


The line selection can be controlled via inclusion and faces 
options: 


Negation 
Whether to include or exclude edges matching defined 
face mark conditions from the line set. 


Condition 
One Face: (De)select all edges which have one or 
both neighbor faces marked. 
Both Faces: (De)select all edges which have both of 


their neighbor faces marked. 


oe 


Inclusive, Both 
Faces. 


Exclusive, One Face. 


Inclusive, One Face. 


Exclusive, Both 
Faces. 


Collection 


Include or exclude objects for line calculation, based on their 
belonging to a Collection. 


Line Set Collection 
The name of the object collection to use. 


Negation 
Whether to include or exclude lines from those objects in 
this line set. 


Line Style 


e Introduction 


Properties 


e Thickness 
e Geometry 
e Texture 


Modifiers 


Color 
Alpha 
Thickness 
Geometry 


Introduction 


In Freestyle, the line style settings define the appearance of 
a line set using five main aspects: Stroke, Color, Alpha, 
Thickness, Geometry, and Texture with each on a separate 
tab. These allow you to get many different styles of renders 
(technical draw, rough sketch, cartoon, calligraphy, etc.). 


You can create as many line styles as you wish, and reuse a 
given line style for several line sets by selecting it from the 
select menu next to its name. 


Note 


Unless otherwise specified, all lengths in line style settings 
are in pixels (either relative or absolute, as specified in the 
core options). 


Line Style Example (blend-file). 


Strokes 


Strokes are the final rendered lines. Yet you can tweak 
them, for example, by removing the ones longer/shorter 
than some threshold, chaining lines into a single stroke or 
breaking a stroke into several ones based on angles, dashed 
pattern, etc. 


Y Freestyle Line Style 
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Strokes Color Alpha Thickness Geometry Te 


Chaining: 


Splitting: 


Line Style: Strokes. 


Caps 
You can choose between three types of line caps: 
Butt: Flat cap, exactly at the point the line 
ends. 
Round: A half circle centered on the end point 
of the line. 


Square: 


A square centered on the end point of 
the line (hence, like the circle, the 
drawn end of the line is slightly 
extended compared to its computed 
value). 


———) 
————t 
Line caps example. 


Chaining 


By default all retrieved lines from the line set are chained 
together. There are two basic chaining methods: 


Method 


Plain: The default chaining method; it creates 
simple chains. 


Sketchy: 


This chaining option allows for 
generating chains of feature edges with 
Sketchy multiple strokes. Basically, it 
generates Round strokes instead of a 
single one. It is only really useful if you 
use some random-driven modifiers in 
the line style! 
Rounds 
It specifies the number of rounds in 
Sketchy strokes. 


Same Object 
If true, only feature edges of the same object are joined. 


Chaining can also be turned off to render each line 
separately, which can be useful for line styles which depend 
on accurate representation of the line set. 


Splitting 


You can split up chains of Freestyle lines by enabling one of 
the following: 


Min/Max 2D Angle 
Splits chains of feature edges when they make a 2D 
angle above (or below) a minimum (or maximum) 
threshold. 


2D Length 
Splits chains when they are longer than the given value. 


Material Boundary 
Splits chains of feature edges if they cross from one 
material to another. 


Split Pattern 


Splits the chains using the given dashed pattern (see also 
Dashed Line). 


Dash 1, 2, 3 
Length of the specified dash for splitting. 


Gap 1, 2, 3 
Length of the specified gap for splitting. 


Sorting 


You can sort the order of your strokes, allowing the lines to 
stack in the order given. 


Sort Key 
A sort key is used to determine the stacking order of 
lines. 


Distance from Camera: 
Lines closer to the camera lie on top of 
further lines. 

2D Length: Longer lines lie on top of shorter lines. 

Projected X/Y: Sort by the projected X or Y value in 
the image coordinate system. 


Integration Type 
Use in tandem with the Sort Key to determine the range 
for sorting. Since the distance of a line from the camera 
may vary over vertices, this option computes the sort key 
for a line from the values computed at individual 
vertices. The value computed for the line is: 


Mean: The mean of the values obtained for 
the vertices. 


Min: The minimum of the values obtained 
for the vertices. 
Max: The maximum of the values obtained 
for the vertices. 
First: The value obtained for the first vertex. 
Last: The value obtained for the last vertex. 
Sort Order 


With the given result you can choose to “Reverse” the 
sort order. 


Selection 


You can also choose to only render selected chains. 


Min/Max 2D Length 
Chains longer and/or shorter than 2D Length. 


Chain Count 
Allows the selection of first N chains. 


Dashed Line 


By enabling the Dashed Line checkbox, you can specify 
three pairs of dash and gap lengths. Dash values define the 
lengths of dash strokes, while gap values specify intervals 
between two dashes. 


If a zero gap is specified, then the corresponding dash is 
ignored even if it has a nonzero value. 


Dashes are treated as separate strokes, meaning that you 
can apply line caps, as well as color, alpha and thickness 
modifiers. 


Dash 1, 2, 3 
Length of the specified dash for dashed lines. 


Gap 1, 2, 3 
Length of the specified gap for dashed lines. 


Color 


In this tab you control the color of your strokes. 
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Strokes Color Alpha Thickness Geometry Texture 
Base Color: 


Modifiers: 


Add Modifier 


Line Style: Color. 


Base Color 
The base color for this line style. 


Modifiers 


Common Options 


Mix 
The modifier output can be mixed with the base property 
using the usual methods (see for example the Mix 
compositing node). 


Influence 
How much the result of this modifier affects the current 
property. 


Color Ramp 
Each modifier has color ramp that maps the property to a 
stroke color. 


Types 


Along Stroke 

Crease Angle 
Curvature 3D 
Distance from Camera 
Distance from Object 
Material 

Noise 

Tangent 


Alpha 


In this tab you control the alpha (transparency) of your 
strokes. 


Y Freestyle Line Style 


@?~ LineStyle { (G 


Strokes Color Alpha Thickness Geometry Texture 
Base Transparency: Alpha Transparency: 1.000 


Modifiers: 


Add Modifier 


Line Style: Alpha. 


Base Transparency 
The base alpha for this line style. 


Modifiers 


Common Options 


Mix 
The modifier output can be mixed with the base property 
using the usual methods (see for example the Mix 
compositing node). 


Influence 


How much the result of this modifier affects the current 
property. 


Mapping 
Either a linear progression (from 0.0 to 1.0), or a custom 
mapping curve. 


Note 


Note the linear non-inverted option is equivalent to “do 
nothing”, as original values from materials are already 
in the (0.0 to 1.0) range. That is the case for: Crease 
Angle, Curvature 3D, Material, Noise, Tangent. 


Invert 
Inverts the Mapping. 


Types 


Along_Stroke 

Crease Angle 
Curvature 3D 
Distance from Camera 
Distance from Object 
Material 


Thickness 


Controls the thickness of the Freestyle strokes. 
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Strokes Color Alpha Thickness Geometry Texture 
Base Thickness: Thickness: 3.000 


Center Inside Outside Relative 


Modifiers: 
Add Modifier 


Line Style: Thickness. 


Base Thickness 
The base thickness for this line style. 


Thickness Position 


Control the position of stroke thickness from the original 
(backbone) stroke geometry. There are four choices: 


Center: The thickness is evenly split to the left 
and right side of the stroke geometry. 

Inside: The strokes are drawn within object 
boundary. 

Outside: The strokes are drawn outside the 
object boundary. 

Relative: Specifies the relative position by a 


number between 0.0 (inside) and 1.0 
(outside), in the Thickness Ratio 
number field just below. 


Note 


The thickness position options are applied only to 
strokes of edge types Si/houette and Border, since 


these are the only edge types defined in terms of the 
object boundary. Strokes of other edge types are always 
drawn using the Center option. 


Modifiers 


Common Options 


Mix 
The modifier output can be mixed with the base property 
using the usual methods (see for example the Mix 
compositing node). 


Influence 
How much the result of this modifier affects the current 
property. 


Types 


Along_Stroke 
Calligraphy 

Crease Angle 
Curvature 3D 
Distance from Camera 
Distance from Object 
Material 

Noise 

Tangent 


Geometry 


In this tab you control the geometry of your strokes. It 
contains only the option to add modifiers. 


As they always completely apply to the strokes’ geometry 
(like object modifiers do). They take the resulting two- 
dimensional strokes from the Freestyle line set and displace 
or deform them in various ways. 


As with other modifier stacks in Blender, they are applied 
from top to bottom. 
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Strokes Color Alpha Thickness Geometry Texture 


Modifiers: 


Add Modifier 


Line Style: Geometry. 


Modifiers 


Types 


2D Offset 

2D Transform 
Backbone Stretcher 
Bézier Curve 
Blueprint 

Guiding Lines 
Perlin Noise 1D 
Perlin Noise 2D 
Polygonization 


Sampling 
Simplification 

Sinus Displacement 
Spatial Noise 

Tip Remover 


Texture 


Assigns a texture to the Freestyle stroke. 
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Strokes Color Alpha Thickness Geometry | Texture 


Use Nodes Spacing Along Stroke: 1.000 


Go to Linestyle Textures Properties 


Line Style: Texture. 


Use Nodes 


In Cycles textures are defined by means of shader Nodes. 


Spacing Along Stroke 


Allows to set the “pace” of textures mapped along the 


length of strokes. 


Go to Linestyle Textures 


A shortcut to the line style texture properties in the other 
Textures tab of the Properties. Make sure to first enable 


Use Nodes. 


Nodes 


UV Along Stroke Node 


The UV Along Stroke input node is 
maps textures along the stroke 
length, making it possible to mimic 
pencil, paintbrush, and other art 
medium marks. 


Y UV Along Stroke 


UV 


Use Tips 


Note UV Along Stroke Node. 


These UV maps become available 
only during the Freestyle rendering process. Hence, the UV 
Along Stroke node cannot be replaced by the conventional 


UV Map input node which takes an existing UV map 
already defined as part of mesh data. 


Inputs 
This node has no inputs. 
Properties 


Use Tips 
Allows to use lower quarters of a texture image for the 
head and tail tips of a stroke, while the upper half for the 


stroke body. 
Outputs 


UV 
UV maps defined along strokes. 


Line Style Output Node 


The Line Style Output node specifies how to mix the texture 
information into the base color of line styles. 
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Mix v 
Clamp 

Color 
Color Fac 1.000 
Alpha 1.000 
Alpha Fac 1.000 


Line Style Output Node. 


Inputs 


Color 
Color input for the texture. 


Color Factor 
Standard mix factor of the Co/or value. 


Alpha 
Alpha input for the texture. 


Alpha Factor 
Standard mix factor of the Alpha value. 


Properties 


Mix 
The Blend mode can be selected in the select menu. See 
Color Blend Modes for details on each blending mode. 


Clamp 
Limit the highest color value to not exceed 1.0. 


Outputs 


This node has no outputs. 


Example 


The image below shows a typical shader node tree that 
maps a floral texture image along strokes. The UV Along 
Stroke input node retrieves UV maps defined by Freestyle 
along generated strokes, and passes them to the Vector 
input channel of the Image Texture node. A texture image is 
selected in the Image Texture node, and its color is inputted 
to the Alpha channel of the Line Style Output node. Since 
the Alpha Factor is set to one, the texture image replaces 
the base alpha transparency of the active line style (shown 
in the Freestyle Line Style panel). On the other hand, the 
Mix blend mode is selected in the Line Style Output node 
with the Color Factor set to zero, so that the gradient line 
color specified in the active line style is applied along 
strokes. 


Example of Line Style Nodes (blend-file). 


It is noted that the texture image FS _ floral _brush.png shown 
in the screen capture is an example of Freestyle brush 
images with tips. Specifically, the upper half of the image is 
used as a seamless horizontal tile of the stroke body. 
Whereas the parts in the lower half are tips (stroke caps) at 
both ends of the stroke. 


Color Modifiers 


Along_Stroke 

Crease Angle 
Curvature 3D 
Distance from Camera 
Distance from Object 
Material 

Noise 

Tangent 


Along Stroke 


The Along Stroke modifier alters the base property with a 
new one from a given range mapped along each stroke’s 
length. In other words, it applies a gradient along each 
stroke. 


Crease Angle 


A modifier based on the Crease Angle (angle between two 
adjacent faces). If a stroke segment does not lie on a crease 
(i.e. the edge does not have the Crease Angle nature), its 
properties are not touched by the modifier. 


Angle Min, Max 
The range of input values to the mapping. Out-of-range 
crease angle values will be clamped by the Min and Max 
angles and their corresponding property values. 


Crease Angle modifier example by T.K. (blend-file). 


Curvature 3D 


A modifier based on radial curvatures of the underlying 3D 
surface. The curvature of a 2D curve at a point is a measure 
of how quickly the curve turns at the point. The quicker the 
turn is, the larger the curvature is at the point. The 
curvature is zero if the curve is a straight line. Radial 
curvatures are those computed for a 2D curve that appears 
at the cross section between the 3D surface and a plane 
defined by the view point (camera location) and the normal 
direction of the surface at the point. 


For radial curvatures to be calculated (and therefore for this 
modifier to have any effect), the Face Smoothness option 
has to be turned on and the object needs to have Smooth 
Shading. 


Curvature Min, Max 
The limits of the mapping. If the current point of the 
stroke is at Min Curvature or less from the target, it will 
take the start point of the mapping. And conversely, if it 
is at Max Curvature or more from the target, it will take 
the end-point value of the mapping. 


Curvature 3D modifier demo by T.K. (blend-file). 


Distance from Camera 


The Distance from Camera modifier alters the base property 
with a new one from a given range using the distance to the 
active camera. 


Range Min, Max 
The limits of the mapping from “distance to camera” to 
“property in mapping”. If the current point of the stroke 
is at Range Min or less from the active camera or the 
object, it will take the start value. And conversely, if it is 
at Range Max or more from the camera/object, it will take 
the end value. These values are in the current scene’s 
units, not in pixels! 


Fill Range by Selection 
Set the min/max range values from the distances 
between the current selected mesh vertices and the 
camera or the target. 


Distance from Object 


The Distance from Object modifier alters the base property 
with a new one from a given range using the distance to the 
active camera or to a given object as the parameter. 


Target 
The object to measure distance from. 


Range Min, Max 
The limits of the mapping from “distance to camera” to 
“oroperty in mapping”. If the current point of the stroke 
is at Range Min or less from the active camera or the 
object, it will take the start value. And conversely, if it is 
at Max or more from the camera/object, it will take the 
end value. These values are in the current scene’s units, 
not in pixels! 


Fill Range by Selection 
Set the min/max range values from the distances 
between the current selected mesh vertices and the 
camera or the target. 


Material 


The Material modifier alters the base property with a new 
one taken from a given range mapped on the current 
material under the stroke. 


You can use various properties of the materials, among 
which many are mono-component (i.e. give black-and-white 
results). In this case for the color modifier, an optional color 
ramp can be used to map these gray-scale values to colored 
ones. In the reverse case properties of the materials, which 
are multi-components (i.e. give RGB results) the mean value 
will be used for Alpha and Thickness modifiers. 


If used with the Split by Material option in the Stroke tab, 
the result will not be blurred between materials along the 
strokes. 


Material modifiers demo by T.K. (blend-file). 


Noise 


The Noise modifier uses a pseudo-random number 
generator to variably distribute the property along the 
stroke. 


Amplitude 
The maximum value of the noise. A higher amplitude 
means a less transparent (more solid) stroke. 


Period 
The period of the noise. This means how quickly the 
property value can change. A higher value means a more 
smoothly changing color along the stroke. 


Seed 
Seed used by the pseudo-random number generator. 


Asymmetric Thickness only 
Allows the thickness to be distributed unevenly at every 
point. Internally, the stroke is represented as a backbone 
with a thickness to the right and left side. All other 
thickness shaders make sure that the left and right 
thickness values are equal. For the Noise shader 
however, a meaningful (and good-looking) result can be 
created by assigning different values to either side of the 
backbone. 


Effect generated with a noise thickness modifier 
using asymmetric thickness. 


Tangent 


This modifier bases its effect on the traveling direction of 
the stroke evaluated at the stroke’s vertices. 


Alpha Modifiers 


Along_Stroke 

Crease Angle 
Curvature 3D 
Distance from Camera 
Distance from Object 
Material 

Noise 

Tangent 


Along Stroke 


The Along Stroke modifier alters the base property with a 
new one from a given range mapped along each stroke’s 
length. In other words, it applies a gradient along each 
stroke. 


Crease Angle 


A modifier based on the Crease Angle (angle between two 
adjacent faces). If a stroke segment does not lie on a crease 
(i.e. the edge does not have the Crease Angle nature), its 
properties are not touched by the modifier. 


Angle Min, Max 
The range of input values to the mapping. Out-of-range 
crease angle values will be clamped by the Min and Max 
angles and their corresponding property values. 


Crease Angle modifier example by T.K. (blend-file). 


Curvature 3D 


A modifier based on radial curvatures of the underlying 3D 
surface. The curvature of a 2D curve at a point is a measure 
of how quickly the curve turns at the point. The quicker the 
turn is, the larger the curvature is at the point. The 
curvature is zero if the curve is a straight line. Radial 
curvatures are those computed for a 2D curve that appears 
at the cross section between the 3D surface and a plane 
defined by the view point (camera location) and the normal 
direction of the surface at the point. 


For radial curvatures to be calculated (and therefore for this 
modifier to have any effect), the Face Smoothness option 
has to be turned on and the object needs to have Smooth 
Shading. 


Curvature Min, Max 
The limits of the mapping. If the current point of the 
stroke is at Min Curvature or less from the target, it will 
take the start point of the mapping. And conversely, if it 
is at Max Curvature or more from the target, it will take 
the end-point value of the mapping. 


Curvature 3D modifier demo by T.K. (blend-file). 


Distance from Camera 


The Distance from Camera modifier alters the base property 
with a new one from a given range using the distance to the 
active camera. 


Range Min, Max 
The limits of the mapping from “distance to camera” to 
“property in mapping”. If the current point of the stroke 
is at Range Min or less from the active camera or the 
object, it will take the start value. And conversely, if it is 
at Range Max or more from the camera/object, it will take 
the end value. These values are in the current scene’s 
units, not in pixels! 


Fill Range by Selection 
Set the min/max range values from the distances 
between the current selected mesh vertices and the 
camera or the target. 


Distance from Object 


The Distance from Object modifier alters the base property 
with a new one from a given range using the distance to the 
active camera or to a given object as the parameter. 


Target 
The object to measure distance from. 


Range Min, Max 
The limits of the mapping from “distance to camera” to 
“oroperty in mapping”. If the current point of the stroke 
is at Range Min or less from the active camera or the 
object, it will take the start value. And conversely, if it is 
at Max or more from the camera/object, it will take the 
end value. These values are in the current scene’s units, 
not in pixels! 


Fill Range by Selection 
Set the min/max range values from the distances 
between the current selected mesh vertices and the 
camera or the target. 


Material 


The Material modifier alters the base property with a new 
one taken from a given range mapped on the current 
material under the stroke. 


You can use various properties of the materials, among 
which many are mono-component (i.e. give black-and-white 
results). In this case for the color modifier, an optional color 
ramp can be used to map these gray-scale values to colored 
ones. In the reverse case properties of the materials, which 
are multi-components (i.e. give RGB results) the mean value 
will be used for Alpha and Thickness modifiers. 


If used with the Split by Material option in the Stroke tab, 
the result will not be blurred between materials along the 
strokes. 


Material modifiers demo by T.K. (blend-file). 


Noise 


The Noise modifier uses a pseudo-random number 
generator to variably distribute the property along the 
stroke. 


Amplitude 
The maximum value of the noise. A higher amplitude 
means a less transparent (more solid) stroke. 


Period 
The period of the noise. This means how quickly the 
property value can change. A higher value means a more 
smoothly changing color along the stroke. 


Seed 
Seed used by the pseudo-random number generator. 


Asymmetric Thickness only 
Allows the thickness to be distributed unevenly at every 
point. Internally, the stroke is represented as a backbone 
with a thickness to the right and left side. All other 
thickness shaders make sure that the left and right 
thickness values are equal. For the Noise shader 
however, a meaningful (and good-looking) result can be 
created by assigning different values to either side of the 
backbone. 


Effect generated with a noise thickness modifier 
using asymmetric thickness. 


Tangent 


This modifier bases its effect on the traveling direction of 
the stroke evaluated at the stroke’s vertices. 


Thickness Modifiers 


Along Stroke 
Calligraphy 

Crease Angle 
Curvature 3D 
Distance from Camera 
Distance from Object 
Material 

Noise 

Tangent 


Along Stroke 


The Along Stroke modifier alters the base property with a 
new one from a given range mapped along each stroke’s 
length. In other words, it applies a gradient along each 
stroke. 


Calligraphy 


The Calligraphy modifier mimics some broad and flat pens 
for calligraphy. It generates different thickness based on the 
orientation of the stroke. 


Orientation 
The angle (orientation) of the virtual drawing tool, from 
the vertical axis of the picture. For example, an angle of 
0.0 mimics a pen aligned with the vertical axis. Hence, 
the thickest strokes will be the vertical ones i.e. stroke’s 
direction is aligned with the angle, and the thinnest will 
be the horizontal ones i.e. stroke’s direction is 
perpendicular to the angle. 


Calligraphy modifier demo by T.K. (blend-file). 


Crease Angle 


A modifier based on the Crease Angle (angle between two 
adjacent faces). If a stroke segment does not lie on a crease 
(i.e. the edge does not have the Crease Angle nature), its 
properties are not touched by the modifier. 


Angle Min, Max 
The range of input values to the mapping. Out-of-range 
crease angle values will be clamped by the Min and Max 
angles and their corresponding property values. 


Crease Angle modifier example by T.K. (blend-file). 


Curvature 3D 


A modifier based on radial curvatures of the underlying 3D 
surface. The curvature of a 2D curve at a point is a measure 
of how quickly the curve turns at the point. The quicker the 
turn is, the larger the curvature is at the point. The 
curvature is zero if the curve is a straight line. Radial 
curvatures are those computed for a 2D curve that appears 
at the cross section between the 3D surface and a plane 
defined by the view point (camera location) and the normal 
direction of the surface at the point. 


For radial curvatures to be calculated (and therefore for this 
modifier to have any effect), the Face Smoothness option 
has to be turned on and the object needs to have Smooth 
Shading. 


Curvature Min, Max 
The limits of the mapping. If the current point of the 
stroke is at Min Curvature or less from the target, it will 
take the start point of the mapping. And conversely, if it 
is at Max Curvature or more from the target, it will take 
the end-point value of the mapping. 


Curvature 3D modifier demo by T.K. (blend-file). 


Distance from Camera 


The Distance from Camera modifier alters the base property 
with a new one from a given range using the distance to the 
active camera. 


Range Min, Max 
The limits of the mapping from “distance to camera” to 
“property in mapping”. If the current point of the stroke 
is at Range Min or less from the active camera or the 
object, it will take the start value. And conversely, if it is 
at Range Max or more from the camera/object, it will take 
the end value. These values are in the current scene’s 
units, not in pixels! 


Fill Range by Selection 
Set the min/max range values from the distances 
between the current selected mesh vertices and the 
camera or the target. 


Distance from Object 


The Distance from Object modifier alters the base property 
with a new one from a given range using the distance to the 
active camera or to a given object as the parameter. 


Target 
The object to measure distance from. 


Range Min, Max 
The limits of the mapping from “distance to camera” to 
“oroperty in mapping”. If the current point of the stroke 
is at Range Min or less from the active camera or the 
object, it will take the start value. And conversely, if it is 
at Max or more from the camera/object, it will take the 
end value. These values are in the current scene’s units, 
not in pixels! 


Fill Range by Selection 
Set the min/max range values from the distances 
between the current selected mesh vertices and the 
camera or the target. 


Material 


The Material modifier alters the base property with a new 
one taken from a given range mapped on the current 
material under the stroke. 


You can use various properties of the materials, among 
which many are mono-component (i.e. give black-and-white 
results). In this case for the color modifier, an optional color 
ramp can be used to map these gray-scale values to colored 
ones. In the reverse case properties of the materials, which 
are multi-components (i.e. give RGB results) the mean value 
will be used for Alpha and Thickness modifiers. 


If used with the Split by Material option in the Stroke tab, 
the result will not be blurred between materials along the 
strokes. 


Material modifiers demo by T.K. (blend-file). 


Noise 


The Noise modifier uses a pseudo-random number 
generator to variably distribute the property along the 
stroke. 


Amplitude 
The maximum value of the noise. A higher amplitude 
means a less transparent (more solid) stroke. 


Period 
The period of the noise. This means how quickly the 
property value can change. A higher value means a more 
smoothly changing color along the stroke. 


Seed 
Seed used by the pseudo-random number generator. 


Asymmetric Thickness only 
Allows the thickness to be distributed unevenly at every 
point. Internally, the stroke is represented as a backbone 
with a thickness to the right and left side. All other 
thickness shaders make sure that the left and right 
thickness values are equal. For the Noise shader 
however, a meaningful (and good-looking) result can be 
created by assigning different values to either side of the 
backbone. 


Effect generated with a noise thickness modifier 
using asymmetric thickness. 


Tangent 


This modifier bases its effect on the traveling direction of 
the stroke evaluated at the stroke’s vertices. 


Geometry Modifiers 


2D Offset 

2D Transform 
Backbone Stretcher 
Bézier Curve 
Blueprint 
Guiding_Lines 

Perlin Noise 1D 
Perlin Noise 2D 
Polygonization 
Sampling 
Simplification 

Sinus Displacement 
Spatial Noise 

Tip Remover 


2D Offset 


The 2D Offset modifier adds some two-dimensional offsets 
to the stroke backbone geometry. It has two sets of 
independent options/effects: 


Start, End 
These two options add the given amount of offset to the 
start (or end) point of the stroke, along the (2D) normal 
at those points. The effect is blended over the whole 
stroke, if you for example, set only Start to 50, the start 
of the stroke is offset 50 pixels along its normal, the 
middle of the stroke, 25 pixels along its own normal, and 
the end point is not moved. 


xX, Y 
These two options simply add a constant horizontal 
and/or vertical offset to the whole stroke. 


2D Transform 


The 2D Transform modifier applies two-dimensional scaling 
and/or rotation to the stroke backbone geometry. Scale is 
applied before rotation. 


Pivot 
The center (pivot point) of these 2D transformations can 
be: 


Stroke Center: The median point of the stroke. 
Stroke Start: The beginning point of the stroke. 
Stroke End: The end point of the stroke. 


Stroke Point Parameter: 
The Stroke Point Parameter factor 
controls where along the stroke the 
pivot point is (start point if set to 0.0; 
end point if set to 1.0). 


Absolute 2D Point: 
The Pivot X and Y values define the 
position of the pivot point in the final 
render (from the bottom left corner). 


Important 

Currently, you have to take into 
account the real render size, i.e. 
resolution and resolution percentage. 


Scale X, Y 
The scaling factors, in their respective axes. 


Rotation Angle 


The rotation angle. 


2D Transform modifier (blend-file). 


Backbone Stretcher 


The Backbone Stretcher modifier stretches (adds some 
length to) the beginning and end of the stroke. 


Backbone Length 
Length to add to the strokes’ ends. 


Bezier Curve 


The Bézier Curve modifier replaces the stroke by a Bézier 
approximation of it. 


Error 
The maximum distance allowed between the new Bézier 


curve and the original stroke. 


Bézier Curve modifier demo by T.K. (blend-file). 


Blueprint 


The Blueprint modifier produces blueprint-like strokes using 
either circular, elliptical, or square contours. A blueprint 
here refers to those lines drawn at the beginning of free- 
hand drawing to capture the silhouette of objects with a 
simple shape such as circles, ellipses and squares. 


Shape 
Which base shapes to use for this blueprint: Circles, 
Ellipses or Squares. 


Rounds 
How many rounds are generated, as if the pen draws the 
Same stroke several times (i.e. how many times the 
process is repeated). 


Random Radius, Center 
For the Circles and Ellipses shapes. Adds some 
randomness to each round in the relevant aspect. Using 
more than one round with no randomness would be 
meaningless, as they would draw over each other 
exactly. 


Backbone Length, Backbone 
For the Squares shapes. The first adds some extra length 
to each edge of the generated squares (also affected by 
the second parameter). The second adds some 
randomness to the squares. 


Note that the Min 2D Length feature from the Strokes 
settings is quite handy here, to avoid the noise generated 
by small strokes... 


Guiding Lines 


The Guiding Lines modifier replaces a stroke by a straight 
line connecting both of its ends. 


Offset 
Offset the start and end points along the original stroke, 
before generating the new straight one. 


This modifier will produce reasonable results when strokes 
are short enough, because shorter strokes are more likely to 
be well approximated by straight lines. Therefore, it is 
recommended to use this modifier together with one of the 
splitting options (by 2D angle or by 2D length) from the 
Strokes panel. 


Guiding Lines modifier Demo by T.K. (blend-file). 


Perlin Noise 1D 


The Perlin Noise 1D modifier adds one-dimensional Perlin 
noise to the stroke. The curvilinear abscissa (value between 
O and 1 determined by a point’s position relative to the first 
and last point of a stroke) is used as the input to the noise 
function to generate noisy displacements. 


This means that this modifier will give an identical result for 
two strokes with the same length and sampling interval. 


Frequency 
How dense the noise is (kind of a scale factor along the 
stroke). 


Amplitude 
How much the noise distorts the stroke in the Angle 
direction. 


Seed 
The seed of the random generator (the same seed over a 
stroke will always give the same result). 


Octaves 
The “level of detail” of the noise. 


Angle 
In which direction the noise is applied (0.0 is fully 
horizontal). 


Perlin Noise 2D 


The Perlin Noise 2D modifier adds one-dimensional Perlin 
noise to the stroke. The modifier generates noisy 
displacements using 2D coordinates of stroke vertices as 
the input of the noise generator. 


Frequency 
How dense the noise is (kind of a scale factor along the 
stroke). 


Amplitude 
How much the noise distorts the stroke in the Angle 
direction. 


Seed 
The seed of the random generator (the same seed over a 
stroke will always give the same result). 


Octaves 
The “level of detail” of the noise. 


Angle 
In which direction the noise is applied (0.0 is fully 
horizontal). 


Polygonization 


The Polygonization modifier simplifies strokes as much as 


possible (in other words, it transforms smooth strokes into 
jagged polylines). 


Error 
The maximum distance allowed between the new 
simplified stroke and the original one (the larger this 


value is, the more jagged/approximated the resulting 
polylines are). 


Sampling 


The Sampling modifier changes the definition, precision of 
the stroke, for the following modifiers. 


Sampling 
The smaller this value, the more precise are the strokes. 
Be careful; too small values will require a huge amount of 
time and memory during render! 


Simplification 


The Simplification modifier merges stroke vertices that lie 
close to one another, like the Decimate modifier for meshes. 


Tolerance 
Measure for how close points have to be to each other to 


be merged. A higher tolerance means more vertices are 
merged. 


Sinus Displacement 


The Sinus Displacement modifier adds a sinusoidal 
displacement to the stroke. 


Wavelength 
How wide the undulations are along the stroke. 


Amplitude 
How high the undulations are across the stroke. 


Phase 
Allows “offsetting” (“moving”) the undulations along the 
stroke. 


Tip 

The undulations this modifier produces look exactly the 
same at a Phase of 0 and any positive or negative 
multiple of the Wavelength set on the modifier. This can 
be used for rendering short video sequences with wavy 
lines that can then be seamlessly looped without any 
visual jumps in the undulations along the line. 


Sinus Displacement modifier demo by T.K. (blend- 
file). 


Spatial Noise 


The Spatial Noise modifier adds some spatial noise to the 
stroke. Spatial noise displacements are added in the normal 
direction (i.e. the direction perpendicular to the tangent 
line) evaluated at each stroke vertex. 


Amplitude 
How much the noise distorts the stroke. 


Scale 
How wide the noise is along the stroke. 


Octaves 
The level of detail of the noise. 


Smooth 


When enabled, apply some smoothing over the 
generated noise. 


Pure Random 
When disabled, the next generated random value 
depends on the previous one; otherwise they are 
completely independent. Disabling this setting gives a 
more “consistent” noise along a stroke. 


Tip Remover 


The Tip Remover modifier removes a piece of the stroke at 
its beginning and end. 


Tip Length 
Length of stroke to remove at both of its tips. 


Material Properties 


Reference 
Panel: Properties » Material >» Freestyle Line 


Line Color 
Specifies the line colors on a per-material basis. 

Priority 
Specify the ordering of competing line colors at material 
boundaries. 


See also 


A use case of the line color priority is detailed ina 
Freestyle development blog article. 


Python Scripting 


The Python Scripting mode offers full programmable line 
stylizes. In this control mode, all styling operations are 
written as Python scripts referred to as style modules in the 
Freestyle terminology. The input to a style module is a view 
map (i.e. a set of detected feature edges), and the output is 
a set of stylized strokes. 


A style module is composed of successive calls of five basic 
operators: selection, chaining, splitting, sorting and stroke 
creation. The selection operator identifies a subset of input 
feature edges based on one or more user-defined selection 
conditions (predicates). The selected edges are processed 
with the chaining, splitting and sorting operators to build 
chains of feature edges. These operators are also controlled 
by user-supplied predicates and functions in order to 
determine how to transform the feature edges into chains. 
Finally, the chains are transformed into stylized strokes by 
the stroke creation operator, which takes a list of user- 
defined stroke shaders. 


Python style modules are stored within blend-files as text 
data-blocks. External style module files first need to be 
loaded in the Text Editor. Then the select menu within an 
entry of the style module stack allows you to select a 
module from the list of loaded style modules. 


é5 = Freestyle 
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freestyle. chainingiterators ChainSilt 
freestyle. predicates View Map Cache 
NotUP1D 
QuantitativeInvisibilityUP1D 
TrueUP1D Crease Angle: 134° Face Smoothness 


Edge Detection Options: 


Hl Material arie 
freestyle. shaders Culling aterial Boundaries 


BezierCurveShader Advanced Options 
ConstantThicknessShader 


pyMaterialColorShader Style modules: 


¥ ia 


freestyle. types Operators 


A screen capture of a style module cartoon. py loaded 
in the Text Editor (left), as well as Freestyle options 
in the Python Scripting mode in the View Layers 
buttons (right). 


Freestyle for Blender comes with a number of Python style 
modules that can serve as a starting point of your own style 
module writing. See also the section of the Freestyle Python 
API in the Blender Python API reference manual for the full 
detail of style module constructs. 


By T.K. using the By T.K. using the 
Python Scripting Python Scripting 
mode (blend-file, mode (blend-file, 
CCO). CCO). 


Writing Style Modules 


A style module is a piece of code responsible for the 
stylization of Freestyle line drawing. The input of a style 
module is a set of feature edges called view map (ViewMap). 
The output is a set of stylized lines also referred to as 
strokes. A style module is structured as a pipeline of 
operations that allow for building strokes from the input 
edges within the view map. 


There are five kinds of operations (listed with corresponding 
operator functions): 


e Selection Operators.select() 

e Chaining Operators.chain(), 
Operators.bidirectional chain() 
Splitting Operators.sequential split(), 
Operators.recursive split() 

e Sorting Operators.sort() 

e Stroke creation Operators.create() 


The input view map is populated with a set of ViewEdge 
objects. The selection operation is used to pick up 
ViewEdges of interest to artists based on user-defined 
selection conditions (predicates). Chaining operations take 
the subset of ViewEdges and build Chains by concatenating 
ViewEdges according to user-defined predicates and 
functions. The Chains can be further refined by splitting 
them into smaller pieces (e.g. at points where edges make 
an acute turn) and selecting a fraction of them (e.g. to keep 
only those longer than a length threshold). The sorting 
operation is used to arrange the stacking order of chains to 
draw one line on top of another. The chains are finally 
transformed into stylized strokes by the stroke creation 
operation applying a series of stroke shaders to individual 
chains. 


ViewEdges, Chains and Strokes are generically referred to as 
one-dimensional (1D) elements. A 1D element is a polyline 
that is a series of connected straight lines. Vertices of 1D 
elements are called OD elements in general. 


All the operators act on a set of active 1D elements. The 
initial active set is the set of ViewEdges in the input view 
map. The active set is updated by the operators. 


Selection 


The selection operator goes through every element of the 
active set and keeps only the ones satisfying a certain 
predicate. The Operators.select() method takes as the 
argument a unary predicate that works on any Interface1D 
that represents a 1D element. For example: 


Operators.select(QuantitativeInvisibilityUP1D(Q0) ) 


This selection operation uses the QuantitativeInvisibilityUP1D 
predicate to select only the visible ViewEdge (more precisely, 
those whose quantitative invisibility is equal to 0). The 
selection operator is intended to selectively apply the style 
to a fraction of the active 1D elements. 


It is noted that QuantitativeInvisibilityUP1D is a class 
implementing the predicate that tests line visibility, and the 
Operators.select() method takes an instance of the predicate 
class as argument. The testing of the predicate for a given 
1D element is actually done by calling the predicate 
instance, that is, by invoking the _ catt__ method of the 
predicate class. In other words, the Operators.select() 
method takes as argument a functor which in turn takes an 
InterfaceoD object as argument. The Freestyle Python API 
employs functors extensively to implement predicates, as 
well as functions. 


Chaining 


The chaining operators act on the set of active ViewEdge 
objects and determine the topology of the future strokes. 
The idea is to implement an iterator to traverse the 
ViewMap graph by marching along ViewEdges. The iterator 
defines a chaining rule that determines the next ViewEdge to 
follow at a given vertex (See ViewEdgeIterator). Several such 
iterators are provided as part of the Freestyle Python API 
(See ChainPredicateIterator and ChainSilhouetteIterator). 
Custom iterators can be defined by inheriting the 
ViewEdgeIterator Class. The chaining operator also takes as 
argument a UnaryPredicate working on Interface1D aS a 
stopping criteria. The chaining stops when the iterator has 
reached a ViewEdge satisfying this predicate during the march 
along the graph. 


Chaining can be either unidirectional Operators.chain() or 
bidirectional Operators.bidirectional_ chain(). In the latter 
case, the chaining will propagate in the two directions from 
the starting edge. 


The following is a code example of bidirectional chaining: 


Operators.bidirectional chain( 
ChainSilhouettelIterator(), 
NotUP1D(QuantitativeInvisibilityUP1D(0)), 
) 


The chaining operator uses the ChainSilhouetteIterator as the 
chaining rule and stops chaining as soon as the iterator has 
come to an invisible ViewEdge. 


The chaining operators process the set of active ViewEdge 
objects in order. The active ViewEdges can be previously 
sorted using the Operators.sort() method (see below). It 
starts a chain with the first ViewEdge of the active set. All 


ViewEdges that have already been involved in the chaining 
process are marked (in the case of the example above, the 
time stamp of each ViewEdge is modified by default), in order 
not to process the same ViewEdge twice. Once the chaining 
reaches a ViewEdge that satisfies the stopping predicate, the 
chain is terminated. Then a new chain is started from the 
first unmarked ViewEdge in the active set. This operation is 
repeated until the last unmarked ViewEdge of the active set 
was processed. At the end of the chaining operation, the 
active set is set to the Chains that have just been 
constructed. 


Splitting 


The splitting operation is used to refine the topology of each 
Chain. Splitting is performed either sequentially or 
recursively. Sequential splitting Operators.sequentialSplit() in 
its basic form, parses the Chain at a given arbitrary 
resolution and evaluates a unary predicate (working on OD 
elements) at each point along the Chain. Every time the 
predicate is satisfied, the chain is split into two chains. At 
the end of the sequential split operation, the active set of 
chains is set to the new chains. 


Operators.sequentialSplit(TrueUPOD(), 2) 


In this example, the chain is split every 2 units. A more 
elaborated version uses two predicates instead of one: One 
to determine the starting point of the new chain and the 
other to determine its ending point. This second version can 
lead to a set of Chains that are disjoint or that overlap if the 
two predicates are different (See Operators.sequentialSplit () 
for more details). 


Recursive splitting Operators. recursiveSplit() evaluates a 
function on the OD elements along the Chain at a given 


resolution and find the point that gives the maximum value 
for the function. The Chain is then split into two at that 
point. This process is recursively repeated on each of the 
two new Chains, until the input Chain satisfies a user- 
specified stopping condition. 


func = Curvature2DAngleFOD() 
Operators.recursive split(func, NotUP1D(HigherLengthUP1D(5)), 
5) 


In the code example above, the Chains are recursively split 
at points of the highest 2D curvature. The curvature is 
evaluated at points along the Chain at a resolution of 5 
units. Chains shorter than 5 units will not be split anymore. 


Sorting 


The sorting operator Operators.sort() arranges the stacking 
order of active 1D elements. It takes as argument a binary 
predicate used as a “smaller than” operator to order two 1D 
elements. 


Operators.sort(Length2DBP1D() ) 


In this code example, the sorting uses the Length2DBP1D 
binary predicate to sort the Interface1D objects in the 
ascending order in terms of 2D length. 


The sorting is particularly useful when combined with causal 
density. Indeed, the causal density evaluates the density of 
the resulting image as it is modified. If we wish to use such 
a tool to decide to remove strokes whenever the local 
density is too high, it is important to control the order in 
which the strokes are drawn. In this case, we would use the 
sorting operator to ensure that the most “important” lines 
are drawn first. 


Stroke Creation 


Finally, the stroke creation operator Operators.create() takes 
the active set of Chains as input and build Strokes. The 
operator takes two arguments. The first is a unary predicate 
that works on Interface1D that is designed to make a last 
selection on the set of chains. A Chain that does not satisfy 
the condition will not lead to a Stroke. The second input is a 
list of shaders that will be responsible for the shading of 
each built stroke. 


Shaders list = [ 
SamplingShader(5.0), 
ConstantThicknessShader(2), 
ConstantColorShader(0.2,0.2,0.2,1), 


] 
Operators.create(DensityUP1D(8,0.1, IntegrationType.MEAN) , 
Shaders list) 


In this example, the DensityUP1D predicate is used to remove 
all Chains whose mean density is higher than 0.1. Each 
chain is transformed into a stroke by resampling it so as to 
have a point every 5 units and assigning to it a constant 
thickness of 2 units and a dark gray constant color. 


User Control on the Pipeline Definition 


Style module writing offers different types of user control, 
even though individual style modules have a fixed pipeline 
structure. One is the sequencing of different pipeline control 
structures, and another is through the definition of functor 
objects that are passed as argument all along the pipeline. 


Different pipeline control structures can be defined by 
sequencing the selection, chaining, splitting, and sorting 


operations. The stroke creation is always the last operation 
that concludes a style module. 


Predicates, functions, chaining iterators, and stroke shaders 
can be defined by inheriting base classes and overriding 
appropriate methods. See the reference manual entries of 
the following base classes for more information on the user- 
scriptable constructs. 


See also 


Predicates, functions, chaining iterators, and stroke 
shaders can be defined by inheriting base classes and 
overriding appropriate methods. See Freestyle python module 
for more information on the user-scriptable constructs. 
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Introduction 


Renders can be separated into layers, to composite them 
back together afterwards. 


Some example usages are applying compositing effects to 
characters separately, blurring the background and 
foreground layers separately for depth of field, or rendering 
different lighting variations of the same scene. 


Using View Layers can also save you from having to re- 
render your entire image after each change, allowing you to 
instead re-render only the layer(s) that you have altered. 


View Layers 


ila v View Layer (CG 


View Layers. 


In the top of the screen there is a list of all the View Layers 
in the active scene. 


Name 
The name of the active view layer, click to edit the name. 


Add View Layer 
Will add a new view layer to the active scene. 


New 
Adds a new view layer. 


Copy Settings 


Adds a new view layer with all the settings of current 
view layer. 


Blank 
Adds a new view layer with all collections disabled. 


Remove View Layer 
Will remove the selected view layer from the active 
scene. 


Note 
A scene must have at least one view layer. 


Usage 


Each Scene has an associated set of Collections. The 
visibility settings of each collection can be changed per 
View Layer to separate the rendering of different objects 
and lights into layers. 


Collections 


Per collection you can adjust the way how the render engine 
needs to render the objects inside. Based on the render 
engine different options can be set. 


Visibility 


vas 


ila] View Layer Disable from View Layer 


Set Holdout 
ID Data 


Set Indirect Only 


Open Shading Language 


Collection/View layer settings. 


Disable from View Layer 
Remove this collection from the active view layer. 
Objects that are only in this collection will not be 
rendered for the active view layer. This is useful to 
sometimes leave out some object influence for a 
particular view layer. 


Enable in View Layer 
Add this collection to the active view layer. Objects inside 
the collection will be rendered with the active view layer. 


Set Holdout 
Objects inside this collection will generate a 
holdout/mask in the active view layer. 


Clear Holdout 
Clear the Set Holdout flag. 


Set Indirect Only Cycles Only 
Objects inside this collection will only contribute to the 
final image indirectly through shadows and reflections. 


Clear Indirect Only Cycles Only 
Clear the Indirect Only flag. Objects inside this collection 
will contribute normally to the final image. 


Cycles 


Reference 


Panel: View Layers > Layer 


This section covers only the Render Layer settings 
appropriate for the Cycles renderer. For the engine- 
independent settings, see this section. 


Filter 


Include 
Environment 


Disables rendering the Environment render pass in the 
final render. 


Surfaces 
Disables rendering object materials in the final render. 


Curves 
Disables rendering curve strands in the final render. 


Volume 
Disables rendering Volumes in the final render. 


Use 
Motion Blur 
Render motion blur for this Layer, if enabled in the 
Render Settings. 


Override 


Material Override 


Overrides all materials in the render layer. 


Samples 
View layer samples to override the scene samples. 
Controlled by the layer samples in the Sampling panel. 


View Layer 


Reference 


Panel: Properties >» Scene > View Layer 


5 Scene ila] View Layer 


Ww La yer 


Use for Rendering # * 


Render Single Layer 
¥ Passes 


Combined @ * rial let 


a: 
1 
i 
ts 


Mist . Normal 
Ambient Occlusi.. . Subsurface Direct 


Subsurface Color 


View Layer panel (shown here for the Eevee render 
engine). 


The Layer Panel shows the settings of the active View Layer. 


Use for Rendering 
The active view layer will be used during rendering. 


Render Single Layer 
Only render the active view layer. 


Note 


This option is ignored when rendering from the 
command line. 


See also 


Additional options shown in this panel are different for 
each render engine. See Render Passes for the options per 
render engine. 


Passes 


Reference 


Panel: Scene > View Layers » Passes 


Passes can be used to split rendered images into colors, 
direct and indirect light to edit them individually, and also to 
extract data such as depth or normals. 


Data 


Cycles 


Include 
Combined 
The final combination of render passes with 
everything included. 


Distance to any visible surfaces. 


Note 


The Z pass only uses one sample. When depth 
values need to be blended in case of motion blur or 
Depth of Field, use the mist pass. 


Mist 
Distance to visible surfaces, mapped to the 0.0 - 1.0 
range. When enabled, settings are in World tab. This 


pass can be used in compositing to fade out objects 
that are farther away. 


Position 
World position of objects in the scene. 


Normal 
Surface normal used for shading. 


Vector 
Motion vectors for the Vector Blur node. The four 
components consist of 2D vectors giving the motion 
towards the next and previous frame position in pixel 
Space. 


UV 
Mapped UV coordinates, used to represent where on a 
mesh a texture gets mapped too. This is represented 
through the red and green channels of the image. The 
blue channel is encoded with a constant value of 1 but 
does not hold any information. 


Denoising Data 
Includes Denoising Albedo, Denoising Normal, and a 
render pass of the original combined pass before 
denoising. 


Note 
The Z, Position, Object Index, and Material Index passes 
are not anti-aliased. 


Indexes 
Object Index 
Creates a mask of the object that can be later read by 
the |D Mask Node in the Compositor. 


Material Index 
Creates a mask of the material that can be later read 
by the ID Mask Node in the Compositor. 


Debug 
Render Time 
Render time in milliseconds per sample and pixel. 


Sample Count 
Number of samples/camera rays per pixel. 


Alpha Threshold 
Z, Index, normal, UV and vector passes are only affected 
by surfaces with alpha transparency equal to or higher 
than this threshold. With value 0.0 the first surface hit 
will always write to these passes, regardless of 
transparency. With higher values surfaces that are mostly 
transparent can be skipped until an opaque surface is 
encountered. 


Eevee 


Include 
Combined 
The final combination of render passes with 
everything included. 


Zz 
Distance to any visible surfaces. 


Mist 
Distance to visible surfaces, mapped to the 0.0 - 1.0 
range. 


Normal 
Surface normal used for shading. 


Light 


Cycles 


Diffuse 
Direct 
Direct lighting from diffuse and subsurface BSDFs. We 
define direct lighting as coming from lights, emitting 
surfaces, the background, or ambient occlusion after a 
single reflection or transmission off a surface. BSDF 
color is not included in this pass. 


Indirect 
Indirect lighting from diffuse and subsurface BSDFs. 
We define indirect lighting as coming from lights, 
emitting surfaces or the background after more than 
one reflection or transmission off a surface. BSDF 
color is not included in this pass. 


Color 
Color weights of diffuse and subsurface BSDFs. These 
weights are the color input socket for BSDF nodes, 
modified by any Mix and Add Shader nodes. 


Glossy 
Direct, Indirect, Color 
Same as above, but for glossy BSDFs. 


Transmission 
Direct, Indirect, Color 
Same as above, but for transmission BSDFs. 


Volume 
Direct, Indirect 
Same as above, but for volumetric BSDFs. 


Other 
Emission 
Emission from directly visible surfaces. 


Environment 
Emission from the directly visible background. When 
the film is set to transparent, this can be used to get 
the environment color and composite it back in. 


Shadow 
Shadows from light objects. Mostly useful for 


compositing objects with shadows into existing 
footage. 


Ambient Occlusion 
Ambient occlusion from directly visible surfaces. BSDF 
color or AO factor is not included; i.e. it gives a 
‘normalized’ value between 0 and 1. 


Shadow Catcher 
Extra indirect light information collected by objects 
with the Shadow Catcher option enabled. Multiply this 
pass with existing footage using the Mix Node in the 
Compositor to add the indirect lighting information to 
the footage. 


Note 


Transparent BSDFs are given special treatment. A fully 
transparent surface is treated as if there is no surface 
there at all; a partially transparent surface is treated as if 
only part of the light rays can pass through. This means it 
is not included in the Transmission passes; for that a glass 
BSDF with index of refraction 1.0 can be used. 


Eevee 


Diffuse 
Light 
Direct lighting from diffuse BSDFs. We define lighting 
as coming from lights, the background, or ambient 
occlusion off a surface. BSDF color is not included in 


this pass. 


Color 
Color weights of diffuse BSDFs. These weights are the 


color input socket for BSDF nodes, modified by any 
Mix and Add Shader nodes. 


Specular 
Light, Color 
Same as above, but for soecular BSDFs. 


Volume 
Light 
The scattering pass from volume objects or world. 


Other 
Emission 
Emission from directly visible surfaces. 


Environment 
Emission from the directly visible background. When 
the film is set to transparent, this can be used to get 
the environment color and composite it back in. 


Shadow 
Shadows from light objects. Mostly useful for 
compositing objects with shadow into existing 


footage. 


Ambient Occlusion 
Ambient occlusion from directly visible surfaces. BSDF 
color or AO factor is not included; i.e. it gives a 
‘normalized’ value between 0 and 1. 


Effects 


Eevee only 


Bloom 
The influence of the Bloom effect. 


Cryptomatte 


Cryptomatte is a standard to efficiently create mattes for 
compositing. Cycles outputs the required render passes, 
which can then be used in the Blender Compositor or 
another compositor with Cryptomatte support to create 
masks for specified objects. 


Unlike the Material and Object Index passes, the objects to 
isolate are selected in compositing. The mattes will be anti- 
aliased and take into account effects like motion blur and 
transparency. 


Object 
Render cryptomatte object pass, for isolating objects in 
compositing. 


Material 
Render cryptomatte material pass, for isolating materials 
in compositing. 


Asset 


Render cryptomatte asset pass, for isolating groups of 
objects with the same parent in compositing. 


Levels 
Sets how many unique objects can be distinguished per 


pixel. 
Typical Workflow 


1. Enable Cryptomatte Object render pass in the Passes 
panel, and render. 

2. In the compositing nodes, create a Cryptomatte node 
and link the Render Layer matching Image and 
Cryptomatte passes to it. 

3. Attach a Viewer node to the Pick output of the 
Cryptomatte node. 

4. Use the Cryptomatte Add/Remove button to sample 
objects in the Pick Viewer node. 

5. Use the Matte output of the Cryptomatte node to get 
the alpha mask. 


See also 


Cryptomatte Node. 


Shader AOV 


Shader AOVs (Arbitrary Output Variables) provide custom 
render passes for any shader node components. As an artist 
this can be a good way to fix or tweak fine details of a scene 
in post-processing. To use Shader AOVs create the pass in 
the Shader AOV panel then reference this pass with the AOV 
Output shading node. Shader AOVs can be added or 


removed in the Shader AOV panel. In this panel is a list of all 
AOV passes; each AOV in the list consists of a Name and 
Data Type. 


Active AOV Index 
The name of the render pass; this is the Name that is 
referenced in the AOV Output node. Any names can be 
used for these passes, as long as they do not conflict 
with built-in passes that are enabled. 


Data Type 
Shader AOVs can either express a Color or a Value 
output. The Co/or type as the name suggest can be used 
for a color but also for normals. A Value type can be used 
for any single numerical value. 


Light Groups 


Cycles only 


Light Groups provide render passes that only contains 
information from the lights within that group. Light Groups 
can be used to easily tweak the lighting color and intensity 
of specific lights without having to re-render the scene. 


Active Light Group Index 
The name of the render pass. This is the name that is 
used when adding World Shaders, Lights and Objects to 
Light Groups. 


Lightgroup Sync 


These operators are available in the menu to the right of the 
Light Group list. 


Add Used Lightgroups 
Adds all Light Groups to the View Layer that have been 
created elsewhere and have lights assigned to them. 


Remove Unused Lightgroups 
Deletes all Light Groups that do not have any lights 
assigned to them. 


Combining 


Cycles 


All these lighting passes can be combined to produce the 
final image as follows: 


Diffuse Direct Diffuse Color 
+ x 

Diffuse Indirect 

Glossy Direct Glossy Color 
+ x 


Glossy Indirect 
+ Combined 
Transmission Direct Transmission Color 
ats x 


Transmission Indirect 


Environment 


Eevee 


The passes can be combined to produce the final image as 
follows: 


Diffuse Light Diffuse Color 


x 


+ Volume Light 
Specular Light Specular Color 9 


x 


Environment Combined 


Known Limitations 


e Alpha blended materials are not rendered in render 
passes except the combined pass. Use the Alpha Clip or 
Alpha Hashed as Blending Mode to render transparent 
materials in render passes. 

Depth of field is not rendered in render passes except 
the combined pass. It is possible to add the depth of 
field back in the Compositor using the Defocus node. 
Eevee render passes exclude parts of the BSDF 
equation. Shader to RGB is not supported as it needs 
the full BSDF equation. 


Render Output 
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Introduction 


The first step in the rendering process is to determine and 
set the output settings. This includes render size, frame 
rate, pixel aspect ratio, output location, and file type. 


When rendering a single frame, the output should be a 
single image format and not a video. Several image formats 
are available. 


Images can also be used for rendering animations which has 
a couple advantages. For example, when rendering 
animations to image file formats the render job can be 
canceled and resumed at the last rendered frame by 
changing the frame range. This is useful if the animation 
takes a long time to render and the computers resources are 
needed for something else. 


Images can then be encoded to a video by adding the 
rendered image sequence into the Video Sequencer and 
choosing an appropriate Video Output. 


Tip 

Rendered image sequences can be played back in the 
Animation Player. 

See also 


See Render Menu 


Output Properties 


e Format 
Frame Range 
o Time Remapping 
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o Introduction 
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e Post Processing 


¥ Format 


Resolution X 1920 px 


1080 px 
100% 


1.000 
1.000 


Render Region 


24 fps 


Format panel. 


Several render presets exist with common resolution and 
frame rates for TVs and screens can be selected in the panel 
header. 


Resolution X, Y 
The number of pixels horizontally and vertically in the 
image. 


Percentage 
Slider to reduce or increase the size of the rendered 
image relative to the Resolution values. This is useful for 
Small test renders that have the same proportions as the 
final image. 


Aspect X, Y 
Older televisions may have non-square pixels, so this can 
be used to control the shape of the pixels along the 
respective axis. This will pre-distort the images which will 
look stretched on a computer screen, but which will 


display correctly on a TV set. It is important that you use 
the correct pixel aspect ratio when rendering to prevent 
re-scaling, resulting in lowered image quality. 


Render Region 
Renders just a portion of the view instead of the entire 
frame. See the Render Region documentation to see how 
to define the size of the render region. 


Note 


This disables the Save Buffers option in the 
Performance panel. 


Crop to Render Region 
Crops the rendered image to the size of the render 
region, instead of rendering a transparent background 
around it. 


Frame Rate 
The number of frames that are displayed per second, 
relevant for Animation. The menu gives several common 
frame rates, custom frame rates can be used by 
selecting Custom which gives access to the following 
properties: 


FPS 
The frame rate, expressed in frames per second. 


Base 
Some standards require a more precise frame rate, for 
example NTSC. These can be represent as a fraction 
where the Base value is used as the fraction’s 
denominator and the FPS being the numerator: \ 
(\frac{FPS}{Base}\). 


Frame Range 


Y Frame Range 


Frame Start 
End 


Step 


* Time Stretching 


Frame Range panel. 


This panel defines how long an animation will last in terms 
of frames. Frames can be divided by the scene’s Frame Rate 
to get the animation duration in terms of time. For example, 
a 250 frame animation at a frame rate of 30 will last 8.3 
seconds. 


Frame Start, End 
Set the Start and End frames for Rendering Animations. 


Step 
Controls the number of frames to advance by for each 
frame in the timeline. 


Time Remapping 


Use to remap the length of an animation. 


Old 
The length in frames of the original animation. 


New 
The length in frames the new animation will last. 


Stereoscopy 
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Introduction 

Stereoscopy Setup 

Camera 

Viewport 

Stereo 3D Display 

Viewport Preview 

Rendering and Image Editor 
Image Formats 

Final Considerations 
Window Stereo 3D Display 
Stereo 3D Camera 

Viewport Stereo 3D 
Multi-View and Stereo 3D Image 1/O 
Image Editor 

Compositor 


Introduction 


Multi-view is a complete toolset for working with 
stereoscopic rendering in Blender. It works with both the 
Eevee and Cycles rendering engines. Cycles additionally 
Supports stereoscopic panoramic cameras. There is support 
for many different stereo 3D visualization types. 


Note 


If you have a real 3D display at some point you can change 
the 3D display mode in the Window menu, by calling the 
Stereo 3D operator. Be aware that some modes require a 
fullscreen editor to work, and this can be taxing on your 
CPU. 


Usage 


For example, we will take an existing blend-file that was 
made for monoscopic rendering and transform it to be 
stereo 3D ready. 


Creature Factory 2 by Andy Goralczyk rendered in 
stereo 3D (anaglyph). 


Introduction 


Start opening up your project file, in this case turntable. blend 
from the Creature Factory 2 Open Movie Workshop series 
from the Blender Institute by Andy Goralczyk. 


Turntable Creature Factory 2. 


Stereoscopy Setup 


Go to the and enable Stereoscopy for this 
scene. 


Y@ Stereoscopy 


Setup Stereo Mode 


© left 


© right 


be 


File Suffix L 


Scene render views. 


Note 


When you turn on Stereoscopy in the scene, you get 3D 
preview in the viewport, as well as multiple panels that are 
now accessible all over the user interface. 


Viewport with 3D visualization. 


Camera 


To tweak the stereo 3D parameters, select the camera in the 
Outliner. In the Camera panel go to the Stereoscopy tab and 
change the Convergence Distance. 


The viewport will respond in real-time to those changes 
allowing you to preview the current depth value of the 
scene. 


¥ Stereoscopy 


Mode 
Convergence Plane Distance 1.950 


Interocular Distance 0.065 


Spherical Stereo 


Stereo convergence distance. 


Viewport 


Before fine-tuning the camera parameters, you can set the 
convergence plane in the viewport based in your scene 
depth layout. Go outside the camera view and you will 
instantly see the convergence plane in front of the camera. 


You can toggle this and other display settings in the 
Stereoscopy panel of the 3D Viewport’s Sidebar. In the 
following image, the camera’s frustum volumes are also 
visible. 


Viewport plane and volume stereo preview. 


Stereo 3D Display 


If you have a real 3D display at some point, you can change 
the 3D display mode in the Window menu, by calling the 
Stereo 3D operator. Be aware that some modes require a 
fullscreen editor to work. 


¥ Stereoscopy 
© Left MRight GG 3D 
Display 


Cameras 


¥ Plane Al: 0.150 


Volume 


Window menu, stereo 3D operator. 


Viewport Preview 


Before rendering your scene, you can save a Viewport 
Preview of the animation for testing in the final display. In 
the Render Output panel you can choose the output Views 
Format. 


The options include individual files per view, top-bottom, 
anaglyph among others. Pick the one that fits your display 
requirements. 


Rendering and Image Editor 


Once you are happy with the results, you can render out the 
final animation. In the Image Editor you can inspect the 
individual views and the stereo result. 


Image Formats 


Your final animation can be saved in more robust formats. In 
this example we saved as cross-eyed side-by-side stereo 3D. 


Side-by-side cross-eye format. 


Final Considerations 


As this guide showed, there is more to stereo 3D rendering 
than just generate two images. The earlier the stereo 
pipeline is considered the smoother it will get. The following 
sections are a more in-depth view of the individual 
components we visited in the workflow. 


Window Stereo 3D Display 


An essential component of the Stereoscopy pipeline is the 
ability to display the stereo image in a proper display. 
Blender supports from high-end 3D displays to simple red- 
cyan glasses. On top of that, you can set a different display 
mode for each window. 


The display mode can be changed via the Window menu or 
if you create your own shortcuts for the wm.set_stereo 3d 
operator. 


Y Stereoscopy 
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Window menu, stereo 3D operator. 
Display Mode 


Anaglyph 
Render two differently filtered colored images for each 
eye. Anaglyph glasses are required. We support red-cyan, 
green-magenta and yellow-blue glasses. 


Interlace 
Render two images for each eye into one interlaced 
image. A 3D-ready monitor is required. We support Row, 
Column and Checkerboard Interleaved. An option to 
Swap Left/Right helps to adjust the image for the screen. 
This method works better in fullscreen. 


Time Sequential 
Render alternate eyes. This method is also known as 
Page Flip. This requires the graphic card to support Quad 
Buffer and it only works in fullscreen. 


Side-by-Side 
Render images for left and right eye side-by-side. There 
iS an option to support Cross-Eye glasses. It works only in 
fullscreen, and it should be used with the Full Editor 
operator. 


Top-Bottom 


Render images for left and right eye one above another. 
It works only in fullscreen, and it should be used with the 
Full Editor operator. 


Note 
Full Screen Stereo 3D Modes 


If you have a 3D display most of the time, you will use it to 
see in stereo 3D, you will have to go to the fullscreen 
mode. In fact some modes will only work in the full window 
mode that hides most of the user interface from the work 
area. In this case it is recommended to work with two 
monitors, using the 3D screen for visualizing the stereo 
result while the other screen can be used for the regular 
Blender work. 


Stereo 3D Camera 


When using the Stereo 3D scene view setup, a stereo pair is 
created on-the-fly and used for rendering and 
previsualization. For all the purposes this works as two 
cameras that share most parameters (focal length, clipping, 
...). The stereo pair, however, is offsetted, and can have 
unique rotation and shift between itself. 


¥ Stereoscopy 


Mode Off-Axis 
Convergence Plane Distance 1.950 


Interocular Distance 0.065 


Spherical Stereo 


Stereo 3D camera settings. 


Interocular Distance 
Set the distance between the camera pair. Although the 
convergence of a stereo pair can be changed in post- 
production, different interocular distances will produce 
different results due to the parts of the scene being 
occluded from each point of view. 


Convergence Plane Distance 
The converge point for the stereo cameras. This is often 
the distance between a projector and the projection 
screen. You can visualize this in the 3D Viewport. 


Spherical Stereo 
Render every pixel rotating the camera around the 
middle of the interocular distance. 


Use Pole Merge 
Fade interocular distance to O after the given cutoff 
angle. 


Pole Merge Start Angle 
Angle at which interocular distance starts to fade to 0. 


Pole Merge End Angle 
Angle at which interocular distance is 0. 


Convergence Mode 


Off-Axis 
The stereo camera pair is separated by the interocular 
distance, and shifted inwards so it converges in the 
convergence plane. This is the ideal format since it is the 
one closest to how the human vision works. 


Parallel 
This method produces two parallel cameras that do not 
converge. Since this method needs to be manually 
converged it cannot be used for viewing. This method is 
common when combining real footage with rendered 
elements. 


Toe-in 
A less common approach is to rotate the cameras instead 
of shifting their frustum. The Toe-in method is rarely used 
in modern 3D productions. 


Pivot 
The stereo pair can be constructed around the active 
camera with a new camera built for each eye (Center 
Pivot) or using the existing camera and creating (Left or 
Right). The latter is what is used when only one eye 
needs to be rendered for an existing mono 2D project. 


Viewport Stereo 3D 


When you enable Views in the Render Layer panel, a new 
area is available in the 3D Viewport Sidebar region. In this 
panel you can pick whether to see the stereo 3D in the 


viewport, or which camera to see. It also allow you to see 
the Cameras, the Plane and the Volume of the stereo 
cameras. 


Y Stereoscopy 
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Cameras 
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Volume 


Viewport stereo 3D settings. 


Cameras 


When working with the Stereo 3D Viewports setup, you 
can inspect what each individual generated camera is 

looking or the combined result of them. In the Multi-View 
mode you can see the combined result of the left and 

right cameras (when available) or the current selected 
camera. 


Plane 


The convergence plane represents the screen as it is 
perceived by the audience. Visualizing it in the 3D 
Viewport allows you to layout your scene based on your 
depth script outside the camera view. 


Volume 


The intersection of the stereo cameras frustums helps 
planning the show by avoiding elements being visible by 
only one camera. The volume is defined by the camera’s 
start and end clipping distances. The areas that are in 
the frustum of one camera only are known as retinal 
rivalry areas. They are tolerated in the negative space 
(the region from the convergence plane into the image) 


but are to be avoided at all costs in the positive space 
(the area from the convergence plane to the camera). 


Viewport 3D: convergence plane and volume 
display. 


Multi-View and Stereo 3D Image 
1/O 


Multi-View and Stereo 3D 
Multi-view images can be saved in special formats 
according to the production requirements. By default the 
system saves each view as an individual file, thus 
generating as many files as views to be rendered. In 
stereo 3D productions, for the final deployment or even 
intermediary previews it is convenient to save stereo 3D 
images, that are ready to use with 3D displays or simple 
anaglyph glasses. The formats supported match the 
display modes available for the window. 


Lossy-Formats 
Some stereo 3D formats represent a considerable loss of 
data. For example, the Anaglyph format will cap out 
entire color channels from the original image. The Top- 


Bottom compressed will discard half of your vertical 
resolution data. The Interlace will mash your data 
considerably. Once you export in those formats, you can 
still import the image back in Blender, for it to be treated 
as Stereo 3D. You will need to match the window stereo 
3D display mode to the image stereo 3D format though. 


Lossless Formats 


Some formats will preserve the original data, leading to 
no problems on exporting and importing the files back in 
Blender. The Individual option will produce separate 
images that (if saved in a lossless encoding such as PNG 
Or OpenEXR) can be loaded back in production with no loss 
of data. For the Stereo 3D formats the only lossless 
options are Top-Bottom and Side-by-Side without the 
Squeezed Frame option. 


Multi-View OpenEXR 


Another option is to use multi-view OpenEXR files. This 
format can save multiple views in a single file and is 
backward compatible with old OpenEXR viewers (you see 
only one view though). Multi-view native support is only 
available to OpenEXR. 


Image Editor 


View Menu 


After you render your scene with Stereo 3D you will be 
able to see the rendered result in the combined stereo 
3D or to inspect the individual views. This works for 
Viewer nodes, render results or opened images. 


[Mv al View vy View Image Aly Render Result i (CO fa x od Slot2 » Composite v Ne 


[Mv al View vy View Image Aly Render Result ‘S| (Go i x a Slot 2 » Composite v left ¥ Ne 


Stereo 3D and view menu. 


Views Format 
When you drag and drop an image into the Image Editor, 
Blender will open it as an individual images at first. If 
your image was saved with one of the Stereo 3D formats, 
you can change how Blender should interpret the image 
by switching the mode to Stereo 3D, turning on Use 
Multi-View and picking the corresponding stereo method. 


¥ Image 


Source Single Image 


Image Tool 


& /funtitled.exr = 


1920 x 1920, RGBA float 


View 


Use Multi-View 
Views Format | Individual 
Stereo 3D 
Color Space Linear 
Alpha Premultiplied » 


View as Render 


» Metadata 


Views formats and stereo 3D. 


Compositor 


The Compositor works smoothly with multi-view images. 
The compositing of a view is completed before the 
remaining views start to be composited. The pipeline is the 
same as the single-view workflow, with the difference that 
you can use images, movies or image sequences in any of 
the supported multi-view formats. 


Compositor, backdrop and Split Viewer node. 


The views to render are defined in the current scene views, 
in a similar way as you define the composite output 
resolution in the current scene render panel, regardless of 
the Image nodes resolutions or Render Layers from different 
scenes. 


Note 
Single-View Images 


If the image from an Image node does not have the view 
you are trying to render, the image will be treated as a 
single-view image. 


Switch View Node 
If you need to treat the views separately, you can use the 
Switch View node to combine the views before an Output 
node. 


Tip 


Performance 


By default, when compositing and rendering from the user 
interface all views are rendered and then composited. 
During test iterations you can disable all but one view from 
the Scene Views panel, and re-enable it after you get the 
final look. 


Output 


¥ Output 


/trmp/ i= 
Overwrite Placeholders 


File Extensions Cache Result 


File Format |[g*] PNG 


Color 
Color Depth 


Compression 


Output panel. 


This panel provides options for setting the location of 
rendered frames for animations, and the quality of the 
Saved images. 


File Path 
Choose the location to save rendered frames. 


When rendering an animation, the frame number is 
appended at the end of the file name with four padded 
zeros (@€.g. image0001.png). You can set a custom padding 
size by adding the appropriate number of # anywhere in 
the file name (e.g. image ## test.png translates to 
image 01 test.png). 


This setting expands Relative Paths where a // prefix 
represents the directory of the current blend-file. 


Saving 
File Extensions 
Adds the correct file extensions per file type to the 
output files. 


Cache Result 
Saves the rendered image and passes to a multi-layer 
EXR file in temporary location on your hard drive. This 
allows the Compositor to read these to improve the 
performance, especially for heavy compositing. 


File Format 


Choose the file format to save to. Based on which format 
is used, other options such as channels, bit depth and 
compression level are available. 


For rendering out to images see: saving images, for 


rendering to videos see the Encoding panel. 


Color 


Choose the color format to save the image to. Note that 
RGBA will not be available for all image formats. 


BW, RGB, RGBA 


Image Sequence 
Overwrite 
Overwrite existing files when rendering. 


Placeholders 
Create empty placeholder frames while rendering. 


Hint 
Primitive Render Farm 


An easy way to get multiple machines to share the 
rendering workload is to: 


e Set up a Shared directory over a network file system. 
e Disable Overwrite, enable Placeholders in the Render 
Output panel. 


e Start as many machines as you wish rendering to that 
directory. 


Color Management 


This panel controls how Color Management is applied when 
Saving images. 


Follow Scene: Uses the same color management settings 
defined by the active Scene. These 
properties are defined in the Render 
Settings 

Override: Uses custom color management settings 
defined by the properties below in the 
panel; disregarding any color 
management settings set at the Scene 
level. 


For a detailed description of color management properties, 
see the Color Management page. 


Encoding 


Reference 


Panel: Properties >» Output > Encoding 


¥ Output 


ftmmp/ fe 


File Extensions Cache Result 


File Format HH FFmpeg video 


Color BW RGB 
¥ Encoding = 
Container Matroska 
Autosplit Output 
¥ Video 
Video Codec #H.264 
Output quality Medium quality 
Encoding speed Good 
Keyframe interval 
Max B-frames 
¥ Audio 
Audio Codec Vorbis 
Bitrate 


Volume 


Encoding panel. 


Here you choose which video container, codec, and 
compression settings you want to use. With all of these 
compression choices, there is a trade-off between file size, 
compatibility across platforms, and playback quality. In the 
header, you can use the presets, which choose optimum 
settings for you for that type of output. 


Tip 


When you view the System Console, you can see some of 
the output of the encoding process. You will see even more 


output if you execute Blender as blender -d. 


Container 
Video container or file type. For a list of all available 
options, see video formats. 


Autosplit Output 
If your video is huge and exceeds 2GiB, enable Autosplit 
Output. This will automatically split the output into 
multiple files after the first file is 2GiB in size. 


Video 


Video Codec 
Chooses the method of compression and encoding. For a 
list of all available options see video formats. 


Note 
Standards 


Some containers and codecs are not compatible with each 
other, so if you are getting errors check that your 
container and codec are compatible. Like containers and 
codecs are sometimes not compatible with each other, 
some codecs do not work with arbitrary dimensions. So, try 
to stick with common dimensions or research the 
limitations of the codec you are trying to use. 


Output Quality 
These are preset Rate. 


Encoding Speed 


Presets to change between a fast encode (bigger file 
size) and more compression (smaller file size). 


Keyframe Interval 
The number of pictures per Group of Pictures. Set to O for 
“intra_only”, which disables inter-frame video. A higher 
number generally leads to a smaller file but needs a 
higher-powered device to replay it. 


Max B-frames 
Enables the use of B-frames. 


Interval 
The maximum number of B-frames between non-B- 
frames. 


Rate 
Bitrate 


Sets the average bit rate (quality), which is the count of 
binary digits per frame. See also: FFmpeg -b:v. 


Minimum / Maximum 
Video files can use what is called variable bit rate (VBR). 
This is used to give some segments of the video less 
compressing to frames that need more data and less to 
frames with less data. This can be controlled by the 
Minimum and Maximum values. 


Buffer 
The decoder bitstream buffer size. 


Mux Rate 
Maximum bit rate of the multiplexed stream. Multiplexing 
is the process of combining separate video and audio 


streams into a single file, similar to packing a video file 
and MP3 audio file in a zip-file. 


Mux Packet Size 
Reduces data fragmentation or muxer overhead 
depending on the source. 


Audio 


These settings change how sound is exported while 
rendering. To control how sound is played back from within 
Blender, see the audio settings in the Preferences. 


Audio Codec 
Audio format to use. For a list of all available options, see 
video formats. 


Audio Channels 
Sets the audio channel count. 


Sample Rate 
Sets the audio sampling rate. 


Bitrate 
For each codec, you can control the bit rate (quality) of 
the sound in the movie. Higher bit rates are bigger files 
that stream worse but sound better. Use powers of 2 for 
compatibility. 


Volume 
Sets the output volume of the audio. 


Tips 


Tip 


The choice of video format depends on what you are 
planning to do. 


It’s not recommended to render directly to a video format 
in the first instance. If a problem occurs while rendering, 
the file might become unplayable and you will have to re- 
render all frames from the beginning. If you first render out 
a set of static images such as the default PNG format or 
the higher-quality OpenEXR (which can retain HDR pixel 
data), you can combine them as an Image Strip in the 
Video Sequencer. This way, you can easily: 


e Restart the rendering from the place (the frame) where 
any problem occurred. 

e Try out different video encoding options in seconds, 
rather than minutes or hours as encoding is usually 
much faster than rendering the 3D scene. 

e Enjoy the rest of the features of the Video Sequencer, 
such as adding Image Strips from previous renders, 
audio, video clips, etc. 


Tip 


You shouldn’t post-process a lossy-compressed file as the 
compression artifacts may become visible. Lossy 
compression should be reserved as a final ‘delivery 
format’. 


Metadata 


¥ Metadata 


Time Render Time 
Frame Frame Range Memory 
Hostname Camera Lens 


Scene Marker Filename 


Strip Name Use Strip Me.. 


Note 


Burn Into Image 


Metadata panel. 


The Metadata panel includes options for writing metadata 
into render output. 


Note 


Only some image formats support metadata: See image 
formats. 


Metadata Input 
Where to grab metadata from. 


Scene: Use metadata from the current scene. 
Sequencer Strips: 


Use metadata from the strips in the 


Sequencer. 
Include 
Date 
Includes the current date and time. 
Time 
Includes the current scene time and render frame at 
HH:MM:SS.FF. 


Render Time 
Includes the render time. 


Frame 
Includes the frame number. 


Frame Range 
Includes the start and end frame numbers. 


Memory 
Includes the peak memory usage. 


Hostname 
Includes the rendering machine’s hostname. 


Camera 
Includes the name of the active camera. 


Lens 
Includes the name of the active camera’s lens value. 


Scene 
Includes the name of the active scene. 


Marker 
Includes the name of the last marker. 


Filename 
Includes the filename of the blend-file. 


Strip Name 
Includes the name of the foreground sequence strip. 


Note 


Includes a custom note. 


Hint 


It can be useful to use the Note field if you are setting up a 
render farm. Since you can script any information you like 
into it, such as an identifier for the render node or the job 
number. For details on stamping arbitrary values, see: this 


page. 


Burn into Image 


Add metadata as text to the render. 


Font Size 
Set the size of the text. 


Text Color 
Set the color and alpha of the stamp text. 


Background 
Set the color and alpha of the color behind the text. 


Include Labels 


Displays the labels before the metadata text. For 
example, “Camera” in front of the camera name, etc. 


Post Processing 


Reference 


Panel: Properties » Output » Post Processing 


The Post Processing panel is used to control different 
options used to process your image after rendering. 


Pi pel ine Y Post Processing 


Todo. Compositing Sequencer 


Dither 1.000 


Compositing 
Renders the output from 
the compositing node 
setup, and then applies 
the Composite node tree 
on all images, displaying the image inputted in the 
Composite Output node. 


Post Processing panel. 


Sequencer 
Renders the output of the Video Sequence editor, 
instead of the view from the 3D scene’s active 
camera. If the sequence contains Scene strips, these 
will also be rendered as part of the pipeline. If 
Compositing is also enabled, the Scene strip will be 
the output of the Compositor. 


Dither 
Dithering is a technique for blurring pixels to prevent 
banding that is seen in areas of gradients, where stair- 
stepping appears between colors. Banding artifacts are 
more noticeable when gradients are longer, or less steep. 


Dithering was developed for graphics with low bit depths, 
meaning they had a limited range of possible colors. 


Dithering works by taking pixel values and comparing 
them with a threshold and neighboring pixels then does 
calculations to generate the appropriate color. Dithering 
creates the perceived effect of a larger color palette by 
creating a sort of visual color mixing. For example, if you 
take a grid and distribute red and yellow pixels evenly 
across it, the image would appear to be orange. 


Audio Rendering 


e Introduction 
o Options 
e Speaker 
o Options 


Introduction 


Audio can be rendered from the Render Menu. 


Options 


Relative Path 
Select the file path relative to the blend-file. 


Accuracy 
Sample accuracy, important for animation data (the 
lower the value, the more accurate). 


Audio Containers 
See here. 


Codec 
Some Audio Containers also have option to choose a 
codec. For more information see here. 


Split Channels 
Each audio channel will be rendered into a separate file. 


See also 


e See Scene Audio settings. 
e See Audio Output settings. 
e See Audio Preferences. 


Speaker 


Speaker objects. 


The speaker object is used to give sound in the 3D Viewport. 
After adding the object, the various settings can be changed 
in the Properties. 


Options 
Sound 
Open 


The Data-Block Menu for loading audio files. There are 
two properties you can check when loading a sound: 


Cache 


This means the whole sound will be decoded and the 
raw audio data will be buffered in memory, which 
results in faster playback, but uses quite a lot of 
memory. So this should be used for short sound 
effects that get played more often, but not for longer 
audio files such as music. 


Mono 
For any 3D audio or panning effects the sound source 
has to be single channel, otherwise it’s assumed that 
the 3D audio and panning information is already 
present in the multichannel file. Enable this if you 
want to use those effects for a file with multiple 
channels. 


Mute 
Toggles whether or not the sound can be heard. 


Volume 
Adjust the loudness of the sound. 


Pitch 
Can be used to bend the pitch of the sound to be either 
deeper or higher. This basically changes the playback 
speed of the sound which also results in a pitch change. 


Playback Time 


There is no setting to choose the start time when the 
speaker should start playing, because you might want a 
single speaker to play multiple times. Therefore, you have to 
open the NLA Editor where you can add Sound strips that 
define when the sound should start (nothing else, so any 
other properties of the strips, like length don’t matter). 
When you add a speaker object such a strip will be added at 
the current frame. 


Distance 


Distance attenuation }v [MD Speaker = (J Speaker 
relevant settings. wy (dv. Speaker 
Volume Y Sum 
Minimum/Maximum Jv ie 
No matter how far 
away/close the object - Volume 
is, the distance-based = Pitch 
volume won't be Sera 
lower/higher than this — 
Volume Min 
value. ai 
Attenuation 
Attenuation 
How strong the 


distance affects the 


Max Distance 


Distance Reference 


volume. This factor * Cone 
sets the strength of Angle Outer 360.000 
the distance-based Inner 360.000 


volume change, Outer Cone Volume 1.000 
depending on the 
chosen distance 
model (see scene 
settings). 


>» Custom Properties 


Speaker properties. 


Distance 
Maximum 
If the object is farther away than this distance, this 
distance is used to calculate the distance-based 
volume. Influence of this value also depends on the 
distance model. 


Reference 
The distance at which the volume is full (1.0). Set this 
value to the distance used for recording the sound. 


Usually sound effects recordings should be made 
exactly 1 m away from sound to get an accurate 
volume. 


Cone 


Directionality relevant settings. 


Imagine a cone with the top at the original of the speaker 
object and the main axis of it facing in the same direction as 
the speaker. There are two cones an inner and an outer 
cone. The angles represent their opening angles, so 360° 
mean the cone is fully open and there is no directionality 
anymore. Inside the inner cone the volume is full (1.0), 
outside the outer cone the volume is, whatever one sets for 
the outer cone volume and the volume between those two 
cones, linearly interpolated between this two volumes. 


Angle 
Outer 
Angle of the outer cone in degrees. Outside this cone, 
the volume is equal to the Outer volume. 


Inner 
Angle of the inner cone in degrees. Inside the cone, 
the volume is full. 


Volume 
Outer 
Volume outside the outer cone. 


Rendering Animations 


While rendering stills will allow you to view and save the 
image from the render buffer when it is complete, 
animations are a series of images, or frames, and are 
automatically saved directly out to a drive after being 
rendered. 


After rendering the frames, you may need to edit the clips, 
or first use the Compositor to do green-screen masking, 
matting, color correction, DOF, and so on to the images. 
That result is then fed to the Sequencer where the strips are 
cut and mixed and a final overlay is done. 


Finally you can render out from the Sequencer and 
compress the frames into a playable movie clip. 


Workflow 


Generally, you do a lot of intermediate renders of different 
frames in your animation to check for timing, lighting, 
placement, materials, and so on. At some point, you are 
ready to make a final render of the complete animation for 
publication. 


There are two approaches you can use when making a 
movie, or animation, with or without sound. The approach 
you should use depends on the amount of CPU time you will 
need to render the movie. You can render a “typical” frame 
at the desired resolution, and then multiply by the number 
of frames that will ultimately go into the movie, to arrive at 
a total render time. 


If the total render time is an hour or more, you want to use 
the “Frame Sequence” approach. For example, if you are 
rendering a one-minute video clip for film, there will be (60 
seconds per minute) X (24 frames per second) or 1440 
frames per minute. If each frame takes 30 seconds to 
render, then you will be able to render two frames per 
minute, or need 720 minutes (12 hours) of render time. 


Rendering takes all available CPU time; you should render 
overnight, when the computer is not needed, or set Blender 
to a low priority while rendering, and work on other things 
(be careful with the RAM space!). 


Direct Approach 


The Direct Approach, which is highly not recommended and 
not a standard practice, is where you set your output format 
to an AVI or MOV format, and click Animation to render your 
scene directly out to a movie file. Blender creates one file 
that holds all the frames of your animation. You can then 
use Blender’s Video Sequencer to add an audio track to the 
animation and render out to an MPEG format to complete 
your movie. 


Frame Sequence 


The Frame Sequence is a much more stable approach, 
where you set your output format to a still format (Such as 
JPG, PNG or a multi-layer format). Click Animation to render 
your scene out to a set of images, where each image is a 
frame in the sequence. 


Blender creates a file for each frame of the animation. You 
can then use Blender’s Compositor to perform any frame 
manipulation (post-processing). You can then use Blender’s 
Video Sequencer to load that final image sequence, add an 


audio track to the animation, and render out to an MPEG 
format to complete your movie. The Frame Sequence 
approach is a little more complicated and takes more drive 
Space, but gives you more flexibility. 


Here are some guidelines to help you choose an approach. 


Direct Approach 


e Short segments with total render time under one hour. 
e Stable power supply. 
e Computer not needed for other uses. 


Frame Sequence Approach 


e Total render time over one hour. 
e Post-production work needed: 
o Color/lighting adjustment 
o Green screen/matte replacement 
o Layering/compositing 
o Multiple formats and resolutions of the final product 
e Intermediate frames/adjustments needed for 
compression/codec. 
e Precise timing (e.g. lip-sync to audio track) needed in 
parts. 
e May need to interrupt rendering to use the computer, 
and want to be able to resume rendering where you left 
off. 


Frame Sequence Workflow 


1. First prepare your animation. 


2. In the Dimensions panel, choose the render size, Pixel 
Aspect Ratio, and the Range of Frames to use, as well as 


10. 


the frame rate, which should already be set. 


. In the Output panel set up your animation to be 


rendered out as images, generally using a format that 
does not compromise any quality. 


. Choose the output path and file type in the Output panel 


as well, for example //render/my-anim-. 


. Confirm the range of your animation (frame Start and 


End). 


. Save your blend-file. 


. Press the Animation button and once the animation is 


finished, use your file manager to navigate to the output 
folder (render in this example). You will see lots of 
images that have a sequence number attached to. 
These are the single frames. 


. In Blender, open the Video Sequencer. 


Note 


The Video Sequencer does not support multi-layer EXR 
files. To render to a video format you will have to skip 
the next three steps and instead use an Image Input 
node in the Compositor. 


. Choose Add Image from the add menu. Select all the 


frames from your output folder that you want to include 
in your animation. They will be added as a Strip in the 
Sequence editor. 


Now you can edit the strip and add effects or leave it 
like it is. You can add other strips, like an audio strip. 


11. Scrub through the animation to check if you have 
included all the frames. 


12. In the Output panel, choose the container and codec 
you want (e.g. MPEG H.264) and configure them. The video 
codecs are described in Output Options. 


13. Click the Animation render button and Blender will 
render out the Sequence editor output into a movie. 


Hints 


Your computer accidentally turns off in the middle of 
rendering your movie! 
Unless your animation renders in a few minutes, it is best 
to render the animation as separate image files. Instead 
of rendering directly to a compressed movie file, use a 
lossless format (e.g. PNG). 


This allows you an easy recovery if there is a problem 
and you have to re-start the rendering, since the frames 
you have already rendered will still be in the output 
directory. 


Just disable the Overwrite option to start rendering where 
you left off. 


You can then make a movie out of the separate frames 
with Blender’s Sequence editor or use 3rd party encoding 
software. 


Animation Preview 
It can be useful to render a subset of the animated 
sequence, since only part of an animation may have an 
error. 


Using an image format for output, you can use the Frame 
Step option to render every N’th frame. Then disable 
Overwrite and re-render with Frame Step set to 1. 


Animation Player 


Reference 
Menu: Topbar >» Render >» View Animation 
Shortcut: Ctrl-F1l 


The animation player is a utility typically used for 
previewing rendered animations, supporting all image and 
video formats also supported by Blender. This is a 
convenient way to play back image sequences at the 
correct frame rate. 


Launching the animation player opens a new window, 
playing back images or a video located at the render output 
of the current scene. You can also drop images or movie 
files in a running animation player. It will then restart the 
player with the new data. 


Tip 


An external player can also be used instead of the one 
included in Blender. To do this, select it in the Preferences. 


Player Options 
Ping Pong 
When enabled, playback loops forwards than backwards. 


X/Y Flip 
Flip the image horizontally or vertically. 


Viewing the animation from a different perspective can 
help you see the animation with “fresh eyes”. 


Hotkeys 


The following table shows the available hotkeys for the 
animation player. 


Playback 
Action Hotkey 
Start/Pause: Spacebar 


Start playback (when 


paused): Senet 
Quit: Esc 
Timeline 

Action Hotkey 
Scrub in time: LMB 


Step back one frame: Left 


Action Hotkey 


Step forward one frame: Right 


Step back 10 frames: Down 


Step forward 10 frames: Up 


Manual frame stepping: NumpadPeriod 


Playback Options 


Action Hotkey 


Backward playback: Shift-Down 


Forward playback Shift -Up 


Slow down playback: NumpadMinus 


Speed up playback: NumpadPlus 


Toggle looping: Numpad@ 


Action Hotkey 


Toggle frame skipping: A 


Toggle ping-pong: P 


Display 


Action 


Toggle Playhead (Indicator): 


Flip image on the X axis: 


Flip image on the Y axis: 


Hold to show frame 
numbers: 


Zoom in: 


Zoom out: 


Frame Rate 


Hotkey 


Shift -F 


Shift 


Ctrl-NumpadPlus 


Ctrl-NumpadMinus 


Action Hotkey 


60 fps Numpad1 
50 fps Numpad2 
30 fps Numpad3 
25 fps Numpad4 
24 fps Shift-Numpad4 
20 fps Numpad5 
15 fps Numpad6 
12 fps Numpad7 
10 fps Numpad8 
6 fps Numpad9 


5 fps NumpadSlash 


Frame Cache 


Image files are cached during playback for faster access. 


While loading images is rarely a bottleneck, there are 
situations where high resolution images may slow down 
playback causing frame skipping. 


See also 


Memory Cache Limit preference to control this limit, which 
may be increased to cache more images during playback. 
Animation Playback Options to specify this value when 
launching from the command line. 


Compositing 


e Introduction 

o Getting Started 

o Examples 

o Image Size 

o Saving your Composite Image 
e Sidebar 

o View 

o Options 


Node Types 


Input Nodes 
Output Nodes 
Color Nodes 
Converter Nodes 
Filter Nodes 
Vector Nodes 
Matte Nodes 
Distort Nodes 
Group 

Layout Nodes 


Introduction 


Compositing Nodes allow you to assemble and enhance an 
image (or movie). Using composition nodes, you can glue 
two pieces of footage together and colorize the whole 
sequence all at once. You can enhance the colors of a single 
image or an entire movie clip in a static manner or ina 
dynamic way that changes over time (as the clip 
progresses). In this way, you use composition nodes to both 
assemble video clips together and enhance them. 


Note 
Term: Image 


The term Image may refer to a single picture, a picture ina 
numbered sequence of images, or a frame of a movie clip. 
The Compositor processes one image at a time, no matter 
what kind of input you provide. 


To process your image, you use nodes to import the image 
into Blender, change it, optionally merge it with other 
images, and finally, save it. 


An example of color correction. 


Getting Started 


Access the Compositor and activate nodes for compositing 
by clicking the Use Nodes checkbox in the header (see 
Introduction). 


Note 


After clicking Use Nodes the Compositor is enabled, 
however, it can also be disabled in the Post Processing. 


You now have your first node setup, from here you can add 
and connect many types of Compositing Nodes, in a sort of 
map layout, to your heart’s content (or physical memory 
constraints, whichever comes first). 


Note 


Nodes and node concepts are explained in more detail in 
the Nodes reference. 


Examples 


You can do just about anything with images using nodes. 


Raw footage from a foreground actor in front of a blue 
screen, or a rendered object doing something, can be 
layered on top of a background. Composite both together, 
and you have composited footage. 


You can change the mood of an image: 


e To make an image ‘feel’ colder, a blue tinge is added. 

e To convey a flashback or memory, the image may be 
softened. 

e To convey hatred and frustration, add a red tinge or 
enhance the red. 

e A startling event may be sharpened and contrast- 
enhanced. 


e To convey a happy feeling add yellow (equal parts red 
and green, no blue). 

e Dust and airborne dirt are often added as a cloud 
texture over the image to give a little more realism. 


Image Size 


It is recommended to pay attention to image resolution and 
color depth when mixing and matching images. Aliasing, 
color flatness, or distorted images can all be traced to 
mixing inappropriate resolutions and color depths. 


The Compositor can mix images with any size, and will only 
perform operations on pixels where images have an overlap. 
When nodes receive inputs with differently sized Images, 
these rules apply: 


e The first/top Image input socket defines the output size. 

e The composite is centered by default, unless a 
translation has been assigned to a buffer using a 
Translate node. 


So each node in a composite can operate on different sized 
images as defined by its inputs. Only the Composite output 
node has a fixed size, as defined by the settings in 
Properties Render >» Dimensions. The Viewer node always 
shows the size from its input, but when not linked (or linked 
to a value) it shows a small 320x256 pixel image. 


Saving your Composite Image 


The Render button renders a single frame or image. Save 
your image using Image > Save Image or Alt-s. The image 


will be saved using the image format settings on the Render 
panel. 


To save a sequence of images, for example, if you input a 
movie clip or used a Time node with each frame in its own 
file, use the Animation button and its settings. If you might 
want to later overlay them, be sure to use an image format 
that supports an Alpha channel (such as PNG). If you might 
want to later arrange them front to back or create a depth 
of field effect, use a format that supports a Z-depth channel 
(such as ExR). 


To save a composition as a movie clip (all frames in a single 
file), uSe an AVI Or Quicktime format, and use the Animation 
button and its settings. 


Sidebar 


View 

Reference 

Panel: Sidebar region > View 

Backdrop 

The backdrop is the output of a v & Backdrop = & 
Viewer node in the background of the Channels WN) Color an... v = 
Compositor. For example, when Shift- Zoom 1.00 e 
Ctrl-LMB on an Image node, it displays se 


0.000 


a preview of the image, or on a Mix 
node, will show the result of the 
mixing. You can toggle the backdrop 
by clicking the checkbox in the 
Backdrop panel title or by clicking on 
the Backdrop button in the header. 
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Fit 


Backdrop panel. 
Channels 


The color channels to display of 
the backdrop image. 


ZOOM Alt-V V 
Sets the size of the backdrop image. 


Offset 
Change the screen space position of the backdrop. 


Move Alt-MMB 


Changes the position of the backdrop. 


Fit 
Scales the backdrop to fit the size of the Compositor. 
Reset Backdrop 


Sets back to the default values of Zoom to 1 and Offset 
to O. 


Options 


Reference 


Panel: Sidebar region > Options 


Performance 


This panel helps you tweak the ¥ Performance 
performance of the Compositor. Render High 
Edit High 
Render Chunksize 256x256 
Sets the quality when doing the OpenCL 
final render. one Cuedes 


Too! Item 


View 
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Two Pass 


Viewer Border 


Edit 
Sets the quality when making 
edits. 


Auto Render 


Chunk Size Performance panel. 


Max size of a tile (Smaller values 
give a better distribution of 
multiple threads, but more overhead). 


OpenCL 


This allows the use of an OpenCL platform to aid in 
rendering. Generally, this should be enabled unless your 
hardware does not have good OpenCL support. 


Buffer Groups 
Enables buffering of group nodes to increase the speed 
at the cost of more memory. 


Two Pass 
Use two pass execution during editing: the first pass 
calculates fast nodes, the second pass calculates all 
nodes. 


Viewer Region 
This allows to set an area of interest for the backdrop. 
Press Ctri-B and select a rectangular area in the preview 
which will become the next preview in the backdrop. 
Ctrl-Alt-B discards the region back to a full preview. This 
is Only a preview option, final compositing during a 
render ignores this region. 


Auto Render 
Re-render and composite changed layer when edits to 
the 3D scene are made. 


Input Nodes 


Input nodes produce information from a data source. For 
instance, an input can be: 


e Taken directly from the active camera in a selected 
scene. 

e A static image. 

e A movie clip (Such as an image sequence or video). 

e A color or value. 


These nodes generate the information that is passed to 
other nodes. As such, they have no input sockets; only 
outputs. 


Bokeh Image Node 
Image Node 

Mask Node 

Movie Clip Node 
Render Layers Node 
RGB Node 

Scene Time Node 
Texture Node 

Time Curve Node 
Track Position Node 
Value Node 


Bokeh Image Node 


The Bokeh Image node generates a 
special input image for use with the 


Y Bokeh Image @ 


Bokeh Blur filter node. image 
; : Flaps = 
The Bokeh Image node is designed to 
create a reference image which ae ~ 
simulates optical parameters such as Rounding 0.000 


aperture shape and lens distortions Catadiopt 0.000 
which have important impacts on 


Lens Shift 0.000 
bokeh in real cameras. 


Inputs 


This node has no input sockets. 


Properties 


The first three settings simulate the aperture of the camera. 


Flaps 
Sets an integer number of blades for the cameras iris 
diaphragm. 


Angle 
Gives these blades an angular offset relative to the 
image plane. 


Rounding 
Sets the curvature of the blades with (0 to 1) from 
straight to bringing them to a perfect circle. 


Catadioptric 
Provides a type of distortion found in mirror lenses and 
some telescopes. This can be useful to produce a visual 
complex bokeh. 


Lens Shift 
Introduces chromatic aberration into the blur such as 
would be caused by a tilt-shift lens. 


Outputs 


Image 
The generated bokeh image. 


Example 


In the example below the Bokeh Image is used to define the 
Shape of the bokeh for the Bokeh Blur node. 


y Bokeh Blur 


Image 
» Render 
¥ Variable Size 


Max Blu 16.000 


Rounding 
Extend Bounds 


Catadioptri y Multiply 


y Map Value 


Lens Shift 


Value 
Multiply 
Clamp Bounding 1.000 
0.000 
@ Value 


0.050 Value 16.000 


Use Minimum 


@® Value 


Example of Bokeh Image node. 


Image Node 


The Image node injects any image 


format that is supported by Blender. © 


Image 


Alpha @ 


lly +New gegOp... 


Inputs 


This node has no input sockets. 


Properties 


Image 
Selection of different types of media. For controls see 
Data-Block Menu. For the options see Image Settings. 


Note 


More options can be set in the Sidebar region. 


Outputs 


The first two sockets are the minimum. 


Image 
Standard color output. 


Alpha 
Separate Alpha value. 


Z 
Z depth layer. 


Note 
Multi-Layer Format 


When a multi-layer file format, like ExR, is loaded, each 
layer is made available as a socket. 


Mask Node 


The Mask node can be used to select 
a Mask data-block. This node can be 
used with other nodes, for example to 
Invert, Multiply or Mix, or used as a re 
factor input. = 


¥ Feather 


Scene Size 


Motion Blur 


Inputs 


This node has no input sockets. 


Properties 


Masks 
The selectable mask data-block. If the label is left blank, 
the mask name will be set. 


Feather 
Use or ignore feather points defined for splines see Mask 
Feathers for more details. 


Size 
Scene Size will give an image the size of the render 
resolution for the scene, scaling along when rendering 
with different resolutions. Fixed gives a fixed size in 
pixels. Fixed/Scene gives a size in pixels that still scales 


along when changing the render resolution percentage in 
the scene. 


Motion Blur 
For animated masks, creating a motion blurred mask 
from the surrounding frames, with a given number of 
samples (higher gives better quality), and a camera 
shutter time in seconds. 


Outputs 


Mask 
The black-and-white output of the mask. 


Example 


Example of the Mask node. 


In the example above, the Mask node is used to isolate the 
object from the background to preserve it from being 
corrected. 


Movie Clip Node 


This node is a special node that uses 


some of the values taken from oe © 
footage cameras and trackings and wh 
link them to the output. It is possible Alpha 
to load image sequences, but only Offset X 
Image and Alpha values will be Offset Y 


available, because the other outputs Scale 
will not have any values associated 
with them. When a tracked clip is : 

chosen, Blender will fulfill the outputs mY me Open 
using internal values taken from the 
tracking. So the controls for start and 
end frames will be defined in the Movie Clip editor. 


Angle 


Inputs 


This node has no input sockets. 


Properties 


Movie Clip 
Used to select the movie clip. For controls see Data-Block 
Menu. 


Outputs 


The first two sockets are the minimum output. 


Image 


Outputs the entire image in the specified color space. 


Alpha 
The alpha value taken from the movie or image. 


Offset X 
The X offset value from the footage camera or tracking. 


Offset Y 
The Y offset value from the footage camera or tracking. 


Scale 


The scale of the image taken from the footage camera or 
tracking. 


Angle 
The lens angle taken from the footage camera or 
tracking. 


Render Layers Node 


This node is the starting 


: i Y Render Layers 
place for getting a picture © 
of your scene into the image 
compositing node tree. Alpha @ 


| ota Scene 


ViewLayer 


Inputs 


This node has no input sockets. 


Properties 


Scene 
Select the scene within your blend-file. The scene 
information taken is the raw footage (pre-compositing 
and pre-sequencing). 


Hint 

To use composited footage from another scene, it has to 
be rendered into a multi-layer frameset (€.g. OpenEXR) as 
an intermediate file store and then imported with Image 
input node again. 


Render Layer 


A list of available Render Layers. The render button is a 
shorthand to re-render the active scene. 


Outputs 


Image 
Rendered image. 


Alpha 
Alpha channel. 


Render Passes Sockets 


Depending on the Render passes that are enabled, other 
sockets are available. See render passes. 


RGB Node 


Inputs 


This node has no input sockets. 


Properties 


The RGB node uses the color picker widget. 


Outputs 


Color / RGBA 
A single RGBA color value. 


Scene Time Node 


The Scene Time node outputs the 
current time in the scene’s animation 
in units of seconds or frames. 


Y Scene Time 


Seconds @ 


Frame @ 


Inputs 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


Seconds 
Current scene time in seconds. 


Frames 
Current scene frame. As an input in geometry nodes, this 
output may also output non-round numbers, in order to 
Support higher quality motion blur. 


Texture Node 


The Texture node makes 3D textures 
available to the Compositor. 


Y Texture © 


Value @ 


Color 


so 


Offset: 


Inputs 


Offset 
A vector (XYZ) transforming the origin of the texture. 


Scale 
A vector (XYZ) to scale the texture. 


Properties 


Texture 
The texture can be selected from a list of textures 
available in the current blend-file or linked-in textures. 


The textures themselves can not be edited in the 
Compositor, but in the Texture Node Editor. 


Outputs 


Value 
Gray-scale color values. 


Color 
Color values. 


Time Curve Node 


The Time Curve node 
generates a factor value (from 
0.0 to 1.0) that changes 
according to the curve as time 
progresses through the 
Timeline. 


Y Time Curve 


Inputs 


This node has no inputs. 


Properties 


Curve 


The Y value defined by the curve is the factor output. For 


the curve controls see: Curve widget. 


Tip 


Flipping the curve around reverses the time input, but 
doing so is easily overlooked in the node setup. 


Start, End 
Start frame and End frame of the range of time 
specifying the values the output should last. This range 
becomes the X axis of the graph. The time input could be 
reversed by specifying a start frame greater than the end 
frame. 


Outputs 


Factor 
A speed of time factor (from 0.0 to 1.0) relative to the 
scene’s Frame Rate. The factor changes according to the 
defined curve. 


Hint 
Output values 


The Map Value node can be used to map the output to a 
more appropriate value. With sometimes curves, it is 
possible that the Time Curve node may output a number 
larger than one or less than zero. To be safe, use the 
Min/Max clamping function of the Map Value node to limit 
output. 


Example 


Time controls from left to right: no effect, slow 
down, freeze, accelerate, reverse. 


Track Position Node 


The Track Position node is used to 
return information about a tracking 
marker to the Compositor. 


Y Track Position 


Inputs 


This node as no inputs. 


Properties 


Movie Clip 
Used to select a Movie Clip data-block to use, for controls 
see Data-Block Menu. 


Tracking Object 
Camera object to get track information from. 


Track Name 
The name of the track to get track information from. 


Position 
Which marker position to use for output. 


Absolute: Outputs an absolute position of a 
marker. 
Relative Start: 


Outputs the positions of a marker 
relative to the first marker of a track. 
Relative Frame: 
Outputs the positions of a marker 
relative to the markers of the given 
Frame. 
Absolute Frame: 
Outputs the absolute positions of a 
marker at the given Frame. 


Outputs 


X/Y 
The marker’s X and Y location. 


Speed 
The velocity of the marker, measured in pixels per frame. 
This could be used to fake effects like motion blur by 
connecting it to the Vector Blur Node. 


Value Node 


The Value Node is a simple node to input 
numerical values to other nodes in the 
tree. Value @ 


vy Value 


0.500 


Inputs 


This node has no input sockets. 


Properties 


Single numerical value (floating-point). 


Outputs 


Value 
The value set in the node properties. 


Example 


In the following example the Va/ue Node is used to control 
multiple values at once, this makes the node a useful 
organizational tool. 


¥ Use Alpha 


image 


e Alpha 1.000 


e vA 1.000 


Example of the Value node. 
Tip 
From this you can also make different values proportional 


to each other by adding a Math Node in between the 
different links. 


Output Nodes 


These nodes are used to output the composited result in 
some way. 


Composite Node 
File Output Node 
Levels Node 

Split Viewer Node 
Viewer Node 


Composite Node 


The Composite node is where the 


actual output from the Compositor is pile SY 
connected to the renderer. This node ae Use Alpha 

is updated after each render, but also Image 

reflects changes in the node tree Alpha _—-1.000 
(provided at least one finished input 1.000 


node is connected). 


Inputs 


Connecting a node to the Composite node will output the 
result of the prior tree of that node to the Compositor. 


Image 
RGB image. The default is black, so leaving this node 
unconnected will result in a black image. 


Alpha 
Alpha channel. 


Z 
Z depth. 


Properties 


Use Alpha 
Used alpha channel, colors are treated alpha 
premultiplied. \f disabled, aloha channel gets set to 1, 
and colors are treated as alpha straight, |.e. color 
channels does not change. 


Outputs 


This node has no output sockets. 


Note 


If multiple Composite nodes are added, only the active one 
(last selected, indicated by a red header) will be used. 


File Output Node 


This node writes out an image, for 


pe Y File Output 
each frame range specified, to the s © 
filename entered, as part of a SnltalBts 
frameset sequence. ftmp/ = 


Image 


This node can be used as a way to 
automatically save the image after a 
render; In addition, since this node 
can be hooked in anywhere in the node tree, it can also 
Save intermediate images automatically. 


Inputs 


Image 
The image(s) will be saved on rendering, writing to the 
current frame. An entire sequence of images will be 
saved, when an animation is rendered. 


Note 
To support subsequent arrangement and layering of 
images, the node can supply a Z-depth map. However, 


please note that only the OpenEXR image formats save the 
Z information. 


Properties 


Base Path 


Unlike the render output filepath, this node uses a base 
directory and an image name, by default the output path 
is Composed of: {base path}/{file name}{frame number}. 
{extension}. 


Besides being split into two settings, in all other respects, 
this setting is treated the same as the render output 
path. 


File Format 
Label that shows the selected file format. 


Note 


More options can be set in the Sidebar region. 


Outputs 


This node has no output sockets. 


Levels Node 


The Levels Node read the input color 


F Y Levels 
channels and outputs analytical © 
values. The output is one-dimensional Mean @ 
meaning the visualization will be a Std Dev @ 


uniform gray color. Combined : 


Image 


Inputs 


Image 
Standard color input. 


Properties 


Channel 
Selects which color values are used to calculate 
analytics. 


Combined: Calculate values based on the red, 
green, and blue channels. 

Red: Calculate values based on the red 
channel. 

Green: Calculate values based on the green 
channel. 

Blue: Calculate values based on the blue 
channel. 

Luminance: Calculate values based on the 


Luminance of the image. 


Outputs 


Mean 
The mean is the average value of all image pixels in 
specified channel. It represents the overall brightness of 
the image and can be used as such for setups that 
depend on how “bright” or “dark” the input is. 


Standard Deviation 
How much pixel values differ from the mean. A low 
standard deviation indicates that the pixel values tend to 
be very close to the mean. A high standard deviation 
indicates that the values are spread out over a large 
range of values. 


Split Viewer Node 


The Split Viewer node takes two 
images and displays these side-by- 
side as backdrop or as a Viewer Node “ 
output. Factor 


Y Split Viewer 


Image 


Image 


Inputs 


Image 
Shown on the right or top half set by the axis. 


Image 
And respectively the left or bottom half. 


Properties 


Axis 
X or Y used as the split axis. 


Factor 
Percentage factor setting the space distribution between 
the two images. 


Outputs 


This node has no output sockets. 


Hint 


This node could be used to plan scene transitions by 
comparing the end frame of one scene with the start frame 
of another to make sure they align. 


Examples 


Example of a Split Viewer node. 


Viewer Node 


The Viewer node allows temporarily 


: ies P : v Viewer 
visualizing data from inside a node | 
graph. It can be plugged in anywhere ge Use Alpha 
to inspect an image or value map in Image 


your node tree. Alpha 1.000 


1.000 


Select a view node with LMB to switch 
between multiple viewer nodes. It is 
possible to automatically plug any 
other node into a Viewer node by pressing Shift-Ctrl-LMB on 
it. 


Inputs 


See Composite Node. 


Properties 


Tile Order 


The tile order can be defined for the backdrop image, 
using the Tile order field in the properties of the Viewer 
node (Properties panel in Sidebar region, with the Viewer 
node selected): 


Rule of thirds 


Calculates tiles around each of the nine zones defined 
by the rule of thirds. 


Bottom up 
Tiles are calculated from the bottom up. 


Random 
Calculates tiles in a non-specific order. 


Center 
Calculates the tiles around a specific center, defined 
by X and Y fields. 


X, Y 


Outputs 
This node has no output sockets. 


Note 


It is possible to add multiple Viewer nodes, though only the 
active one (last selected, indicated by a red header) will be 
shown on the backdrop or in the Image editor. 


Using the Image Editor 


The Viewer node allows results to be displayed in the Image 
Editor. The image is facilitated in the header by selecting 
Viewer Node in the linked Image data-block menu. The 
Image Editor will display the image from the currently 
selected Viewer node. 


To save the image being viewed, use /mage > Save AsS..., 
Alt-S to save the image to a file. 


The Image Editor also has three additional options in its 
header to view Images with or without Alpha, or to view the 


Alpha or Z itself. Click and holding the mouse in the Image 
displayed allows you to sample the values. 


Color Nodes 


These nodes adjust the image’s colors, for example 
increasing the contrast, making it warmer, overlaying 
another image, etc. 


e Alpha Over Node 
e Bright/Contrast Node 
e Color Balance Node 

e Color Correction Node 
e Exposure Node 

e Gamma Node 

e Hue Correct Node 

e Hue Saturation Value Node 
e Invert Node 

e Mix Node 

e Posterize 

e RGB Curves Node 

e Tone Map Node 

e Z Combine Node 


Alpha Over Node 


The Alpha Over node is used to layer 
images on top of one another. Where 
the foreground image pixels have an allie 
alpha greater than 0, it will be 

overlaid over the background image. 


Y Alpha Over 


Convert Premulti... 


Premultip! 0.000 


a 1.000 
Image ie 
Image mz 
Inputs 
Factor 


Controls the transparency of the foreground image. A 
factor less than 1 will make the foreground more 
transparent. 


Image 
Input for the background image. 


Image 
Input for the foreground image. 


Properties 


Convert Premultiplied 


Converts foreground image to Premultiplied Aloha 
format. 


The Alpha Over node is designed to work with 
premultiplied aloha color format. Use this checkbox when 
you know that your image has Straight Aloha color 
values, to perform the correct over operation. Result will 
still be premultiplied alpha. 


Premultiply 
Mix between using Premultiplied Alpha or Straight Alpha. 


When set to 1, the foreground color values will be 
multiplied by alpha, i.e. premultiplied; this is equivalent 
to enabling Convert Premultiplied. When set to 0, color 
values does not change. 


If Premultiply is not zero, Convert Premultiplied will be 
ignored. 


Note 
This is a legacy option. 


Outputs 


Image 
Standard color output. 


Examples 


Overlay 


In the node tree below, Color Ramp node is used to add an 
alpha channel to the black-and-white swirl image. Then 


Alpha Over node is used to overlay it on top of another 
image. 


lh”) 


Assembling a composite image using Alpha Over. 


Fade In 


In the next example, the Factor is used to make a “Fade In” 
effect. This effect can be animated by adding a Time node 
inputted in the Factor socket as shown below. Over the 
course of 30 frames, the Aloha Over node outputs an image 
that starts with the pure background image, and the title 
slowly appearing. 


¥ Composite © 


Bidder 


Animated fade in effect using Alpha Over. 


Note the Convert Premultiply checkbox is enabled, since as 
the foreground used a PNG image that has straight alpha. 


Bright/Contrast Node 


Y Bright/Contrast 
Image 


¥Y Convert Premulti... 


a Bright 0.000 
@ Contrast 0.000 


Inputs 


Image 
Standard color input. 


Brightness 
An additive-type factor by which to increase the overall 
brightness of the image. Use a negative number to 
darken an image. 


Contrast 
A scaling type factor by which to make brighter pixels 
brighter, but keeping the darker pixels dark. Higher 
values make details stand out. Use a negative number to 
decrease the overall contrast in the image. 


Properties 


Convert Premultiplied 


By default, it is supposed to work in premultiplied alpha. 
If the Convert Premul checkbox is not enabled, it is 
supposed to work in straight alpha. 


See Alpha Channel. 


Outputs 


Image 
Standard color output. 


Notes 


It is possible that this node will put out a value set that has 
values beyond the normal range, i.e. values greater than 
one and less than zero. If you will be using the output to mix 
with other images in the normal range, you should clamp 
the values using the Map Value node (with the Min and Max 
enabled), or put through a Color Ramp node (with all normal 
defaults). 


Clamp the values to normal range. 


Either of these nodes will scale the values back to normal 
range. In the example image, we want to intensify the 
specular pass. The bottom thread shows what happens if we 
do not clamp the values; the specular pass has a value 
much less than one in the dark areas; when added to the 
medium gray, it makes black. Passing the brightened image 
through either the Map Value or the Color Ramp node 
produces the desired effect. 


Example 


vy Render Layers CP) y Bright/Contrast 
Image Image 


Alpha @ ize i 
¥ Convert Premul 

Depth @ 
Image 


e Bright 5.000 
Ss Ss Sw e Contrast -10.000 


i \ a ] Y Use Alpha 
a 2 mage 
oe “=z 


& , Scene 


View Layer 


A basic example. 


Color Balance Node 


The Color Balance node can adjust the color and values of 
an image. 


Y Color Balance 


Image 


Correction Form... Lift/Gamma/Gain 


Image 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output image. 


Color 
Standard color input. 


Properties 


Two different correction formulas could be selected. 
Lift/Gamma/Gain 
Lift 
Increases the value of dark colors. 


Gamma 
Adjusts midtones. 


Gain 
Adjusts highlights. 


Offset/Power/Slope (ASC-CDL) 
Offset 
Summand. (Adjusts the overall brightness.) 


Basis 
Additional offset, allows to specify a negative 
Offset value. 


Power 
Over-all exponent. (Adjusts the midtones.) 


Slope 
Multiplier. (Adjusts the highlights.) 


Outputs 


Color 
Standard output image. 


Advanced 


The Offset/Power/Slope Formula 


out = (ix s+o)P 
where: 


e out: The color graded pixel code value. 

e /: The input pixel code value (0 to 1) (black to white). 

e s: Slope (any number O or greater, nominal value is 1.0). 

e o: Offset (any number, the nominal value is 0). 

e p: Power (any number greater than 0, nominal value is 
1.0). 


Color Correction 


Y Color Correction 


Saturation 


Master 1.000 


Highlights 1.000 


Midtones 1.000 
Shadows 1.000 
Midtones Start 


Image 


@ Mask 


JY Green 


Contrast 


1.000 
1.000 
1.000 
1.000 


0.200 


Gamma 
1.000 
1.000 
1.000 


1.000 


Node 


¥ Blue 

Gain 
1.000 
1.000 
1.000 


1.000 


Midtones End 


Image 


The Color Correction node can adjust the color of an image, 
separately in several tonal ranges (highlights, midtones and 
shadows) and only affect the necessary RGB channels. 


Properties 


Red, Green, Blue 


Specifies which RGB channels will be affected by the 


correction. 


Correction Tools (Columns) 


Saturation 


Adjusts the image’s saturation. 


Contrast 
Adjust image contrast. 


Gamma 
Exponential gamma correction, affecting the midtones of 
the image. (Works like Power in the Color Balance node.) 


Gain 
Multiplier, stronger influence on the highlights. (Works 
like Slope in the Color Balance node.) 


Lift 
This value (can be negative) will be added (+), linear 
lightens or darkens the image. (Works like Offset in the 
Color Balance node.) 


Tonal Ranges (Rows) 


Master 
These sliders affect the entire tonal range. 


Highlights 
These sliders only affect the highlights. 


Midtones 
These sliders only affect the midtones. 


Shadows 
Affects the dark tones of an image often affecting the 
shadows. 


Midtones Start, Midtones End 
Defines the start and the end of midtones range, i.e. 
values where the whole tonal range is divided into the 
highlights, midtones and shadows (there is also a smooth 
transition between the ranges of width 0.2 units). 


Inputs 


Image 
Standard color input. 


Mask 
Controls the amount of influence the node exerts on the 
output image. 


Outputs 


Color 
Standard color output. 


Exposure Node 


The Exposure Node adjusts the 
perceived brightness of an image by a 
scalar value. This node allows you to 
make areas of an image brighter or image SD 
dimmer. @ Exposure 0.000 


Y Exposure 


Image 


See also 


The exposure can also be adjusted in the scene Color 
Management. 


Inputs 


Image 
Standard color input. 


Exposure 
Scalar factor to adjust the exposure of the image. 


Properties 


This node has no properties. 


Outputs 


Image 
Standard color output. 


Examples 


In the example below, the Exposure node is used to increase 
the brightness of the window area using a mask. 


Example of an Exposure node. 


Gamma Node 


Use this node to apply a gamma 
correction. 


Image 


ca) Gamma 1.000 


Inputs 


Image 
Standard color input. 


Gamma 
An exponential brightness factor. 


Properties 


This node has no properties. 


Outputs 


Image 
Standard color output. 


Examples 


Example of a Gamma node. 


Hue Correct Node 


The Hue Correct Node is able to adjust the Hue, Saturation, 
and Value of an image, with an input curve. 


Y Hue Correct 


Image 


@Oe- 


Fac 


Image 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 
output image. 


Image 
Standard color input. 


Properties 


Level 
H (Hue), S (Saturation), V (Value) 


Curve 
For the curve controls see: Curve widget. By default, the 
curve is a Straight line, meaning there is no change. The 
spectrum allows you to raise or lower HSV levels for each 
range of pixel colors. To change an H, S, or V level, move 
the curve points up or down. Pixels with hue values each 
point in the horizontal position of the graph will be 
changed depending on the shape of the curve. 


Outputs 


Image 
Standard color output. 


Hue Saturation Value 
Node 


The Hue Saturation Value Node 

applies a color transformation in the 

HSV Color Model. Image 
Image al 


Hue 0.500 


Y Hue Saturation Value 


Saturatio 1.000 
Value 1.000 
Fac 1.000 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 
output image. 


Image 
Standard color input. 


Properties 


The transformations are relative shifts. In the shader and 
texture context the following properties are available as 
input sockets. 


Hue 


Specifies the hue rotation of the image. 360° are mapped 
to (0 to 1). The hue shifts of 0 (-180°) and 1 (+180°) 
have the same result. 


Saturation 
A saturation of 0 removes hues from the image, resulting 
in a grayscale image. A shift greater than 1.0 increases 
saturation. 


Value 
Value is the overall brightness of the image. 
De/Increasing values shift an image darker/lighter. 


Outputs 


Image 
Standard color output. 


Hue/Saturation Tips 


Some things to keep in mind that might help you use this 
node better: 


Hues are vice versa 
A blue image, with a Hue setting at either end of the 
spectrum (0 or 1), is output as yellow (recall that white, 
minus blue, equals yellow). A yellow image, with a Hue 
setting at 0 or 1, is blue. 


Hue and Saturation work together. 
So, a Hue of 0.5 keeps the blues the same shade of blue, 
but Saturation can deepen or lighten the intensity of that 
color. 


Gray & White are neutral hues 
A gray image, where the RGB values are equal, has no 
hue. Therefore, this node can only affect it with Value. 


This applies to all shades of gray, from black to white; 
wherever the values are equal. 


Changing the effect over time 
The Hue and Saturation values can be animated with a 
Time Node or by animating the property. 


Note 

Tinge 

This HSV node simply shifts hues that are already there. To 
colorize a gray image, or to add a tint to an image, use a 


Mix node to add in a static color from an RGB input node 
with your image. 


HSV Example 


A basic example. 


¥ Hue Saturatior 


Imag 
Hue 0.500 
Saturation 0.100 


Value 0.300 


¥ vu 


y Viewer Image 


@ RGB 
ci Alpha 


Alpha 


Mask @ 


ox : @ Use Alpha 


1.000 


Motion Blur 1.000 


¥ Use Alpha 


Imi 


e Alpha 1.000 


4 1.000 


An example of using the Factor input for masking. 


Invert Node 


The Invert Node inverts the colors in 
the input image, producing a 
negative. 


Y Invert 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 
output image. 


Color 
Standard color input. 


Properties 


In the compositing context this node has the following 
properties. 


RGB 
De/activation of the color channel inversion. 


Alpha 
De/activation of the alpha channel inversion. 


Outputs 


Color 
Standard color output. 


Example 


@ | Hue 0.500 
@ | Saturation 0.100 
@ [Value 0.300 
@ Fac 


© 


_ 


@ Use Alpha 
Image 

e Alpha 1.000 

ez 1.000 


@% Use Alpha 
Image 

© Alpha 1.000 

1.000 


The Invert node is used to invert the mask. 


Mix Node 


The Mix Node mixes images by © 
working on the individual and 
corresponding pixels of the two input 


Image 


images. Called “Mix Color” in the Mix aX 
shader, geometry, and texture cane 
context. 
@ 
Important whip 


Image 


As of Blender 3.4 this node has 
been updated in Shader and 
Geometry node editors. Files saved 
with the new node are not forward compatible. 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output image. 

Image 
The background image. The image size and resolution 
sets the dimensions of the output image. 


Image 
The foreground image. 


Properties 


Mix 
The Blend modes can be selected in the select menu. 
See Color Blend Modes for details on each blending 
mode. 


Add, Subtract, Multiply, Screen, Divide, Difference, 
Darken, Lighten, Overlay, Color Dodge, Color Burn, Hue, 
Saturation, Value, Color, Soft Light, Linear Light 


Use Alpha 
If activated, by clicking on the Color and Alpha icon, the 
Alpha channel of the second image is used for mixing. 
When deactivated, the default, the icon background is a 
light gray. The alpha channel of the base image is always 
used. 


Clamp 
Limit the output value between 0.0 and 1.0. 


Outputs 


Image 
Standard color output. 


Examples 


Below are samples of common mix modes and uses, mixing 
a color or checker with a mask. 


Some explanation of the mixing methods above might help 
you use the Mix node effectively: 


Add 
Adding blue to blue keeps it blue, but adding blue to red 
makes purple. White already has a full amount of blue, so 
it stays white. Use this to shift a color of an image. 
Adding a blue tinge makes the image feel colder. 


Subtract 
Taking Blue away from white leaves Red and Green, 
which combined make Yellow. Taking Blue away from 
Purple leaves Red. Use this to desaturate an image. 
Taking away yellow makes an image bluer and more 
depressing. 


Multiply 


Black (0.0) times anything leaves black. Anything times 
White (1.0) is itself. Use this to mask out garbage, or to 
colorize a black-and-white image. 


Hue 
Shows you how much of a color is in an image, ignoring 
all colors except what is selected: makes a monochrome 
picture (style ‘Black & Hue’). 


Mix 
Combines the two images, averaging the two. 


Lighten 
Like bleach makes your whites whiter. Used with a mask 
to lighten up a little. 


Difference 
It takes out a color. The color needed to turn Yellow into 
White is Blue. Use this to compare two very similar 
images to see what had been done to one to make it the 
other; sort of like a change log for images. You can use 
this to see a watermark (See Watermark images) you 
have placed in an image for theft detection. 


Darken 
With the colors set here, it’s like looking at the world 
through rose-colored glasses. 


Note 


Only add, subtract, multiply and divide are suitable for 
Scene Referenced images. 


Contrast Enhancement 


Here is a small node tree showing the effects of two other 
common uses for the RGB Curve: Darken and Contrast 
Enhancement. You can see the effect each curve has 
independently, and the combined effect when they are 
mixed equally. 


Example node setup showing “Darken”, “Enhance 
Contrast” and “Mix” nodes for composition. 


As you can hopefully see, our original magic monkey was 
overexposed by too much light. To cure an overexposure, 
you must both darken the image and enhance the contrast. 


In the top RGB curve, Darken, only the right side of the 
curve was lowered; thus, any X input along the bottom 
results in a geometrically less Y output. The Enhance 
Contrast RGB (S-shaped) curve scales the output such that 
middle values of X change dramatically; namely, the middle 
brightness scale is expanded, and thus, whiter whites and 


blacker blacks are output. To make this curve, simply click 
on the curve and a new control point is added. Drag the 
point around to bend the curve as you wish. The Mix node 
combines these two effects equally, and Suzanne feels 
much better. 


Watermark Images 


In the old days, a pattern was pressed into the paper mush 
as it dried, creating a mark that identified who made the 
paper and where it came from. The mark was barely 
perceptible except in just the right light. Probably the first 
form of subliminal advertising. Nowadays, people watermark 
their images to identify them as personal intellectual 
property, for subliminal advertising of the author or hosting 
service, or simply to track their image’s proliferation 
throughout the web. Blender provides a complete set of 
tools for you to both encode your watermark and to tell if an 
image has your watermark. 


Encoding your Watermark in an Image 


First, construct your own personal watermark. You can use 
your name, a word, or a shape or image not easily 
replicated. While neutral gray works best using the encoding 
method suggested, you are free to use other colors or 
patterns. It can be a single pixel or a whole gradient; it is up 
to you. In the example below, we are encoding the 
watermark in a specific location in the image using the 
Translate node; this helps later because we only have to 
look at a specific location for the mark. We then use the 
RGB to BW node to convert the image to numbers that the 
Map Value node can use to make the image subliminal. In 
this case, it reduces the mark to one-tenth of its original 
intensity. The Add node adds the corresponding pixels, 


making the ones containing the mark ever-so-slightly 
brighter. 


Embedding your mark in an image using a mark and 
specific position. 


Of course, if you want people to notice your mark, do not 
scale it So much, or make it a contrasting color. There are 
also many other ways, using other mix settings and fancier 


rigs. Feel free to experiment! 
Hint 
Additional uses 


You can also use this technique, using settings that result 
in visible effects, in title sequences to make the words 
appear to be cast on the water’s surface, or as a special 
effect to make words appear on the possessed girl’s 


forearm. 


Decoding an Image for your Watermark 


When you see an image that you think might be yours, use 
the node tree below to compare it to your stock image (pre- 


watermarked original). In this tree, the Mix node is set to 
Difference, and the Map Value node amplifies any 
difference. The result is routed to a viewer, and you can see 
how the original mark clearly stands out. 


Checking an image for your watermark. 


Various image compression algorithms lose some of the 
Original; the difference shows as noise. Experiment with 
different compression settings and marks to see which 
works best for you by having the encoding node group in 
one scene, and the decoding group in another. Use them 
while changing Blender’s image format settings, reloading 
the watermarked image after saving, to get an acceptable 
result. In the example above, the mark was clearly visible all 
the way up to JPEG compression of 50%. 


Posterize 


The Posterize Node reduces the 
number of colors that compose the 
image by converting portions of slats 
continuous gradation into abrupt image GD 
changes from one color to another. @® Steps 8.000 
This node is useful for generating 
masks in particular for rotoscoping. 


Y Posterize 


Inputs 


Image 
Standard color input. 


Steps 
The number of colors per channel; A value of 8 will result 
is \(3*8 = 512\) total colors. 


Properties 


This node has no properties. 


Outputs 


Image 
Standard color output. 


RGB Curves Node 


The RGB Curves Node allows 
color corrections for each color 
channel and levels 
adjustments in the Standard Filmlike 
compositing context. 

P g mR G B @MOe - 


Y RGB Curves 


Image 


& Fac 


Image 


White Level 


Black Level 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 


output image. 


Image 
Standard color input. 


Black Level Compositor Only 


Defines the input color that is (linear) mapped to black. 


White Level Compositor Only 
Defines the input color that is (linear) mapped to white. 


Tip 


To define the levels, use the eyedropper to select a color 
sample of a displayed image. 


Properties 


Tone Compositor Only 
Standard: TODO 2.8 
Film Like: TODO 2.8 


Channel 
Clicking on one of the channels displays the curve for 
each. 


C (Combined RGB), R (Red), G (Green), B (Blue) 


Curve 
A Bézier curve that varies the input levels (X axis) to 
produce an output level (Y axis). For the curve controls 
see: Curve widget. 


Outputs 


Image 
Standard color output. 


Examples 


Below are some common curves you can use to achieve 
desired effects. 


From left to right: 1. Lighten shadows 2. Negative 3. 
Decrease contrast 4. Posterize. 


Color Correction using Curves 


Image 
Standard Film like 


CcRicis @©9Ov ex 


) as 


¥Y Use Alpha 
Image 
Alpha 1.000 
z 1.000 


Color correction with curves. 


In this example, the image has too much red in it, so we run 
it through an RGB Curves node and reduce the Red channel. 


Also, read on for examples of the Darken and Contrast 
Enhancement curves, here. 


Color Correction using Black/White Levels 


y RGB Curves 
Image 


Standard Film like 


Gros OOS 


Color correction with Black/White Levels. 


Manually adjusting the RGB curves for color correction can 
be difficult. Another option for color correction is to use the 
Black and White Levels instead, which really might be their 
main purpose. 


In this example, the White Level is set to the color of a 
bright spot of the sand in the background, and the Black 
Level to the color in the center of the fish’s eye. To do this 
efficiently it is best to bring up the Image Editor showing the 
Original input image. You can then use the levels’ color 
picker to easily choose the appropriate colors from the input 
image, zooming into pixel level if necessary. The result can 
be fine-tuned with the R, G, and B curves like in the previous 
example. 


The curve for C is used to compensate for the increased 
contrast that is a side effect of setting Black and White 
Levels. 


Effects 


Image 


vy Render Layers © 


Standard Film like 


Image 


C RG B 


O9Nv ex 


X 1.00000 Y 0.00000 


@ | Fac 1.000 


Image 


Changing colors by inverting the 


¥ Use Alpha 
Image 

Die) Alpha 

® Z 


red channel. 


Tone Map Node 


Tone mapping is a technique used in 
image processing and computer 
graphics to map one set of colors to 
another in order to approximate the 
appearance of high dynamic range 
images in a medium that has a more 
limited dynamic range. 


Essentially, tone mapping addresses 
the problem of strong contrast 
reduction from the scene values 
(radiance) to the displayable range, 
while preserving the image details 


Y Tonemap 


Image 


R/D Photoreceptor v 


Intensity 0.000 


Contrast 0.000 
Adaptatio 1.000 
Color Corr 0.000 


and color appearance. This is important to appreciate the 


original scene content. 


Inputs 


Image 


Properties 


Type 
Rh Simple 
Key 


The value the average luminance is mapped to. 


Offset 


Normally always 1, but can be used as an extra 
control to alter the brightness curve. 


Gamma 
If not used, set to 1. 


R/D Photoreceptor 
Intensity 
If less than zero, darkens image; otherwise, makes 
it brighter. 


Contrast 
Set to 0 to use estimate from input image. 


Adaptation 
If 0, global; if 1, based on pixel intensity. 


Color Correction 
If 0, same for all channels; if 1, each independent. 


Outputs 


Image 


Z Combine Node 


The Z Combine node combines two 


images based on their Z-depth maps. 


It overlays the images using the 
provided Z values to detect which 
parts of one image are in front of the 
other. 


Inputs 


Image 
The background image. 


Z 


Z depth of the background image. 


Image 
The foreground image. 


Z 
Z depth of the foreground image. 


Properties 


Use Alpha 


Y Z Combine 


Use Alpha 
¥ Anti-Alias Z 


Image 


Image 


Z®@ 


The chosen Image pixel alpha channel is also carried 
over. If a pixel is partially or totally transparent, the result 
of the Z Combine will also be partially transparent; in 
which case the background image will show through the 
foreground (chosen) pixel. 


Anti-Alias Z 


Applies Anti-Aliasing to avoid artifacts at sharp edges or 
areas with a high contrast. 


Outputs 


Image 
If both Z values are equal, it will use the foreground 
image. Whichever Z value is less decides which image 
pixel is used. See Z-buffer. 


Z 


The combined Z depth, which allows to thread multiple Z- 
combines together. 


Examples 


Choosing closest pixels. 


In the example above, the render output from two scenes 
are mixed using the Z Combine node, one from a sphere of 
size 1.3, and the other a cube of size 1.0. The sphere and 
Square are located at the same place. The cube is tipped 
forward, so the corner in the center is closer to the camera 
than the sphere surface; so Z Combine chooses to use the 
cube’s pixels. But the sphere is slightly larger (a size of 1.3 
versus 1.0), so it does not fit totally inside the cube. At 
some point, as the cube’s sides recede back away from the 
camera, the sphere’s sides are closer. When this happens, Z 
Combine uses the sphere’s pixels to form the resulting 
picture. 


This node can be used to combine a foreground with a 
background matte painting. Walt Disney pioneered the use 
of multi-plane mattes, where three or four partial mattes 


were painted on glass and placed on the left and right at 
different Z positions; minimal camera moves to the right 
created the illusion of depth as Bambi moved through the 
forest. 


Note 
Valid Input 


Z Input Sockets do not accept fixed values; they must get 
a vector set (see Map Value node). Image Input Sockets 
will not accept a color since they do not have UV 
coordinates. 


y Composite 


‘y Z Combine 


Image @ 
Ze 


¥ Use Alpha 
¥ Anti-Alias Z 
@ Image 
ez ¥ Use Alpha 
@ Image 
® Image 
® Alpha 
e Zz 
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Mix and match images. 


The Z Combine can be used to merge two images as well. 
Using the Z values from the sphere and cube scenes above, 
but inputting different images, yields the example to the 
right. 


Z Combine in action. 


In this node setup a render scene is mixed with a flat image. 
In the side view of the scene, the orange cube is 10 units 
away from the camera, and the blue ball is 20. The 3D 
cursor is about 15 units away from the camera. The image is 
Z-in at a location of 15, thus inserting it in between the cube 
and the ball. The resulting image appears to have the cube 
on the green image. 


Note 
Invisible Man Effect 


If a foreground image with a higher Alpha than the 
background, is then mixed in the Z Combine with a slightly 


magnified background, the outline of the transparent area 
will distort the background, enough to make it look like 
seeing a part of the background through an invisible yet 
Fresnel-lens object. 


Converter Nodes 


As the name implies, these nodes convert the colors or 
other properties of various data (e.g. transparency) in some 
way. 


They also split out or re-combine the different color 
channels that make up an image, allowing you to work on 
each channel independently. Various color channel 
arrangements are supported, including traditional RGB, HSV 
and HDMI formats. 


Alpha Convert Node 
Color Space Node 
Color Ramp Node 
Combine Color Node 
Combine XYZ Node 
ID Mask Node 

Math Node 

RGB to BW Node 
Separate Color Node 
Separate XYZ Node 
Set Alpha Node 
Switch View Node 


Alpha Convert Node 


The Alpha Convert Node converts the 
alpha channel interpretation of an 
image. Image 


Y Alpha Convert 


To Premultiplied v 


For compositing and rendering, 
Premultiplied Alpha is the standard in image 
Blender. Render layers will be 
premultiplied alpha, and images 
loaded into rendering or compositing will be converted to 
this. 


If you want to do a compositing operation with straight 
alpha, the Aloha Convert node can be used. Typically this 
would be a color correction operation where it might give 
better results working on RGB channels without alpha. If the 
alpha is converted to straight in the Compositor, it should be 
converted back to premultiplied before the Composite 
Output node, otherwise some artifacts might occur. 


Inputs 


Image 
Standard color input. 


Properties 


Mapping 
The direction of convert alpha. For details on the 
difference between both ways to store alpha values see 
Alpha Channel. 


To Premultiplied: 
Converts from Straight Alpha to 
Premultiplied Alpha. 

To Straight: Converts from Premultiplied Alpha to 
Straight Alpha. 


Outputs 


Image 
Standard color output. 


Color Space Node 


The Color Space Node converts 
images from one color spaces. 


Y Convert Colorspace 


Image 


Note From: Linear 
Images are already automatically rds 
converted into linear color space 
unless specified in the image’s 
Color Space option. 


Inputs 


Image 
Standard color input. 


Properties 


From, To 
The color space of the input image and the color space to 
convert the image to. 


The list of color spaces depends on the active OCIO 
contig. The default supported color spaces are described 
in detail here: Default OpenColorlO Configuration 


Outputs 


Image 
Standard color output. 


Color Ramp Node 


The Color Ramp Node is 
used for mapping values 
to colors with the use of a image 

gradient. Alpha @ 


Y ColorRamp 


Inputs 


Factor 
The Factor input is used as an index for the color ramp. 


Properties 


Color Ramp 
For controls see Color Ramp Widget. 


Outputs 


Image 
Standard color output. 


Alpha 


Standard alpha output. 


Examples 


Creating an Alpha Mask 


An often overlooked use case of the Color Ramp is to create 
an alpha mask, or a mask that is overlaid on top of another 
image. Such a mask allows you to select parts of the 
background to be shown through. 


Using the Color Ramp node to create an alpha mask. 


In the map above, a black-and-white swirl image, which is 
lacking an alpha channel, is fed into the Color Ramp node as 
a Factor. 


The Color Ramp node is set to a purely transparent color on 
the left end of the gradient, and a fully red color on the 
right. As you can see in the Viewer node, the Color Ramp 
node puts out a mask that is fully transparent where the 
image is black. Black is zero, so Color Ramp outputs the 
color at the left end of the gradient, which is set to 
transparent. The Color Ramp image is fully red and opaque 
where the image is white (which is 1). 


You can verify that the output image mask is indeed 
transparent by overlaying it on top of another image. 


Colorizing an Image 


In this example multiple colors are added to the color 
gradient converting a black-and-white image into a flaming 
swirl. 


1) 


Image 


Alpha @ 


Depth @ 


The shades of gray in the input image are mapped to three 
colors: blue, yellow, and red, all fully opaque (alpha of 1). 
Where the image is black, Color Ramp substitutes blue (the 
first color stop). Where it is some shade of gray, Color Ramp 
outputs a corresponding color from the gradient (bluish, 


yellow, to reddish). Where the image is fully white, the Color 
Ramp outputs red. 


Combine Color Node 


The Combine Color Node combines an v Combine Color 
image from its composite color 

channels. The node can combine 
multiple Color Models depending on v 
the Mode property. 


Color 


Inputs 


The outputs of this node depends on the Mode property (see 
below). 


Alpha 
The color channel that that is responsible for the image’s 
transparency. 


Properties 
Mode 
The color model to output. 
RGB: Combine the three inputs: Red, Green, 
and Blue color channels into a single 
image. 


HSV: 


Combine the three inputs: Hue, 
Saturation, and Value color channels 
into a single image. 


HSL: Combine the three inputs: Hue, 
Saturation, and Lightness color 
channels into a single image. 


YCbCrA: Combine the three inputs: Luminance, 
Chrominance Blue, and Chrominance 
Red color channels into a single image. 
Color Space 
ITU 601, ITU 709, JPEG 


YUV: Combine the three inputs: Luminance, 
U chrominance, and V chrominance 
color channels into a single image. 


Output 


Image 
Standard image output. 


Examples 


Blur Alpha 


An example of blurring the alpha channel. 


In this first example, we take the Alpha channel and blur it, 
and then combine it back with the colors. When placed ina 
scene, the edges of it will blend in, instead of having a hard 
edge. This is almost like but in a three- 
dimensional sense. Use this node setup, when adding CG 
elements to live action to remove any hard edges. 
Animating this effect on a broader scale will make the object 
appear to “phase” in and out, as an “out-of-phase” time- 
traveling sync effect. 


Increase Luminance 


An example of the scaling the Luminance channel. 


This example has a Math (Multiply) node increasing the 
luminance channel (Y) of the image to make it brighter. 


Tip 


If running these channels through a Color Ramp node to 
adjust value, use the Cardinal scale for accurate 
representation. Using the Exponential scale on the 
luminance channel gives a high-contrast effect. 


Combine XYZ Node 


The Combine XYZ Node combines a 

vector from its individual 

components. ca 
0.000 


Y Combine XYZ 


0.000 
0.000 


Inputs 


eee 
N ~< xX 


Properties 


This node has no properties. 


Output 


Vector 
Standard vector output. 


Note 


The vector is not normalized. 


ID Mask Node 


The ID Mask Node can be used to 
access an alpha mask per object or 
per material. 


v ID Mask 


Alpha @ 


Index 0 
Anti-Aliasing 


G ID value 1.000 


Inputs 


ID Value 
Input for the Object Index or Material Index render pass. 
Which is an output of the Render Layers node or the 
Image node with a multi-layer format. 


Properties 


Index 
Selection of the previously specified index. 


Anti-Aliasing 
This post-processing filter smooths the mask edges. See 
Anti-Aliasing. 


Outputs 


Alpha 


The mask is white where the object is and black where it 
is not. If the object is transparent, the aloha mask 
represent that with gray values. 


Setup 


An index can be specify for any object or material in the 
scene. The Object Index can be set in Properties » Object 
Properties » Relations » Pass Index and Material » Settings » 
Pass Index for the Material Index. To be accessible after 
rendering, Object Index or Material Index render pass has to 
be enabled. 


Y Relations 


Parent @ 


Tracking Axis +Y 


UpAxis Z 


Pass Index 


Object Pass Index. 


Example 


In this example, the left rear red cube is assigned Pass Index 
1, and the right cube Pass Index 2. Where the two cubes 
intersect, there is going to be noticeable pixelation because 
they come together at a sharp angle and are different 
colors. Using the mask from object 1, which is smoothed 
(anti-aliased) at the edges, we use a Mix Node set on 
Multiply to multiply the smoothed edges of the image, thus 
removing those nasty lines, thus, being smoothed out. 


ID Mask node example. 


Limitations 


e Volume Objects are not supported. 


Math Node 


The Math Node performs math 


operations. 
Value @ 


v 


Clamp 


o Value 0.500 
@ Value 0.500 


Inputs 


The inputs of the node are dynamic. Some inputs are only 
available in certain operations. For instance, the Addend 
input is only available in the Multiply Add operator. 


Value 
Input Value. Trigonometric functions read this value as 
radians. 


Addend 
Input Addend. 


Base 
Input Base. 


Exponent 
Input Exponent. 


Epsilon 
Input Epsilon. 


Distance 
Input Distance. 


Min 
Input Minimum. 


Max 
Input Maximum. 


Increment 
Input Increment. 


Scale 
Input Scale. 


Degrees 
Input Degrees. 


Radians 
Input Radians. 


Properties 


Operation 


The mathematical operator to be applied to the input 


values: 


Functions 
Add: 
Subtract: 


Multiply: 
Divide: 


Multiply Add: 


The sum of the two values. 

The difference between the two 
values. 

The product of the two values. 

The division of the first value by the 
second value. 

The sum of the product of the two 
values with Addend. 


Power: 
Logarithm: 
Square Root: 
Inverse Square 


Absolute: 


Exponent: 


Comparison 
Minimum: 


Maximum: 


Less Than: 


Greater Than: 


Sign: 


Compare: 


The Base raised to the power of 
Exponent. 

The log of the value with a Base as 
its base. 

The square root of the value. 

Root: 

One divided by the square root of 
the value. 

The input value is read without 
regard to its sign. This turns 
negative values into positive values. 
Raises Euler’s number to the power 
of the value. 


Outputs the smallest of the input 
values. 

Outputs the largest of two input 
values. 

Outputs 1.0 if the first value is 
Smaller than the second value. 
Otherwise the output is 0.0. 
Outputs 1.0 if the first value is larger 
than the second value. Otherwise 
the output is 0.0. 

Extracts the sign of the input value. 
All positive numbers will output 1.0. 
All negative numbers will output 
-1.0. And 0.0 will output 0.0. 
Outputs 1.0 if the difference 
between the two input values is less 
than or equal to Epsilon. 


Smooth Minimum: 


Smooth Minimum. 


Smooth Maximum: 


Smooth Maximum. 


Rounding 


Round: 
Floor: 
Ceil: 
Truncate: 
Fraction: 


Modulo: 


Wrap: 


Snap: 


Ping-pong: 


Trigonometric 


Sine: 
Cosine: 
Tangent: 
Arcsine: 
Arccosine: 


Arctangent: 


Arctan2: 


Rounds the input value to the 
nearest integer. 

Rounds the input value down to the 
nearest integer. 

Rounds the input value up to the 
nearest integer. 

Outputs the integer part of the 
value. 

Returns the fractional part of the 
value. 

Outputs the remainder once the first 
value is divided by the second 
value. 

Outputs a value between Min and 
Max based on the absolute 
difference between the input value 
and the nearest integer multiple of 
Max less than the value. 

Rounds the input value down to the 
nearest integer multiple of 
Increment. 

The output value is moved between 
0.0 and the Scale based on the input 
value. 


The Sine of the input value. 

The Cosine of the input value. 

The Tangent of the input value. 
The Arcsine of the input value. 
The Arccosine of the input value. 
The Arctangent of the input value. 
Outputs the Inverse Tangent of the 
first value divided by the second 
value measured in radians. 


Hyperbolic Sine: 
The Hyperbolic Sine of the input 
value. 

Hyperbolic Cosine: 
The Hyperbolic Cosine of the input 
value. 

Hyperbolic Tangent: 
The Hyperbolic Tangent of the input 


value. 
Conversion 
To Radians: Converts the input from degrees to 
radians. 
To Degrees: Converts the input from radians to 
degrees. 
Clamp 


Limits the output to the range (0.0 to 1.0). See Clamp. 


Outputs 


Value 
Numerical value output. 


Examples 


Manual Z-Mask 


Minimum and maximum function example. 


This example has one scene input by the top Render Layers 
node, which has a cube that is about 10 units from the 
camera. The bottom Render Layers node inputs a scene 
with a plane that covers the left half of the view and is 7 
units from the camera. Both are fed through their respective 
Map Value nodes to divide the Z-buffer by 20 (multiply by 
0.05, as shown in the Size field) and clamped to be a 
min/max of 0.0/1.0 respectively. 


For the minimum function, the node selects those Z values 
where the corresponding pixel is closer to the camera; so it 
chooses the Z values for the plane and part of the cube. The 
background has an infinite Z value, so it is clamped to 1.0 
(shown as white). In the maximum example, the Z values of 
the cube are greater than the plane, so they are chosen for 


the left side, but the plane Render Layers Z are infinite 
(mapped to 1.0) for the right side, so they are chosen. 


Using Sine Function to Pulsate 


Using sine function example. 


This example has a Time node putting out a linear sequence 
from O to 1 over the course of 101 frames. At frame 25, the 
output value is 0.25. That value is multiplied by 2 x pi 
(6.28) and converted to 1.0 by the Sine function, since \ 
(sin(2 x pi/ 4) = sin(pi/ 2) = +1.0\). 


Since the sine function can put out values between (-1.0 to 
1.0), the Map Value node scales that to 0.0 to 1.0 by taking 
the input (-1 to 1), adding 1 (making O to 2), and multiplying 
the result by one-half (thus scaling the output between 0 to 
1). The default Color Ramp converts those values to a gray- 
scale. Thus, medium gray corresponds to a 0.0 output by 
the sine, black to -1.0, and white to 1.0. As you can see, \ 
(sin(pi/ 2) = 1.0\). Like having your own visual color 
calculator! Animating this node setup provides a smooth 
cyclic sequence through the range of grays. 


Use this function to vary, for example, the alpha channel of 
an image to produce a fading in/out effect. Alter the Z 
channel to move a scene in/out of focus. Alter a color 
channel value to make a color “pulse”. 


Brightening (Scaling) a Channel 


Scaling a channel example. 


This example has a Math (Multiply) node increasing the 
luminance channel (Y) of the image to make it brighter. Note 
that you should use a Map Value node with min() and max() 
enabled to clamp the output to valid values. With this 
approach, you could use a logarithmic function to make a 
high dynamic range image. For this particular example, 
there is also a Bright/Contrast node that might give simpler 
control over brightness. 


Restrict Color Selection (Posterization) 


Posterization example. 


In this example, we restrict the color values to be one of the 
six values: 0, 0.2, 0.4, 0.6, 0.8, 1. 


To split up a continuous range of values between 0 and 1 to 
certain set of values, the following function is used: \ 
(round(x x n- 0.5) / (n- 1)\), where “n” is the number of 
possible output values, and “x” is the input pixel color. Read 
more about this function. 


To implement this function in Blender, consider the node 
setup above. We string the Math nodes into a function that 
takes each color (values from 0 to 1), multiplies it up by six, 
the desired number of divisions (values become from 0 to 
6), offsets it by 0.5 (-0.5 to 5.5), rounds the value to the 
nearest whole number (produces O, 1, 2, 3, 4, 5), and then 
divides the image pixel color by five (0.0, 0.2, 0.4, 0.6, 0.8, 
1.0). 


In the case of a color image, you need to split it into 
separate RGB channels using Separate/Combine RGBA 
nodes and perform this operation on each channel 
independently. 


RGB to BW Node 


The RGB to BW Node maps an RGB color 
image to a gray-scale by the luminance. 


Y RGB to BW 


Inputs 


Image 
Color image input. 


Properties 


This node has no properties. 


Outputs 


Value 
Gray-scale value output. 


Separate Color Node 


The Separate Color Node splits an 
image into its composite color 


Y Separate Color 


channels. The node can output incl Se 
multiple Color Models depending on Green 
the Mode property. Blue 


Alpha © 


Inputs 


Image 
Standard image input. 


Properties 
Mode 

The color model to output. 

RGB: Split the input image into it’s three 
outputs: Red, Green, and Blue color 
channels. 

HSV: Split the input image into it’s three 


outputs: Hue, Saturation, and Value 
color channels. 


HSL: 


YCbCrA: 


YUV: 


Outputs 


Split the input image into it’s three 
outputs: Hue, Saturation, and Lightness 
color channels. 


Split the input image into it’s three 
outputs: Luminance, Chrominance 
Blue, and Chrominance Red color 
channels. 
Color Space 

ITU 601, ITU 709, JPEG 


Split the input image into it’s three 
outputs: Luminance, U chrominance, 
and V chrominance color channels. 


The outputs of this node depends on the Mode property (see 


above). 


Alpha 


The color channel that that is responsible for the image’s 


transparency. 


Examples 


Blur Alpha 


An example of blurring the alpha channel. 


In this first example, we take the Alpha channel and blur it, 
and then combine it back with the colors. When placed ina 
scene, the edges of it will blend in, instead of having a hard 
edge. This is almost like but in a three- 
dimensional sense. Use this node setup, when adding CG 
elements to live action to remove any hard edges. 
Animating this effect on a broader scale will make the object 
appear to “phase” in and out, as an “out-of-phase” time- 
traveling sync effect. 


Increase Luminance 


An example of the scaling the Luminance channel. 


This example has a Math (Multiply) node increasing the 
luminance channel (Y) of the image to make it brighter. 


Tip 


If running these channels through a Color Ramp node to 
adjust value, use the Cardinal scale for accurate 
representation. Using the Exponential scale on the 
luminance channel gives a high-contrast effect. 


Separate XYZ Node 


The Separate XYZ Node splits a 
vector into its individual components. 


v Separate XYZ 


Vector: 
0.000 
0.000 
0.000 


Input 


Vector 
Standard vector input. 


Properties 


This node has no properties. 


Outputs 


eee 
N ~< &X 


Set Alpha Node 


The Set Alpha Node adds an alpha 
channel to an image. 


Inputs 


Image 
Standard color input. 


Alpha 


Y Set Alpha 


Image 


Mode: Apply Maskv 


Alpha 1.000 


The amount of Alpha can be set for the whole image by 
using the input field or per pixel by connecting to the 


socket. 


Properties 


Mode 


Method to mix the alpha with the input Image. 


Apply Mask: Multiply the input images RGBA 
channels by the Alpha input value. In 
this cases, the output is using 


Premultiplied Alpha. 
Replace Alpha: 


Replace the inputs alpha channel with 
the Alpha input value. In this cases, the 
output is using Straight Alpha. 


Outputs 


Image 
Standard color output. 


Note 


This is not, and is not intended to be, a general-purpose 
solution to the problem of compositing an image that does 
not contain alpha information. You might wish to use 
“chroma keying” or “difference keying” (as discussed 
elsewhere) if you can. This node is most often used (with a 
Suitable input being provided by means of the socket) in 
those troublesome cases when you cannot, for some 
reason, use those techniques directly. 


Example 


Fade To Black 


To transition the audience from one scene or shot to 
another, a common technique is to “fade to black”. As its 
name implies, the scene fades to a black screen. You can 
also “fade to white” or whatever color you wish, but black is 
a good neutral color that is easy on the eyes and 
intellectually “resets” the viewer’s mind. The node tree 
below shows how to do this using the Set Alpha node. 


Fade to black. 


In the example above, the alpha channel of the swirl image 
is ignored. Instead, a Time Curve node introduces a factor 
from 0.0 to 1.0 over 60 frames, or about 2 seconds, to the 
Set Alpha node. Note that the time curve is exponentially- 
shaped, so that the overall blackness will fade in slowly and 
then accelerate toward the end. The Set Alpha node does 
not need an input image; instead, the flat (shadeless) black 
color is used. The Set Alpha Node uses the input factor and 
color to create a black image that has an alpha set which 
goes from 0.0 to 1.0 over 60 frames, or completely 
transparent to completely opaque. Think of alpha as a 
multiplier for how vivid you can see that pixel. These two 
images are combined by the Alpha Over node completely (a 
Factor of 1.0) to produce the composite image. The Set 
Alpha node will thus, depending on the frame being 
rendered, produce a black image that has some amount of 
transparency. Setup and animate, and you have an image 
sequence that fades to black over a two-second period. 


Note 
No Scene Information Used 


This example node tree does not use the Render Layer 
node. To produce this 2-second animation, no Blender 
scene information was used. This is an example of using 
Blender’s powerful compositing abilities separate from its 
modeling and animation capabilities. (A Render Layer 
could be substituted for the Image layer, and the “fade- 
network” effect will still produce the same effect.) 


Fade In a Title 


To introduce your animation, you will want to present the 
title of your animation over a background. You can have the 
title fly in, or fade it in. To fade it in, use the Set Alpha node 
with the Time Curve node as shown below. 


Ay Tt! Ome x 


Single Image v ¥ Set Alpha 


Color Sp. 


Image 


@ Alpha 
» Time te 


Using Set Alpha to fade in a title. 


In the above example, a Time curve provides the Alpha 
value to the input socket. The current Render Layer node, 
which has the title in view, provides the image. As before, 
the Alpha Over node mixes (using the alpha values) the 
background swirl and the alpha title to produce the 
composite image. 


Colorizing a BW Image 


y Alpha Over 
Image 
Convert Premul 


Premul 0.000 


@ Use Alpha 


Ay ima (Ge x 


Single Image 


Image 
e Alpha 


Color Sp.. sRGB ¥ 
Ss Z 


@ Alpha 0.300 


Using Set Alpha to colorize an image. 


In the example above, notice how the blue tinge of the 
render input colors the swirl. You can use the Set Alpha 
node’s color field with this kind of node tree to add a 
consistent color to a BW image. 


In the example tree to the right, use the Alpha value of the 
Set Alpha node to give a desired degree of colorization. 


Thread the input image and the Set Alpha node into an 
Alpha Over node to colorize any black-and-white image in 
this manner. 


Switch View Node 


The Switch View node combines the 
views (left and right) into a single 
Stereo 3D output. This can be useful if mage 
for example, you need to treat the 
view as separate images by 
combining each of the views. 


Y Switch View 


See also 


The multi-view workflow. 


Inputs 


Left 
Left-eye image input. 


Right 
Right-eye image input. 


Properties 


This node has no properties. 


Outputs 


Image 
Stereo 3D image output. 


Example 


Compositor, Backdrop and Split Viewer Node. 


The views to render are defined in the current scene views, 
in a similar way as you define the composite output 
resolution in the current scene render panel, regardless of 
the Image nodes resolutions or Render Layers from different 
scenes. 


Filter Nodes 


Filters process the pixels of an image to highlight additional 
details or perform some sort of post-processing effect on the 
image. 


Anti-Aliasing Node 
Bilateral Blur Node 
Blur Node 

Bokeh Blur Node 
Defocus Node 
Denoise Node 
Despeckle Node 
Dilate/Erode Node 
Directional Blur Node 
Filter Node 

Glare Node 

Inpaint Node 

Pixelate Node 

Sun Beams Node 
Vector (Motion) Blur Node 


Anti-Aliasing Node 


The Anti-Aliasing node removes 
distortion artifacts around edges 
known as aliasing. sUilai 


Y Anti-Aliasing © 


Threshold 1.000 
Contrast Limit 0.200 
Corner Roundin 0.250 


Inputs 


Image 
Standard color input. 


Properties 


Threshold 


Controls edge detection sensitivity across the whole 
image. 


Contrast Limit 
Controls contrast level to consider when detecting edges. 


The human eye does not perceive all edges equally. For 
instance, it tends to mask low contrast edges in the 
presence of much higher contrasts in the surrounding 
area. Therefore, applying anti-aliasing to unperceived 
edges will produce artifacts. This option quantifies the 


difference between low contrast and high contrast 
neighboring edges. 


Corner Rounding 
Detect corners to help preserve the original shape. 
Setting Corner Rounding to 0 means no corner detection 
and no corner rounding will take place. The higher the 
value the better corners will be preserved, i.e. resemble 
Original image. 


Outputs 


Image 
Standard color output. 


Examples 


The Anti-Aliasing node has three properties shown here. 


Changing threshold Changing contrast 
affects all edges. limit affects 


neighboring edges 
below contrast limit. 


The effect of corner rounding. 


Corner detection 
and rounding off (set 
to 0). Notice how 


corners are 
smoothed because 
they are treated as 
artifacts. 


Full corner detection 
and rounding 
preserves the sharp 
edges around the 
corner. 


Bilateral Blur Node 


The Bilateral Blur node performs a 
high-quality adaptive blur on the 

source image, allowing to blur images sists 
while retaining their sharp edges. 


Y Bilateral Blur 


Iterations ri 


. Color Sig 0.300 
It can be used for various purposes 


like: smoothing noisy render passes 
to avoid longer computation times in image 
example ray-traced ambient Deter. GD 
occlusion, blurry 
refractions/reflections, soft shadows, 
or to make non-photorealistic 
compositing effects. 


Space Sig 5.000 


Inputs 


Image 
Standard color input. If only the image input is 
connected, the node blurs the image depending on the 
edges present in the source image. 


Determinator 
Which is non-obligatory and if the Determinator is 
connected, it serves as the source for defining 
edges/borders for the blur in the image. This has great 
advantage in case the source image is too noisy, but 
normals in combination with Z-buffer can still define 
exact borders/edges of objects. 


Properties 


Iterations 
Defines how many times the filter should perform the 
operation on the image. It practically defines the radius 
of blur. 


Color Sigma 
Defines the threshold for which color differences in the 
image should be taken as edges. 


Space Sigma 
A fine-tuning variable for blur radius. 


Outputs 


Image 
Standard color output. 


Example 


Bilateral smoothed Ambient Occlusion. blend-file 
example 


Render result. Composite. 


Blur Node 


The Blur node blurs an image, © 
providing several blur modes. 


Image 


Gaussian v 
Variable Size 
Bokeh 
Gamma 


Relative 


Image 


a Size 


Inputs 


Image 
Standard color input. 


Size 
The optional Size input will be multiplied with the X and Y 
blur radius values. It also accepts a value image, to 


control the blur radius with a mask. The values should be 
mapped between (0 to 1) for an optimal effect. 


Properties 


Type 
The difference between the types is in the way they 
handle sharp edges, smooth gradients and preserve the 
highs and the lows. 


Flat: Simply blurs everything uniformly. 

Tent: Preserves the high and the lows better 
by making a linear falloff. 

Quadratic: Looks similar to Gaussian but can be a 
little faster but slightly worse looking. 

Cubic: Preserve the highs, but give an almost 
out-of-focus blur while smoothing sharp 
edges. 

Gaussian: Gives the best looking results but tends 


to be the slowest. 
Fast Gaussian: An approximation of the Gaussian. 
Catmull-Rom: Catmull-Rom keeps sharp contrast 


edges crisp. 

Mitch: Preserve the highs, but give an almost 
out-of-focus blur while smoothing sharp 
edges. 


Variable Size 
Allows a variable blur radius, if the size input is an image. 


Bokeh 
The Bokeh button will force the Blur node to use a 
circular blur filter. This gives higher quality results, but 
is Slower than using a normal filter. 


Gamma 
The Gamma button applies a gamma correction on the 
image before blurring it. 


Relative 


Percentage Value of the blur radius relative to the image 
size. 


Aspect Correction 
None, Y, X 


X, Y 
Values set the ellipsoid radius in numbers of pixels over 
which to spread the blur effect. 


Extend Bounds 


Allows the image, that is being blurred, to extend past its 
original dimension. 


Outputs 


Image 
Standard color output. 


Example 
Blur node blur modes using 20% of image size as XY, no 
Bokeh/Gamma. 
ouiginal Flat. Tent. 


image. 


Quadratic. 


Fast 
Gaussian. 


Cubic. 


Catmull- 
Rom. 


Gaussian. 


Mitch. 


Bokeh Blur Node 


The Bokeh Blur node generates a 
bokeh type blur similar to Defocus. 
Unlike defocus an in-focus region is 
defined in the Compositor. There is 
also more flexibility in the type of blur 
applied through the Bokeh Image 
node. 


Several performance optimizations 
are also available such as OpenCL 
Support, calculation area restriction 
and masking. 


Inputs 


Image 
Standard color input. 


Bokeh 


Y Bokeh Blur 
Image 
Variable Size 
Max Blur 16.000 


Extend Bounds 


o Size 1.000 


a Bounding 1.000 


This is an input for the Bokeh Image node. 


Size 


Size controls the amount of blur. Size can either be a 
single value across the entire image or a variable value 
controlled by an input image. In order to use the latter, 
the Variable Size option must be selected. See the 
examples section below for more on how to use this. 


Bounding Box 


This can be used with a Box Mask matte node or witha 
Mask input node to restrict the area of the image the blur 
is applied to. This could be helpful, for example, when 
developing a node system by allowing only a small area 
of the image to be filtered thus saving composite time 
each time adjustments are made. 


Properties 


Variable Size 
Allows a variable blur radius, if the Size input is an 
image. 


Max Blur 
Max Blur is intended to act as an optimization tool by 
limiting the number of pixels across which the blur is 
calculated. 


Outputs 


Image 
Standard color output. 


Examples 


Three examples of how the size input may be used follow. 


An ID masked alpha image can be used so that a 
background is blurred while foreground objects remain in 
focus. To prevent strange edges the Dilate Node should be 
used. 


The Z pass can be visualized using a node anda 
node as described in .A multiply 
node can be used following the color ramp so that a 


blur value greater than one is used for objects outside the 
focal range. 


y Bokeh Image © 


Image 


y Bokeh Blur 
Image 
Flaps 


@ Variable Size 
Angle 27° 


Max Blu 16.000 
§RBiding 0.300 


Extend Bounds 
Catadioptri 0.000 


hi «0.300 


Multiply 
Image Clamp e Bounding 1.000 
0.000 4 
Alpha @ e@ Value 


ze: 
® 
Value 16.000 


Use Minimum 


Use Maximum 


@® Value 


Z pass used. 


A manually created grayscale image can be used to define 
the sharp and blurry areas of a pre-existing image. Again, a 


Multiply Node can be used so that a blur value greater than 
One is used. 


y Bokeh Blur 


Image @ 


y Composite © 


¥ Variable Size 
Image @® ¥ Use Alpha 
Max Blur 16.000 
@ Image 
Extend Bounds e Alpha 1.000 


Image e Z 1.000 


Bokeh 
Size 


Bounding 1.000 


la} Blur (Cpe Xx 
Single Image 


Color Sp... sRGB 


Image used. 


Z pass used. Image used. 


Defocus Node 


The Defocus Node blurs areas of an 
image based on a map/mask input. 


Y Defocus 


Image 


It is typically used to emulate depth 


of field (DOF) using a post-processing pete 
method with a Z-buffer input. But also Sabine 

allows to blur images that are not Fits 0° 
based on Z depth too. Gamma Correcti... 


Max Blur 16.000 
Threshold 1.000 
¥ Preview 
a3 
Use Z-Buffer 
Z-Scale 1.000 


Image 


Inputs 


Image 
Standard color input. 


Z 


Z-buffer input, but could also be a (grayscale) image 
used as a mask, or a single value input. 


Properties 


Bokeh Type 


The number of iris blades of the virtual camera’s 
diaphragm. 


Disk (to emulate a perfect circle), Triangle (3 blades), 
Square (4 blades), Pentagon (5 blades), Hexagon (6 
blades), Heptagon (7 blades) or Octagon (8 blades). 


Angle 
This slider is deactivated, if the Bokeh Type is set to Disk. 
It can be used to add a rotation offset to the Bokeh 
Shape. The value is the angle in degrees. 


Gamma Correction 


Applies a gamma correction on the image before and 
after blurring it. 


F-Stop 
This option controls the amount of focal blur in the same 
way aS a real camera. It simulates the aperture f of a real 
lens’ iris, without modifying the luminosity of the picture. 
The default value 128 is assumed to be infinity: 
everything is in perfect focus. Half the value will double 
the amount of blur. This slider is deactivated, if No Z- 
buffer is enabled. 


Max Blur 


This value limits the amount of blur by setting a 
maximum blur radius. Can be used to optimize the 
performance. The default value of 0 means no limit. 


Threshold 


Some artifacts, like edge bleed, may occur, if the blur 
difference between pixels is large. This value controls 
how large that blur difference considered to be safe. 


Tip 


Only change this value, if there is an occurring problem 
with an in-focus object. 


Preview 
If enabled a limited amount of (quasi-)random samples 
are used to render the preview. This way of sampling 


introduces additional noise, which will not show up in the 
final render. 


Scene 
To select the linked scene. 


No Z-buffer 


Should be activated for a non Z-buffer in the Z input. No 
Z-buffer will be enabled automatically whenever a node 
that is not image based is connected to the Z input. 


Z Scale 


Only active when No Z-buffer is enabled. When No Z- 
buffer is used, the input is used directly to control the 
blur radius (similar to F-Stop when using the Z-buffer). 
This parameter can be used to scale the range of the Z 
input. 


Outputs 


Image 
Standard color output. 


Examples 


E. 


In this blend-file example, the ball array image is blurred as 
if it was taken by a camera with an f-stop of 2.8 resulting in 
a fairly narrow depth of field centered on 7.5 units from the 
camera. As the balls recede into the distance, they get 
blurrier. 


No Z-Buffer Examples 


Sometimes might want to have more control to blur the 
image. For instance, you may want to only blur one object 
while leaving everything else alone (or the other way 
around), or you want to blur the whole image uniformly all 
at once. The node, therefore, allows you to use something 
other than an actual Z-buffer as the Z input. For instance, 
you could connect an Image node and use a grayscale 
image where the color designates how much to blur the 
image at that point, where white is the maximum blur and 
black is no blur. Or, you could use a Time node to uniformly 
blur the image, where the time value controls the maximum 
blur for that frame. It may also be used to obtain a possibly 
Slightly better DoF blur, by using a fake depth-shaded image 
instead of a Z-buffer. (A typical method to create the fake 


depth-shaded image is by using a linear blend texture for all 
objects in the scene or by using the “fog/mist” fake depth 
Shading method.) This also has the advantage that the fake 
depth image can have Anti-Aliasing, which is not possible 
with a real Z-buffer. 


The parameter No Z-buffer, becomes then the main blur 
control. The input has to be scaled, because usually the 
value of a texture is only in the numeric range 0.0 to 1.0. 


Camera Settings 


¥ Depth of Field 


Focus on Object 
Focus Distance 
¥ Aperture 
F-Stop 
Blades 
Rotation 


Ratio 


Distance setting in the Camera Depth of Field panel. 


The Defocus node uses the actual camera data in your 
scene if supplied by a Render Layer node. 


To set the point of focus, the camera now has a Distance 
parameter, which is shorthand for Depth of Field Distance. 
Use this camera parameter to set the focal plane of the 
camera (objects Depth of Field Distance away from the 
camera are in focus). Set Distance in the main Camera edit 
panel; the button is right below the Depth of Field. 


To make the focal point visible, enable the camera Limits 
option, the focal point is then visible as a yellow cross along 


the view direction of the camera. 


Hints 


Preview 
In general, use preview mode, change parameters to 
your liking, only then disable preview mode for the final 
render. 


Edge Artifacts 
For minimum artifacts, try to setup your scene such that 
differences in distances between two objects that may 
visibly overlap at some point are not too large. 


“Focus Pull” 
Keep in mind that this is not real DoF, only a post- 
processing simulation. Some things cannot be done 
which would be no problem for real DoF at all. A typical 
example is a scene with some object very close to the 
camera, and the camera focusing on some point far 
behind it. In the real world, using shallow depth of field, it 
is not impossible for nearby objects to become 
completely invisible, in effect allowing the camera to see 
behind them. Hollywood cinematographers use this 
visual characteristic to achieve the popular “focus pull” 
effect, where the focus shifts from a nearby to a distant 
object, such that the “other” object all but disappears. 
Well, this is simply not possible to do with the current 
post-processing method in a single pass. If you really 
want to achieve this effect, quite satisfactorily, here is 
how: 


e Split up your scene into “nearby” and “far” objects, 
and render them in two passes. 

e Now, combine the two results, each with their own 
“defocus” nodes driven by the same Time node, but 


with one of them inverted (e.g. using a Map Value 
node with a Size of -1). As the defocus of one 
increases, the defocus on the other decreases at the 
same rate, creating a smooth transition. 
Aliasing at Low f-Stop Values 
At very low values, less than 5, the node will start to 
remove any oversampling and bring the objects at DoF 
Distance very sharply into focus. If the object is against a 
contrasting background, this may lead to visible stair- 
stepping (aliasing) which OSA is designed to avoid. If you 
run into this problem: 


e Do your own OSA by rendering at twice the intended 
size and then scaling down, so that adjacent pixels 
are blurred together. 

Use the Blur node with a setting of 2 for X and Y. 

Set DoF Distance off by a little, so that the object in 
focus is blurred by the tiniest bit. 

e Use a higher f-stop, which will start the blur, and then 
use the Z socket to a Map Value to a Blur node to 
enhance the blur effect. 

e Rearrange the objects in your scene to use a lower- 
contrast background. 

No Z-Buffer 
A final word of warning, since there is no way to detect if 
an actual Z-buffer is connected to the node, be very 
careful with the No Z-buffer switch. If the Z scale value 
happens to be large, and you forget to set it back to 
some low value, the values may suddenly be interpreted 
as huge blur radius values that will cause processing 
times to explode. 


Denoise Node 


The Denoise node is used to denoise 


Y Denoise 
renders from Cycles and other ray 
tracing renderers. This helps to hel 
significantly reduce render time by Prefilter- 
rendering with fewer samples. 

Accurate 
It is uses Open Image Denoise, which Y HDR 
transforms noisy images into clean image 


images with machine learning. 


Normal 


Albedo 


Inputs 


Image 
Noisy image input. 


Normal 
Optional normal render pass to better preserve detail. For 
Cycles, it is recommended to use the Denoising Normal 
render pass, which is available when enabling the 
Denoising Data passes. 


Albedo 
Optional albedo render pass to better preserve detail. For 
Cycles, it is recommended to use the Denoising Albedo 
render pass, which is available when enabling the 
Denoising Data passes. 


Properties 


Prefilter 
None: 


Fast: 


Accurate: 


HDR 


Does not apply any prefiltering to the 
input passes. This option retains the 
most detail and is the fastest, but 
assumes the input passes are noise 
free which may require a high sample 
count. If the input passes are not noise 
free, then noise will remain in the 
image after denoising. 

Assumes the input passes are not noise 
free, yet does not apply prefiltering to 
the input passes. This option is faster 
than Accurate but produces a blurrier 
result. 

Prefilters the input passes before 
denoising to reduce noise. This option 
usually produces more detailed results 
than Fast with increased processing 
time. 


Preserve colors outside the 0 to 1 range. 


Outputs 


Image 


Denoised image output. 


Examples 


Render before and after denoising, with a very low 
number of samples as input. AS more samples are 
used, the denoiser will be able to better preserve 
detail. 


Despeckle Node 


The Despeckle node is used to 
smooth areas of an image in which 
noise is noticeable, while leaving 
complex areas untouched. 


This works by the standard deviation 
of each pixel and its neighbors is 
calculated to determine if the area is 
one of high complexity or low 
complexity. If the complexity is lower 
than the threshold then the area is 
smoothed using a simple mean filter. 


Inputs 


Factor 


v Despeckle © 


Image 


Threshold 0.500 
Neighbor 0.500 


Image 


1.000 


Controls the amount the filter effects the image. 


Image 
Standard color input. 


Properties 


Threshold 


The threshold to control high/low complexity. 


Neighbor 


The threshold to control the number of pixels that must 


match. 


Outputs 


Image 
Standard color output. 


Dilate/Erode Node 


The Dilate/Erode node provides a 
morphology (mathematical shape 
analysis) filter. 


Y Dilate/Erode 


Mask @ 


Mode: Step v 


Distance 0 


G Mask 0.000 


Inputs 


Mask 
Single color channel (or a black-and-white image) input. 


Properties 


Mode 
Step, Threshold, Distance, Feather 


Distance 
The Distance is the filter radius. A positive value of 
Distance dilates (expands) the influence of a pixel on its 
Surrounding pixels. A negative value erodes (shrinks) its 
influence. 


Edge 
Edge to inset. 


Falloff 
Falloff type the feather. 


Outputs 


Mask 
The filtered mask output. 


Example 


In this example, we wanted to take the rather boring array 

of ball bearings and add some variation to it. So, we dilated 
the red and eroded the green, leaving the blue alone. If we 

had dilated both red and green... (hint: red and green make 
yellow). The amount of influence is increased by increasing 
the Distance values. Blend-file available here. 


Directional Blur Node 


Blurs an image in a specified direction 
and magnitude. Can be used to fake 
motion blur. 


Y Directional Blur 


Image 


Iterations 1 
Wrap 


Center: 
xX 0.500 
Y 0.500 


Distance 0.000 
Angle 0° 


Spin 0° 


Zoom 0.000 


Inputs 


Image 
Standard color input. 


Properties 


Iterations 
Controls how may times the image is duplicated to create 
the blur effect. Higher values give smoother results. 


Wrap 


Wraps the image on the X and Y axis to fill in areas, that 
become transparent from the blur effect. 


Center X, Y 
Sets the position where the blur center is. This makes a 
difference if the angle, spin, and/or zoom are used. 


Distance 
How large the blur effect is. 


Angle 
Image is blurred at this angle from the center. 


Spin 
Rotates the image each iteration to create a spin effect, 
from the center point. 


Zoom 
Scales the image each iteration, creating the effect of a 
ZOOM. 


Outputs 


Image 
Standard color output. 


Filter Node 


The Filter node implements various 
common image enhancement filters. 


Y Soften © 


Image 


Soften 
D 


Image 


Inputs 


Factor 
Controls the amount of influence the node exerts on the 
output image. 


Image 
Standard color input. 


Properties 


Type 
The Soften, Laplace, Sobel, Prewitt and Kirsch all perform 
edge detection (in slightly different ways) based on 
vector calculus and set theory equations. 


Soften: Slightly blurs the image. 
Box Sharpen: Increases the contrast, especially at 
edges. 


Diamond Sharpen: 


Less aggressive than box sharpen, 
reducing sharpening artifacts. 


Laplace: Edge highlighting filter susceptible to 
highlighting visual noise. 

Sobel: Creates a negative image that 
highlights edges. 

Prewitt: Produces a similar results to Sobel. 

Kirsch: Gives better blending than Sobel or 
Prewitt, when approaching an edge. 

Shadow: Performs a relief, emboss effect, 


darkening outside edges. 


Outputs 


Image 
Standard color output. 


Example 


The Filter node has eight modes, shown here. 


Original image. Soften. 


Box Sharpen. Diamond Sharpen. 


Laplace. Sobel. 


Prewitt. 


Shadow. 


Glare Node 


The Glare node is used to add lens 
flares, fog, glows around exposed 
parts of an image and much more. 


Y Glare 
Image 
Streaks 
Medium 
Iterations 
Color Mod 0.250 
Mix 0.000 
Threshold 1.000 


Streaks 4 


Angle Offset 0° 


Fade 0.900 


Inputs 


Image 
Standard color input. 


Properties 

Glare Type 
Ghosts: Creates a haze over the image. 
Streaks: Creates bright streaks used to simulate 


lens flares. 


Streaks 
Total number of streaks. 
Angle Offset 
The rotation offset factor of the 
streaks. 
Fade 
Fade out factor for the streaks. 


Fog Glow: Looks similar to Ghost. However, it is 
much smaller in size and gives more of 
an atmospheric haze or “glow” around 
the image. 

Size 
Scale of the glow relative to the size 
of the original bright pixels. 


Simple Star: Works similar to Streaks but gives a 
simpler shape looking like a star. 
Fade 
Fade out factor for the streaks. 
Rotate 45 
Rotate the streaks by 45°. 


Quality 
If not set to something other the High, then the glare 
effect will only be applied to a low resolution copy of the 
image. This can be helpful to save render times while 
only doing preview renders. 


Iterations 
The number of times to run through the filter algorithm. 
Higher values will give more accurate results but will take 
longer to compute. Note that, this is not available for Fog 
Glow as it does not use an iterative-based algorithm. 


Color Modulation 


Used for Streaks and Ghosts to create a special 
dispersion effect. 


Johannes Itten describes this effect, Color Modulation, as 
subtle variations in tones and chroma. 


Mix 
Value to control how much of the effect is added on to 
the image. A value of -1 would give just the original 
image, 0 gives a 50/50 mix, and 1 gives just the effect. 


Threshold 
Pixels brighter than this value will be affected by the 
glare filter. 


Outputs 


Image 
Standard color output. 


Inpaint Node 


The Inpaint node is used to extend 
borders of an image into transparent 
or masked regions. This can be useful 
to solve problems like “wire removal” 
and holes created during chroma 


keying. whet fo 


Y Inpaint 


Distance 


Inputs 


Image 
Standard color input. 


Properties 


Distance 
The number of times to extend the image. 


Outputs 


Image 
Standard color output. 


Examples 


The left image shows the “wire” in place and after chroma 
keying has been applied. You will see you are left with a 


blank space - it’s shown as a black line here but it will be 
alpha in your Blender output. 


Inpaint Node example. 


Inpainting fills in a couple of pixels using the surrounding 
image and voila... your wire is removed. 


Note 


The wider the “hole” is, the more noticeable this effect is! 
If you use more than a few pixels of infill, the effect is 
almost as irritating as the wire and your viewers won’t be 


impressed. 


Inpainting can also cover up a multitude of other minor sins 
such as control points for motion capture: use it sparingly 
and it will amaze. 


Pixelate Node 


Add this node in front of a Scale node 
to get a pixelated (non-smoothed) 
image from the resultant upscaled 
image. 


Y Pixelate 


Inputs 


Color 
Standard color input. 


Properties 


This node has no properties. 


Outputs 


Color 
Standard color output. 


Example 


Open an image you would like to pixelate using an Image 
node. Add two Scale nodes between the input and output 
Add » Distort » Scale. Change the values of X and Y to 0.2 in 
the first scale box and to 5 in the second. The composited 
image will appear unchanged. Now add a Pixelate node 


between the two Scale nodes. The result will be a pixelated 
image. 


Sun Beams Node 


The Sun Beams node provides a 
computationally cheap way of 
creating the name giving effect based ab 
on the image brightness alone. 0.500 0.500 


Y Sun Beams 


Sun Beams is a 2D effect for Reise s ULL 
simulating the effect of bright light image 
getting scattered in a medium 
(Crepuscular Rays). This phenomenon 
can be created by renderers, but full 
volumetric lighting is a rather arduous approach and takes a 
long time to render. 


Inputs 


Image 
Standard color input. 


Properties 


Source Width, Height 
Source point of the rays as a factor of the image 
dimensions. 


Ray Length 
Length of the rays as a factor of the image size. 


Outputs 


Image 
Standard color output. 


Example 


Usually, the first step is to define the area from which rays 
are cast. Any diffuse reflected light from surfaces is not 
going to contribute to such scattering in the real world, so 
should be excluded from the input data. Possible ways to 
achieve this are: 


e Entirely separate image as a light source. 

e Brightness/contrast tweaking to leave only the brightest 
areas. 

e Muting shadow and midtone colors, which is a bit more 
flexible. 

e Masking for ultimate control. 


After generating the sun beams from such a light source 
image they can then be overlayed on the original image. 
Usually, a simple “Add” Mix node is sufficient, and physically 
correct because the scattered light adds to the final result. 


Vector (Motion) Blur Node 


The Vector Blur node is a fast method 
for simulating Motion Blur in 
compositing. It uses the vector speed aU 
render pass to blur the image pixels 
in 2D. 


Y Vector Blur 


Samples 32 

Blur 1.00 
Speed: 

Min 

Max 


Curved 


Image 


Inputs 


Image 
Image input, to be linked to the “Combined” render pass. 


Z 
Z depth, to be linked to the “Depth” render pass. 


Speed 
Input for the “Vector” render pass. See Cycles render 
passes. 


Properties 


Samples 
Quality factor. 


Blur 


Scaling factor for the motion vector (actually the “shutter 
speed” in frames). 


Speed 
The vector blur could produce artifacts like streaks, lines 
and other. To tackle these problems, the filter applies 
clamping, which can be used to limit which pixels get 
blurred. The speed is set in pixel units. 


Maximum Speed 
The maximum threshold. The majority of artifacts are 
caused by pixels moving too fast. 


Minimum Speed 
The minimum threshold for moving pixels can 
separate the hardly moving pixels from the moving 
ones. Especially when the camera itself moves, the 
vector mask can become the entire image. 


Curved 


Interpolates motion between frames using a quadratic 
Bézier function rather than a linear function. 


Outputs 


Image 
Motion blurred image output. 


Usage 


Even with a correct compositing setup with Image, Z and 
Speed nodes all linked to the appropriate passes, there may 
still be artifacts. The 2D render passes does not contain 3D 
information, and so the information what is behind a moving 
object or outside the camera view is lost. 


Better results can be achieved by rendering the scene into 
multiple render layers, applying vector blur to each render 
layer, and then compositing the results together. Typically 
an animated character would be rendered in a separate 
render layer than the background set. Especially if hair or 
transparency is involved this is important. 


For other artifacts it can help to slightly blur the Speed pass 
or to set a Maximum Speed limit. This helps to smoothen 
out the motion, but too much blurring leads to its own 
problems. 


Example 


The speed vector in this example was created by animating 
the patterned sphere horizontally and using a frame at the 
mid-point of the sequence. 


Render result, no Composite, with 
post-processing. Samples set to 32 
and Blur set to 1.0. 


Vector Nodes 


These nodes can be used to manipulate various types of 
vectors, such as surface normals and speed vectors. 


Map Range Node 
Map Value Node 
Normal Node 
Normalize Node 
Vector Curves Node 


Map Range Node 


This node converts (maps) an input 
value range into a destination range. 
By default, values outside the 
specified input range will be care 
proportionally mapped as well. This 
node is similar to Map Value node but 
provides a more intuitive way to 
specify the desired output range. 


Y Map Range 


Value @ 


Value 1.000 
From Min 0.000 
From Max 0.000 
To Min 0.000 
To Max 0.000 


Inputs 


Value 
The input value to be remapped. 


From Min 
The lower bound of the range to remap from. 


From Max 
The higher bound of the range to remap from. 


To Min 
The lower bound of the target range. 


To Max 
The higher bound of the target range. 


Properties 


Clamp 
Clamps values to Min/Max of the destination range. 


Outputs 


Value 
Standard value output. 


Usage 


One important use case is to easily map the original range 
of the Z-depth channel to a more usable range (i.e: 0.0 - 
1.0) for use as a matte for colorization or filtering 
operations. 


Map Value Node 


Map Value node is used to scale, 
offset and clamp values. 


Y Map Value 


Value @ 


Offset: 

0.000 
Size: 

1.000 


Use Minimum 


Use Maximum 


a Value 1.000 


Inputs 


Value 
Standard Value input. (Value refers to each vector in the 
set.) 


Properties 


Offset 
Factor added to the input value. 


Size 
Scales (multiply) the input value. 


Use Minimum, Maximum 


Enable this to activate their related operation. 


Min, Max 
Defines a range between minimum and maximum to 
Clamp the input value to. 


Outputs 


Value 
Standard value output. 


Example 


Z-Depth Map 


This is particularly useful in achieving a depth of field effect, 
where the Map Value node is used to map a Z value (which 
can be 20 or 30 or even 500 depending on the scene) to the 
range between (0 to 1), suitable for connecting to a Blur 
node. 


Multiplying Values 


The Map Value node can also be used to multiply values to 
achieve a desired output value. In the mini-map to the right, 
the Time node outputs a value between 0.0 and 1.0 evenly 
scaled over 30 frames. The first Map Value node multiplies 
the input by 2, resulting in an output value that scales from 
0.0 to 2.0 over 30 frames. The second Map Value node 
subtracts 1 from the input, giving working values between 
(-1.00 to 1.0), and multiplies that by 150, resulting in an 
output value between (-150 to 150) over a 30-frame 
sequence. 


vy Map Value vy Map Value 


Value @ Value @® 


2.000 150.000 


¥Y Use Minimum ¥ Use Minimum 


0.000 0.000 


Y Use Maximum ¥ Use Maximum 


1.000 2.000 


® Value 


Using Map Value to multiply. 


Normal Node 


The Normal node generates a normal 
vector and a dot product. 


Y Normal 


Normal 


Dot @ 


> 


Inputs 


Normal 
Normal vector input. 


Properties 


Normal Direction 
To manually set a fixed normal direction vector. LMB click 
and drag on the sphere to set the direction of the normal. 
Holding ctrl while dragging snaps to 45 degree rotation 
increments. 


Outputs 


Normal 
Normal vector output. 


Dot 


Dot product output. The dot product is a scalar value. 


e If two normals are pointing in the same direction the 
dot product is 1. 

e If they are perpendicular the dot product is zero (0). 

e If they are antiparallel (facing directly away from 
each other) the dot product is -1. 


Normalize Node 


Find the minimum and maximum 
values of a single channel. Then map 
the values to a range of 0 and 1. This Value 
is mostly useful for the Z-buffer. @® Value 1.000 


Y Normalize 


Inputs 


Value 
Standard value input. 


Properties 


This node has no properties. 


Outputs 


Value 
Standard value output. 


Vector Curves Node 


The Vector Curves node maps 
an input vector components to 
a Curve. Vector 


Y Vector Curves 


Use this curve node to slow 
things down or speed them up 
from the original scene. 


Vector: 


Inputs 


In the shader context the node also has an additional Factor 
property. 


Factor 
Controls the amount of influence the node exerts on the 
output vector. 


Vector 
Standard vector input. 


Properties 


Channel 
xX, Y,Z 


Curve 
For the curve controls see: Curve widget. 


Outputs 


Vector 
Standard vector output. 


Matte Nodes 


These nodes give you the essential tools for creating a 
Matte for images that do not already have their own Alpha 
Channel. One usage scenario is blue-screen or green-screen 
footage, where live action is shot in front of a blue or green 
backdrop for replacement by a matte painting or virtual 
background. 


In general, hook up these nodes to a viewer, set your Image 
Editor to show the Viewer node, and play with the sliders in 
real-time using a sample image from the footage, to get the 
settings right. In some cases, small adjustments can 
eliminate artifacts or foreground image degradation. Taking 
out too much green can result in foreground actors looking 
flat or bluish/purplish. 


You can and should chain these nodes together, improving 
your masking and color correction in successive 
refinements, using each node’s strengths to operate on the 
previous node’s output. Keying Node is the closest to a 
“does-it-all” node for green screens, but the best results 
stem from a combination of techniques. 


Note 


Garbage Matte is not a node, but a technique selecting 
what to exclude from an image. It is a Mask used to 
identify content to be removed from an image that cannot 
be removed by an automatic process like chroma keying. It 
is used either to select specific content to be removed, or 
it is the inverse of a rough selection of the subject; 
removing everything else. 


Some nodes accept a garbage matte directly. For those 
that don’t, you can still apply one by subtracting the 
garbage matte from the matte generated by the node. 


Simple garbage mattes can be created with the Box Mask 
or the Ellipse Mask. More complicated matte shapes using 
a Double Edge Mask or using a Mask. 


Box Mask Node 


Channel Key Node 

Chroma Key Node 

Color Key Node 

Color Spill Node 
Cryptomatte Node 
Cryptomatte Node (Legacy) 
Difference Key Node 


Distance Key Node 
Double Edge Mask Node 


Ellipse Mask Node 
Keying Node 

Keying Screen Node 
Luminance Key Node 


Box Mask Node 


The Box Mask node creates an image 
suitable for use as a simple matte. 


Y Box Mask 
Mask @ 
0.500 0.500 
0.200 0.100 
Rotation 0° 


Mask... Add v 


e Mask 0.000 
a Value 1.000 


Inputs 


Mask 
An optional mask to use as the base for mask operations. 


Value 
Intensity of the generated mask. 


Properties 


X, Y 
Position of the center of the box as a fraction of the total 
width or height. (0.5, 0.5 creates a centered box; 0.0, 0.0 
creates a box in the lower left.) 


Width 
Width of the box as a fraction of the total image width. 


Height 


Height of the box as a fraction of the total image width, 


not height. 


Rotation 


Rotation of the box around its center point. 


Mask Type 


Operation to use against the input mask. 


Add: 


Subtract: 


Multiply: 


Not: 


Outputs 


This yields the union of the input mask 
and the generated mask: Areas 
covered by the generated mask are set 
to the specified Va/ue. Other parts of 
the input masked are passed through 
unchanged, or set to black if there is no 
input mask. 

Values of the input mask have the 
specified Value subtracted from them. 
This yields the intersection of this 
generated mask and the input mask: 
Values of the input mask are multiplied 
by the specified Va/ue for the area 
covered by the generated mask. All 
other areas become black. 

Any area covered by both the input 
mask and the generated mask 
becomes black. Areas covered by the 
generated mask that are black on the 
input mask become the specified 
Value. Areas uncovered by the 
generated mask remain unchanged. 


Mask 


A generated rectangular mask merged with the input 


mask. The created mask is the size of the current scene 
render dimensions. 


Tip 


For soft edges, pass the output mask through a slight Blur 
node. 


Channel Key Node 


The Channel Key node determines 
background objects from foreground 
objects by the difference in the image 
selected channel’s levels. Matte @ 


Yv Channel Key © 


Color Space: 


For example in the YUV Color Model, 


this node is useful when compositing RGB) HSV YUV YC... 
stock footage of explosions (very Key Channel: 
bright) which are normally shot R G 
against a solid, dark background. 
Algori... Max v 
High 1.000 
Low 0.000 
Inputs 
Image 


Standard color input. 


Properties 


Color Space 
This button selects what color model the channels will 
represent. 


RGB, HSV, YUV, YCbCr 


Key Channel 


This button selects the channel, defined by the Co/or 
Space, to use to determine the matte. 


Algorithm 
Method to calculate the difference between levels. 
Max: Limit by the maximum of the other two 
channels other than the Key Channel. 
Single: Limit by the maximum of the selected 


Limiting Channel. 

Limiting Channel 
The channel to use when computing 
the maximum, the options are 
defined by the Color Space. 


High 
Determines the lowest values that are considered 
foreground. (Which is supposed to be - relatively - high 
values: from this value to 1.0.) 


Low 
Determines the highest values that are considered to be 
background objects. (Which is supposed to be - relatively 
- low values: from 0.0 to this value.) 


Tip 
It is possible to have a separation between the High and 


Low values to allow for a gradient of transparency between 
foreground and background objects. 


Outputs 


Image 


Image with an alpha channel adjusted for the keyed 
selection. 


Matte 
A black-and-white alpha mask of the key. 


Chroma Key Node 


The Chroma Key node determines if a 
pixel is a foreground or background 
(and thereby should be transparent) image 
based on its chroma values. Matte @ 


Y Chroma Key © 


Acceptance 30° 


Cutoff 10° 


Use this, for example, to composite 
images that have been shot in front of 
a green or blue screen. Falloff 1.000 


Inputs 


Image 
Standard color input. 


Key Color 
The background color usually selected using the color 
picker and the original image. 


Properties 


Acceptance 
An angle on the color wheel that represents how tolerant 
the keying color is. Larger angles allow for larger 
variation in the keying color to be considered background 
pixels. 


Cutoff 


Controls the level that is considered the pure 
background. Higher cutoff levels mean more pixels will 
be 100% transparent if they are within the angle 
tolerance. 


Falloff 
Increase to make nearby pixels partially transparent 
producing a smoother blend along the edges. 


Outputs 


Image 
Image with its alpha channel adjusted for the keyed 
selection. 


Matte 
A black-and-white alpha mask of the key. 


Color Key Node 


The Color Key node creates a matte 


tip . Y Color Key 
based on a specified color of the input © 
image. Image 
Matte @ 

0.010 
0.100 
0.100 

Inputs 

Image 


Standard color input. 


Properties 


Color 


The sliders represent threshold values. Higher values in 
this node’s context mean a wider range of colors from 
the specified will be added to the matte. 


Hue, Saturation, Value 


Outputs 


Image 


Image with its alpha channel adjusted for the keyed 
selection. 


Matte 
A black-and-white alpha mask of the key. 


Color Spill Node 


The Color Spill node reduces one of 


the RGB channels so that it is not ae 
greater than any of the others. image 
This is common when compositing riicddescrnlata 
images that were shot in front of a . = 

green or blue screen. In some cases, Algori.. Simple — v 
if the foreground object is reflective, it Limiting Channel: 


will show the green or blue color; that R G B 
color has “spilled” onto the 
foreground object. If there is light 
from the side or back, and the 
foreground actor is wearing white, it image 
is possible to get “spill” green (or 
blue) light from the background onto 
the foreground objects, coloring them 
with a tinge of green or blue. To remove the green (or blue) 
light, you use this fancy node. 


Ratio 


Unspill 


Inputs 


Image 
Standard color input. 


Factor 
Standard Factor. 


Properties 


Despill Channel 


R, G, B 


Algorithm 
Simple, Average 


Limiting Channel 
R, G,B 


Ratio 
Scale limit by value. 


Unspill 
Allows you to reduce the selected channel’s input to the 
image greater than the color spill algorithm normally 
allows. This is useful for exceptionally high amounts of 
the color spill. 


R, G, B 


Outputs 


Image 
The image with the corrected channels. 


Example 


Results with the nodes applied to an image from the Mango 
Open Movie. 


Before: green border 
and green 
reflections. 


After: no unwanted 
green. 


Cryptomatte Node 


The Cryptomatte node 
uses the Cryptomatte 
standard to efficiently image 

create mattes for Matte @ 
compositing. Cycles and Pick 

Eevee output the required 
render passes, which can 


Y Cryptomatte 


Render 


then be used in the f5~ Scene 
Compositor or another ViewLayer.CryptoObject 
compositor with Matte ID: 


Cryptomatte support to 
create masks for 
specified objects. 


Image 


Unlike the Material and 

Object Index passes, the objects to isolate are selected in 
compositing, and mattes will be anti-aliased and take into 
account effects like motion blur and transparency. 


Inputs 


Image 
Standard color input. 


Properties 


Source 
The source of the Cryptomatte data. 


Render: Use Cryptomatte data that are stored 
as part of the render. 

Image: Use Cryptomatte data that are stored 
inside a multilayered OpenEXR image. 


Scene 
Scene selector. Only available when Render Source is 
selected. 


Image 
Image selector. Only available when Image Source is 
selected. 


Cryptomatte Layer 
Selector of the Cryptomatte layer. 


Matte ID 
List of object and material crypto IDs to include in matte. 
This can be used for example to quickly clear all mattes 
by deleting the text or used to copy-and-paste crypto IDs 
from other software. 


Outputs 


Image 
A colored output of the input image with the matte 
applied to only include selected layers. 


Matte 
A black-and-white alpha mask of all the selected crypto 
layers. 


Pick 
A colored representation of the Cryptomatte pass which 
can be used as a higher contrast image for color picking. 


Usage 


1. Enable Cryptomatte Object render pass in the Passes 
panel, and render. 

2. In the compositing nodes, create a Cryptomatte node 
and select the Cryptomatte layer. 

3. Attach a Viewer node to the combined pass of the 
render layers. 

4. Use the Cryptomatte Add/Remove button to sample 
objects from the Compositor backdrop. 

5. Use the Matte output of the Cryptomatte node to get 
the alpha mask. 


The Image editor, UV editor, node backdrop or Movie Clip 
editor can be used to pick a Cryptomatte sample. They 
don’t need to show any Cryptomatte layer. The node will use 
the sample image coordinate to sample in the Cryptomatte 
layer that is selected in the node. 


Example 


In the example below, you can see the pass output on the 
right side. On the left side you can see a couple of objects 
that were selected through the Cryptomatte node. Notice 
how the cube on the left has a sphere-shaped cut-out from a 
sphere that was not selected in the node. 


Limitations 


e Cryptomatte sidecars (metadata files) are not 
Supported. 

e Cryptomatte node cannot be used in node groups. 

e Volume Objects are not supported. 


Cryptomatte Node 
(Legacy) 


The Cryptomatte node uses the 
Cryptomatte standard to efficiently 
create mattes for compositing. Cycles cba 
and Eevee output the required render Matte @ 
passes, which can then be used in the Pick 
Compositor or another compositor 
with Cryptomatte support to create 
masks for specified objects. 


Y Cryptomatte 


Matte Objects: 


+ — 


Unlike the Material and Object Index image 
passes, the objects to isolate are Crypto 
selected in compositing, and mattes Crypto 
will be anti-aliased and take into crypto 
account effects like motion blur and 
transparency. 


Important 


The Cryptomatte Legacy node is deprecated and replaced 
by Cryptomatte Node. The legacy node will be removed in 
a future Blender release. 


Inputs 


Image 
Standard color input. 


Crypto Passes 


Each crypto layer will be given its own render pass; each 
of these render passes must be connected to one of 
these crypto layer inputs. By default there are only four 
layers, see Adding/Removing Layers to add more. 


Properties 


Add/Remove 
Adds/Removes an object or material from matte, by 
picking a color from the Pick output. 


Matte ID 
List of object and material crypto IDs to include in matte. 
This can be used for example to quickly clear all mattes 
by deleting the text or used to copy-and-paste crypto IDs 
from other software. 


Outputs 


Image 
A colored output of the input image with the matte 
applied to only include selected layers. 


Matte 
A black-and-white alpha mask of the all the selected 
crypto layers. 


Pick 
A colored representation of the Cryptomatte pass which 
can be used with a Viewer node to select which crypto 
passes are used to create the matte image. 


Usage 


1. Enable Cryptomatte Object render pass in the Passes 
panel, and render. 

2. In the compositing nodes, create a Cryptomatte node 
and link the Render Layer matching Image and 
Cryptomatte passes to it. 

3. Attach a Viewer node to the Pick output of the 
Cryptomatte node. 

4. Use the Cryptomatte Add/Remove button to sample 
objects in the Pick Viewer node. 

5. Use the Matte output of the Cryptomatte node to get 
the alpha mask. 


Adding/Removing Layers 


By default there are only four crypto layers available as 
inputs to the Cryptomatte node. You can add or remove 
layer inputs through Sidebar > Item » Properties > 
Add/Remove Crypto Layer. These operators will add/remove 
layers from the bottom of the pass inputs. 


Example 


In the example below, you can see the pass output on the 
right side. On the left side you can see a couple of objects 
that were selected through the Cryptomatte node. Notice 
how the cube on the left has a sphere-shaped cut-out from a 
sphere that was not selected in the node. 


Difference Key Node 


This node produces a matte that 
isolates foreground content by 

comparing it with a reference image 
background image. Matte 


Y Difference Key © 


Tolerance 0.100 
Falloff 0.100 


Inputs 


Image 
Contains foreground content against the background that 
is to be removed. 


Image 
The reference background image. 


Properties 


Tolerance 
Where pixels match the reference background to within 
the specified threshold, the matte is made transparent. 


Falloff 
Increase to make nearby pixels partially transparent 
producing a smoother blend along the edges. 


Outputs 


Image 
Image with its alpha channel adjusted for the keyed 
selection. 


Matte 
A black-and-white alpha mask of the key. 


Distance Key Node 


The Distance Key node determines a 
pixel’s alpha value based on the 
three-dimensional distance between lays 
the image pixel color and the key Matte @ 
color in a 3D color space. 


v Distance Key © 


Tolerance 0.100 


This key works well when trying to ao 


single out a specific color ina Color Space: 
background (not necessarily green). RGB YCC 
Inputs 

Image 


Standard color input. 


Key Color 
The color that is to be keyed. 


Properties 


Tolerance 


A threshold what the node considers a match between 
the key color and the foreground pixel. The tolerance 
affects how close a pixel needs to be to the background 
pixel to be considered an absolute match. 


Falloff 
When the Falloff value is high, pixels that are close to the 
Key Color are more transparent than pixels that are not 
as close to the Key Color (but still considered close 
enough to be keyed). When the Falloff value is low, it 
does not matter how close the pixel color (Image) is to 
the Key Color, it is transparent. 


Color Space 
It is also possible to work with YCbCr color space, but 
only the Cb and Cr channels are taken into consideration 
for determining the distance between the foreground and 
background pixels. 


RGB, YCC 


Outputs 


Image 
The image with an alpha channel adjusted for the keyed 
selection. 


Matte 
A black-and-white alpha mask of the key. 


Double Edge Mask Node 


The Double Edge Mask node creates a 


: Y Double Edge Mask 
gradient between two masks. 


Mask @ 
Inner Edge: 
All 


Buffer Edge: 
Bleed Out v 


Q Inner Mas 0.800 
Oy Outer Ma 0.800 


Inputs 


Inner Mask 
A mask representing the inside shape, which will be fully 
white. 


Outer Mask 
A mask representing the outside shape, which will fade 
from black at its edges to white at the /nner Mask. 


Properties 


Inner Edge 
All: All shapes in the /nner Mask contribute 
to the gradient, even ones that do not 
touch the Outer Mask shape. 
Adjacent Only: 


Only shapes in the /nner Mask that 
overlap with the Outer Mask contribute 
to the gradient. 


Adjacent Only. 


Buffer Edge 
Keep In: Parts of the Outer Mask that touch the 
edge of the image are treated as if they 
stop at the edge. 
Bleed Out: Parts of the Outer Mask that touch the 
edge of the image are extended 
beyond the boundary of the image. 


Keep In. Bleed Out. 


Outputs 


Mask 
Standard mask output. 


Example 


Double Edge Mask Example Video 


Ellipse Mask Node 


The Ellipse Mask node 
creates an image 
Suitable for use as a Mask @ 
simple matte or 7 SENG - SED 
vignette mask. 


Y Ellipse Mask 


Width 0.200 Height 0.100 


Rotation 
Mask Type: Add 
i) Mask 


8 Value 


Inputs 


Mask 
An optional mask to use as the base for mask operations. 


Value 
Intensity of the generated mask. 


Properties 


X, Y 
Position of the center of the ellipse as a fraction of the 
total width or height. (0.5, 0.5 creates a centered ellipse; 
0.0, 0.0 creates an ellipse with its center in the lower 
left.) 


Width 


Width of the ellipse as a fraction of the total image width. 


Height 


Height of the ellipse as a fraction of the total image 
width, not height. Equal Width and Height values with 


produce a circle. 


Rotation 


Rotation of the ellipse around its center point. 


Mask Type 


Operation to use against the input mask. 


Add: 


Subtract: 


Multiply: 


Not: 


This yields the union of the input mask 
and the generated mask: Areas 
covered by the generated mask are set 
to the specified Va/ue. Other parts of 
the input masked are passed through 
unchanged, or set to black if there is no 
input mask. 

Values of the input mask have the 
specified Value subtracted from them. 
This yields the intersection of this 
generated mask and the input mask: 
Values of the input mask are multiplied 
by the specified Va/ue for the area 
covered by the generated mask. All 
other areas become black. 

Any area covered by both the input 
mask and the generated mask 
becomes black. Areas covered by the 
generated mask that are black on the 
input mask become the specified 
Value. Areas uncovered by the 
generated mask remain unchanged. 


Outputs 


Mask 


A generated elliptical mask merged with the input mask. 


The created mask is the size of the current scene render 
dimensions. 


Tip 


For soft edges, pass the output mask through a slight Blur 


node. For a vignette, pass the output of this through a 
heavy blur. 


Keying Node 


The Keying node is a one-stop-shop 
for “green screen” / “blue screen” 
removal. It performs both chroma 
keying to remove the backdrop and 
despill to correct color cast from the 
backdrop. Additionally, you can 
perform common operations used to 
tweak the resulting matte. 


Inputs 


Image 


Y Keying 
Image 
Matte @ 
Edges ® 
Pre Blur 0 
Screen Ba 0.500 
Despill Fa 1.000 
DespillBa 0.500 
Edge KernelR 3 
Edge Kern 0.100 
Clip Black 0.000 
Clip White 1.000 


Dilate/Erode 0O 


Feath... /\. Smooth v 


Feather Dista 0O 


Post Blur 0 


@® Garbage Matte 


® Core Matte 


Standard color input. 


Key Color 
The color of content to be removed. This may be a single 
color, or a reference image such as generated by the 
Keying Screen Node. 


Garbage Matte 
An optional mask of area(s) to always exclude from the 
output. This is removed from the chroma key generated 
matte. 


Core Matte 
An optional mask of area(s) to always include in the 
output. This is merged with the chroma key generated 
matte. 


Properties 


Pre Blur 
Reduce the effects of color noise in the image by blurring 
only color by the given amount, leaving luminosity intact. 
This will affect matte calculation only, not the result 
image. 


Screen Balance 
This is the balance between color channels compared 
with the key color. 0.5 will average the other channels 
(red and blue in the case of a green screen). 


This may be tweaked in tandem with Clip Black and Clip 
White while checking the Matte output to create a mask 
with optimal separation. 


Despill Factor 


Controls how much color bleed from the key color is 
removed from the input image: 0 means no despilling, 1 
means all possible spilling will be removed. The 
underlying implementation is the same as adjusting the 
Unspill amount of the Color Spill Node. 


Despill Balance 


This controls how the color channels are compared when 
computing spill, affecting the hue and shade of the 
corrected colors. It is similar to setting the Limiting 
Channel in the Color Spill Node. 


Edge Kernel Radius 
Defines the radius in pixel used to detect an edge. 


Edge Kernel Tolerance 
Defines threshold used to check if pixels in radius are the 
Same as current pixel: if the difference between pixel 
colors is higher than this threshold then the point will be 
considered an edge. 


Clip Black 
This sets the threshold for what becomes fully 
transparent in the output (black in the matte). It should 
be set as low as possible. Uneven backdrops will require 
this value to be increased. Use of the Keying Screen 
Node can help keep this value low. You may also use a 
Garbage Matte to exclude problematic areas. 


This value does not impact areas detected as edges to 
ensure edge detail is preserved. 


Clip White 
This sets the threshold for what becomes fully opaque in 
the output (white in the matte). It should be set as high 
as possible. Colors close to green in the foreground may 


require reducing this value and/or adjusting the Screen 
Balance. Particularly problematic parts can fixed with a 
Core Matte instead of a low Clip White. 


This value does not impact areas detected as edges to 
ensure edge detail is preserved. 


Dilate/Erode 
Enlarge (positive numbers) or shrink (negative numbers) 
the matte by the specified number of pixels. This is 
similar to using the Dilate/Erode Node on the matte. 


This a simple way to include more or less along the 
edges of the matte, particularly combined with Post Blur. 


Feather Falloff 
The rate of the falloff at the edges of the matte when 
feathering, to manage edge detail. 


Feather Distance 
Controls how much the matte is feathered inwards 
(negative number) or outwards (positive number). 


Post Blur 
Make the matte less sharp, for smoother transitions to 
the background and noise reduction. 


Outputs 


Image 
Processed image with the Matte applied to the images’ 
Alpha Channel. 


Matte 


Output matte to use for checking the quality of the key, 
or to manually apply using a Set Aloha Node or Mix Node. 


Edges 
Shows what edges were detected on the matte. Useful 
for adjusting the Edge Kernel! Radius and Edge Kernel 
Tolerance. 


Tip 


If there are problems with the edges of the matte, it may 
help to start with adjusting the Edge Kerne! parameters 
before adjusting feathering. Detected edges are not 
Subject to Clip Black / Clip White thresholds to preserve 
fine edge detail. You can check edge detection by 
connecting a Viewer Node to the Edges output. 


Sharper detected edges (smaller Edge Kernel Radius, like 2 
/ larger Edge Kernel Tolerance, like 0.4) will create a 
sharper matte, but may loose some detail like stray hairs. 
A sharp matte is good, but disappearing or flickering hairs 
are distracting. 


Fat edges (larger Edge Kernel Radius, like 8 / smaller Edge 
Kernel Tolerance, like 0.05) will capture more edge detail, 
but may also produce a halo around the subject. The halo 
can be adjusted with Feather controls along with 
Dilate/Erode. 


Keying Screen Node 


The Keying Screen node creates 
plates for use as a color reference for 
keying nodes. It generates gradients ocreen 
from sampled colors on motion 
tracking points on movie clips. It can 
be used to deal with uneven colors of 
green screens. 


Y Keying Screen 


Inputs 


This node has no input sockets. 


Properties 


Movie Clip 
The selectable clip data-block used as input for the 
gradient colors. 


Tracking Object 
Tracking Object to generate the gradient. You will 
probably want to create new a tracking object in the 
Object panel, because tracks used for gradients can not 
actually be used for camera/object tracking. After this 
tracks might be placed in places where gradient colors 
should be sampled. These tracks could be tracked or 
moved manually, so gradients would be updating 
automatically along the movie. Tracks might have an 
offset for easier tracking of feature-less screens. 


Outputs 


Screen 
Gradient image output. 


Example 


Consider a node setup for green screen removal, using a 
Color Key: 


vy Color Spill vy Set Alpha 


Image Image 


Alpha ae 
+ Despill Channel Image 


Offset X @ Alpha 


R G 
Offset Y 
Scale Algori... Average 
Ratio 
Angle 
Unspill 
Image 


Fac 1,000 


vy Color Key 


Image 


Key Color 


Often, lighting is uneven across the backdrop. 


Example from the Mango Open Movie, Tears of 
Steel. 


That can result in a bad matte. 


Example of a poor mask: Some of the backdrop is 
Opaque, and some parts of the gun in the 
foreground are transparent. 


If you increase the tolerances on the Color Key node, it will 
accept more shades of green to mask out. But it may also 
incorrectly mask out more of the foreground. 


Instead of increasing the range of accepted shades to be 
masked out, the Keying Screen node lets you change what 
shade of green (or other color) to used for different parts of 
the image. 


Start in the Movie Clip Editor. Open the Sidebar region and 
Toolbar to show tracking configuration. Tracks used for 
gradients are not useful for camera solving, because they 
do not track well. So create a new object track in the 
Objects selector. Place tracking markers on the clip to 
sample different parts of the backdrop. 


These tracks may be tracked or moved manually, so 
gradients can be updated over time. If the marker is not 
enabled for a frame, it will not be used creating the 
gradient. (Such as the red-colored marker on the arm in the 
screenshot above) 


Once the tracks are created, add the node to your 
compositing setup, and select the tracking object used for 
the backdrop. 


y Set Alohe 


Despill Channel @ image 


R G B @ Alpha 
Algor,, Average 
Ratio 1.000 


Unspill 


Node configuration with Keying Screen’s generated 
gradient plate connected to the Color input of the 
Keying node. 


Gradient plate generated by Keying Screen. 


The resulting image now has a better matte. 


Luminance Key Node 


The Luminance Key node determines 
background objects from foreground 
objects by the difference in the ae 

luminance (brightness) levels. Matte @ 


Y Luminance Key @ 


High 1.000 


Stock footage of explosions, smoke or 
Low 0.000 


debris are normally shot against a 
solid, dark background rather than a image 
green screen. This node can separate 
the foreground effect from the 
background. It can also be used for 
sky replacement for overexposed or gray skies that aren’t 
suitable for chroma keying. 


Tip 

When compositing footage of something that emits light 
and has a dark background, like fire, a Mix Node using a 
Screen or Add operator will produce better results. 


Inputs 


Image 
Standard color input. 


Properties 


Limit 


High 
Determines the lowest values that are considered 
foreground. (Which is supposed to be - relatively - 
light: from this value to 1.0.) 


Low 
Determines the highest values that are considered to 


be background objects. (Which is supposed to be - 
relatively - dark: from 0.0 to this value.) 


Note 


Brightness levels between the two values form a gradient 
of transparency between foreground and background 
objects. 


Outputs 


Image 
Image with an alpha channel adjusted for the keyed 


selection. 


Matte 
A black-and-white alpha mask of the key. 


Example 


For this example the model was shot against a white 
background. Using the Luminance Key node, we get a matte 
out where the background is white, and the model is black; 
the opposite of what we want. If we wanted to use the 
matte, we have to switch the white and the black. How to do 
this? Color Ramp node to the rescue - we Set the left color 


to White Alpha 1.0, and the right color to be Black Alpha 0.0. 
Thus, when the Color Ramp gets in black, it spits out white, 
and vice versa. The reversed mask Is shown; its white 
outline is usable as an alpha mask now. 


Using Luma Key with a twist. 


Now to mix, we do not really need the Alpha Over node; we 
can just use the mask as our Factor input. In this kinda weird 
case, we can use the matte directly; we just switch the input 
nodes. As you Can see, since the matte is white (1.0) where 
we do not want to use the model picture, we feed the 
background photo to the bottom socket (recall the Mix node 
uses the top socket where the factor is 0.0, and the bottom 
socket where the factor is 1.0). Feeding our original photo 
into the top socket means it will be used where the 
Luminance Key node has spit out Black. Voila, our model is 
teleported from Atlanta to aboard a cruise ship docked in 
Miami. 


Distort Nodes 


These nodes distort the image in some fashion, operating 
either uniformly on the image, or by using a mask to vary 
the effect over the image. 


Corner Pin Node 

Crop Node 

Displace Node 

Flip Node 

Lens Distortion Node 
Map UV Node 

Movie Distortion Node 
Plane Track Deform Node 
Rotate Node 

Scale Node 

Stabilize 2D Node 
Transform Node 
Translate Node 


Corner Pin Node 


The Corner Pin node uses explicit 


Y Corner Pin 
corner values for a plane warp 
transformation. It works like the Plane aes 
Track Deform node, but without using Plane @ 


“olane track” data from the Movie image 
Clip Editor. Upper Left: 
0.000 
1.000 
0.000 
Upper Right: 
1.000 
1.000 
0.000 
Lower Left: 
0.000 
0.000 
0.000 


Lower Right: 
1.000 
0.000 
0.000 


Inputs 


Image 
Standard color input. 


Corners 


Four vector inputs to define the plane warping. (Z 
component of vector inputs is ignored.) 


Properties 


This node has no properties. 


Outputs 


Image 
Standard color output. (The image after distorting.) 


Plane 
A black-and-white alpha mask of the plane. 


Example 


Image 
Upper Left: 
© 4.100 
Image 1.100 
Alpha ® 0.000 
Depth @ Upper Right: 
0.925 


a ohat 
Ay Bird Ce x 0.850 


Single Image 0.000 


Color Spa. sRGB v Lower Left 
0.100 
0.275 
0.000 
Lower Right 
0.925 
0.250 
0.000 


An example of the Corner Pin node. 


An example of the distorted image. 


In the example above, the image of the bird is distorted by 
the vectors specified by the Corner Pin node. 


Crop Node 


The Crop node crops an input image 
to a selected region by either making 
the cropped area transparent or by bi 
resizing the input image. crop iniage See 


Relative 


Left 


Right 
Up 
Down 
Image mz 
Inputs 
Image 


Standard color input. If no image is selected, an image 
filled with the selected color is used. You can use and 
crop this image in combination with another background 
image. 


Properties 


Crop Image Size 
When disabled, the image remains the same size, but the 
cropped areas become transparent pixels. When enabled, 
the image size is cropped to the specified region and 
gets a new width or height or both. 


Note that this will probably reposition the image in the 
render output because the cropped image is 
automatically centered. 


Relative 
When enabled, crop dimensions are a percentage of the 
input image’s width and height. When disabled, the 
range of the Crop Region Values are the width and height 
of the image in pixels. 


Crop Region Values 
Define borders of the crop region; Left or Right can vary 
between 0 and the width of the image. Up or Down can 
vary between 0 and the height of the image. 


Note 


The terminology (Left, Right, Up, Down) can be 
misunderstood easily. First, the numbers do not represent 
the amount of cropping, e.g. Left is set to 50 and Right to 
50 does not mean that you will be cropping the image for 
50 pixels on both the left and right side. In fact, it will 
result in zero-sized image because you are cropping from 
pixel 50 to pixel 50. So, the numbers defines a position in 
the input image. 


Secondly, depending on which one is bigger, Left should 
be interpreted as Right and vice versa. If Left is greater 
than Right then both values are switched and Left gets the 
value of Right and vice versa. The same operation is done 
for Up and Down, where you can think of them as the top 
and bottom of the image. 


Thirdly, the terms Up and Down are ambiguous and 
suggest an action; e.g. “Crop down”. The values, however, 


are not amounts but positions. The term Down should be 
interpreted as “Bottom” and Up as “Top”. 


Outputs 


Image 
Standard color output. 


Usage 


The following workflow removes some possible confusion: 


1. Uncheck Crop Image Size for this step, so that you can 
see the borders of the input image. To see this border, 
you have to select the Viewer node. 

2. If you don’t need pixel-perfect cropping, check Relative 
so that you do not have to consider the exact 
dimensions of the input image. 

3. Set Left and Down to zero. Set Right and Up to one, or 
to the width and height of the input image. You should 
see now the entire input image in the backdrop. Up is 
thus interpreted as the top of the image. The origin of 
the image (0, 0) is at the bottom (down) left corner. 

4. To crop from the left, change the Left value. To crop from 
the right, change the Right value. To crop from the top, 
change the Up value. To crop from the bottom, change 
the Down value. 


Displace Node 


The Displace Node displaces the pixel 
position based on an input vector. 


Y Displace 


Image 
This node could be used to model image 
phenomena, like hot air distortion, Vector 
refractions of uneven glass or for ee 
Surreal video effects. a 


1m 


Inputs 


Image 
Standard color input. 


Vector 
Input of the displacement map. If the a color output is 
implicitly converted in the vector input, the first channel 
(red) value determines displacement along X axis. The 
second channel (green) the displacement along Y axis. If 
the input is a grayscale image, where both the channel 
values are equal, the input image will be displaced 
equally in both X and Y directions. 


Scale X, Y 
Separate scaling of the vector input in X and Y direction. 
Acting as multipliers by increasing or decreasing the 
strength of the displacement along their respective axes. 


Properties 
This node has no properties. 
Outputs 


Image 
Standard color output. 


Flip Node 


This node flips an image at defined 
axis. 


You can use this node to just flip or 
use it as a part of mirror setting. Mix 
half of the image to be mirrored with ik 
its flipped version to produce mirrored 
image. 


Flip X 


Inputs 


Image 
Standard color input. 


Properties 


Axis 


This can be either X or Y. Also, flipping can be done on 


both X and Y axis simultaneously. 


Flip X, Flip Y, Flip X & Y 


Outputs 


Image 
Standard color output. 


Lens Distortion Node 


Use this node to simulate distortions 
that real camera lenses produce. 


Y Lens Distortion 
Image 
Projector 
jitter 
Fit 


@ Distort 0.000 


o Dispersio 0.000 


Inputs 


Image 
Standard color input. 


Distort 
This creates a bulging or pinching effect from the center 
of the image. 


Dispersion 
This simulates chromatic aberrations, where different 


wavelengths of light refract slightly differently, creating a 
rainbow colored fringe. 


Properties 


Projector 


Enable or disable slider projection mode. When on, 
distortion is only applied horizontally. Disables Jitter and 
Fit. 


Jitter 
Adds jitter to the distortion. Faster, but noisier. 

Fit 
Scales image so black areas are not visible. Only works 
for positive distortion. 


Outputs 


Image 
Standard color output. 


Map UV Node 


With this node objects can be “re- 
textured” after they have been 
rendered. Hiss 


Y Map UV 


Alpha 0 


To apply a texture to individual 
enumerated objects the |D Mask Node mage 
could be used. 


Inputs 


Image 
The new 2D texture. 


UV 
The input for UV render pass. See Cycles render passes. 


Hint 


To store the UV pass a multi-layer OpenEXR format could 
be used. 


Properties 


Alpha 
Alpha threshold is used to fade out pixels on boundaries. 


Outputs 


Image 
The resulting image is the input image texture distorted 
to match the UV coordinates. That image can then be 
overlay mixed with the original image to paint the 
texture on top of the original. Adjust alpha and the mix 
factor to control how much the new texture overlays the 


old. 


Hint 


When painting the new texture, it helps to have the UV 
maps for the original objects in the scene, it is 
recommended to keep those UV texture outlines around 
even, when shooting is done. 


Examples 


In the example below, we have overlaid a grid pattern on 
top of the two heads after they have been rendered. During 
rendering, we enabled the UV layer in the Properties Render 
Layer > Passes. Using a Mix node (“Overlay” in figure), we 
mix that new UV texture over the original face. We can use 
this grid texture to help in any motion tracking that we need 
to do. 


Adding a grid UV textures for motion tracking. 


In the next example, we overlay a logo on top of a mesh 
composed of two intersecting cubes, and we ensure that we 
Enable the Alpha premultiply button on the Mix node. The 
logo is used as additional UV texture on top of the existing 
texture. Other examples include the possibility that there 
was used an unauthorized product box during the initial 
animation, and it is needed to substitute in a different 
product sponsor after rendering. 


Hint 


Due to limits of this node, it is not recommended to rush 
pre-production rendering under the guise of “fixing it 
later”. 


Adding UV textures in post-production. 


Movie Distortion Node 


In the real world, all camera lenses 
produce some or the other sort of 
lens distortion. But, whatever we mage 
render has got no distortion. So, this BS Open 
node helps in removing distortion 

from movies or adding distortion to mace 
render to make our render blend in 
with the movie clip. 


Y Undistortion 


Usually, it is used while motion tracking. 


Calculating Distortion 


Before using this node, one has to calculate the lens 
distortion of the clip. This can be done by adjusting K1, K2 
and K3 values in Movie Clip Editor >» Properties » Lens. For 
more information on how to edit those values, check this 
out. 


Inputs 


Image 
Standard color input. 


Properties 


Movie Clip 
Used to select the movie clip whose distortion is to be 
used. This can be useful if more than one movie clips are 


present, each having a different distortion setting. For 
controls see Data-Block Menu. 


Distortion Method 
Undistort: Used to undistort the image received, 
and is usually used for the raw 
distorted movie clip. 
Distort: Used to distort the image received, and 
is usually used for rendered images. 


Outputs 


Image 
The image after distorting/undistorting. 


Distortion vs Undistortion 


Although, both, distortion of render and undistortion of 
movie clip are possible, and produce similar results, there is 
a difference between these two methods. 


There are two kinds of lens distortion possible and, in simple 
terms, they can be said as: 


1. When the movie clip is bulging out. 
2. When the movie clip is bulging in. 


For the first case, it is recommended to distort the render 
and leave the movie clip as it is, because, undistorting the 
movie clip will require extra pixel information, which is not 
available to Blender. Similarly, in the second case, it is 
recommended to undistort the movie clip and leave the 
render as it is, because, distorting the render will require 
those extra unavailable pixels. Doing the wrong method in 


the wrong case can create weird results around the edges, 
such as in the image shown. 


Problems (notice the edges?) 


Plane Track Deform Node 


The Plane Track Deform Node is used 
to incorporate the special “plane 

track” in your composite by checking elles 
areas which are planes, and replacing Plane 
their footage with some other image. 


Y Plane Track Deform 


Sy fe Open 


Motion Blur 


Image 


Plane Track 


Before using this node, plane track for the footage should be 
made in the Movie Clip Editor. 


Inputs 


Image 
Image to put in place of the plane track, and thus, 
override that area in the movie clip. 


Properties 


Movie Clip 


Used to select the movie clip whose plane track to use. 
For controls see Data-Block Menu. 


Object 


Used to select the object to which the plane track is 
linked. 


Track 
Used to select the plane track to use. 


Motion Blur 
Specify whether to use blur caused by motion of the 
plane track or not. 


Samples 
Set the number of samples to take for each frame. 
The higher this number, the smoother the blur effect, 
but the longer the render, as each virtual intermediate 
frame has to be rendered. 


Note 


Samples are taken only from the next frame, not the 
previous one. Therefore the blurred object will 
appear to be slightly ahead of how it would look 
without motion blur. 


Shutter 
Time (in frames) the shutter is open. If you are 
rendering at 24 fps, and the Shutter is set to 0.5, the 
time in between frames is 41.67 ms, so the shutter is 
open for half that, 20.83 ms. 


Outputs 


Image 
The output by perspective wrapping the image to that 
plane track. 


Plane 
Produces a black-and-white mask of the plane track. 


Examples 


Using Image Output 
This can simply be achieved by using the Alpha Over node. 
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Image output. 


Using Plane Output 


This can be achieved by mixing the movie clip and the 
image by using the plane output as the factor. 
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Plane output. 


Using Image Output vs Using 
Original Image 


Using Image output scales, moves, and skews the input 
image according to the track while using the original image 
and mixing it with the movie clip using Plane output as 
factor will display the part of the image that lies inside that 
mask. This image shows the difference: 
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Comparison between image output and original 
image (see Viewer nodes carefully). 


Rotate Node 


This node rotates an image. 


Y Rotate 


Image 


Bilinear v 


g Degr 0° 


Inputs 


Image 
Standard color input. 


Degr 
Rotation angle in degree. Positive values rotate clockwise 
and negative ones counterclockwise. 


Properties 


Filter 
Interpolation Methods. 


Nearest: No interpolation, uses nearest 
neighboring pixel. 

Bilinear: Simple interpolation between adjacent 
pixels. 

Bicubic: Highest quality interpolation. 


Outputs 


Image 
Standard color output. 


Scale Node 


This node scales the size of an image. 


Y Scale 
Image 


Relative v 


Image 


Inputs 


Image 
Standard color input. 


X, Y 
Scale in the axis directions, only available if Space is set 
to Relative or Absolute. 


Properties 


Space 
Coordinate Space to scale relative to. 


Relative 
Percentage values relative to the dimensions of the 
image input. 


Absolute 
Size of an image by using absolute pixel values. 


Scene Size 
Sizes an image to the size of the final render 
resolution for the scene. For example, rendering a 
scene at the standard 1080p resolution but setting the 
render percentage at 50%, will produce a 1080p 
image with the scene scaled down 50% and leaving 
the rest of the image as alpha. 


Render Size 
Image dimensions set in the Render panel. 


Stretch, Fit, Crop 
Stretch distorts the image so that it fits into the 
render size. Fit scales the image until the bigger 
axis “fits” into the render size. Crop cuts the image 
so that it is the same aspect ratio as the render 
size. 


X, Y 
Offset factor for the final scaled image. 


Outputs 


Image 
Standard color output. 


Examples 


For instance X: 0.5 and Y: 0.5 would produce an image which 
width and height would be half of what they used to be. 


Use this node to match image sizes. Most nodes produce an 
image that is the same size as the image input into their top 
image socket. To uniformly combine two images of different 


size, the second image has to be scaled up to match the 
resolution of the first. 


Stabilize 2D Node 


Stabilizes the footage according to 
the settings set in Movie Clip Editor » 
Properties > Stabilization » 2D image 
Stabilization. For more information, Ee Open 
see 2D Stabilization. 


Y Stabilize 2D 


Inputs 


Image 
Standard color input. 


Properties 


Movie Clip 
The movie clip whose stabilization to use. 


Interpolation 
Various methods for the stabilization. Usually, the same 
as used in Movie Clip Editor > Properties » Stabilization > 
2D Stabilization > Interpolate. For technical details on 
their difference, see this. But for most purposes, default 
of Bilinear should suffice. 


Invert 
Invert the stabilization. If the stabilization calculated is to 
move the movie clip up by 5 units, this will move the 
movie clip down by 5 units. 


Outputs 


Image 
Standard color input. 


Transform Node 


This node combines the functionality 
of three other nodes: Scale, translate, 
and rotate nodes. Image 


Y Transform 


Nearest v 


Image 


Angle 


Scale 


Inputs 


Image 
Standard color input. 


X, Y 
Used to move the input image horizontally and vertically. 


Angle 
Used to rotate an image around its center. Positive values 
rotate counter-clockwise and negative ones clockwise. 


Scale 
Used to resize the image. The scaling is relative, meaning 
a value of 0.5 gives half the size and a value of 2.0 gives 
twice the size of the original image. 


Properties 


Filter 
Interpolation Methods. 


Nearest: No interpolation, uses nearest 
neighboring pixel. 
Bilinear: Simple interpolation between adjacent 
pixels. 
Bicubic: Highest quality interpolation. 
Outputs 
Image 


Standard color output. 


Translate Node 


The Translate node moves an image. 
Y Translate 

Could also be used to add a 2D Image 

camera shake. 


Relative 


Wrap... None 


Image 


Inputs 


Image 
Standard color input. 


X, Y 
Used to move the input image horizontally and vertically. 


Properties 


Relative 


Percentage translation values relative to the input image 
size. 


Wrapping 
Repeat pixels on the other side when they extend over 
the image dimensions, making endless translating 
possible. 


None, X Axis, Y Axis, Both Axis 


Outputs 


Image 
Standard color output. 


Group 


Group Nodes are a collection of nodes that can be combined 
into a single node while selectively exposing inputs of the 
embedded nodes. Group nodes can simplify a node tree by 
allowing instancing and hiding parts of the tree. 


Make Group 


Creates a node group from the selected nodes, see Make 
Group for more information. 


Ungroup 


Removes the selected nodes from a group, see Ungroup for 
more information. 


Group Input 


Adds a group input node, this serves as a convenient way to 
re-add the input node in case it is accidentally deleted. 
Note, groups can only have one input, if more than one is 
added they are duplicates of each other. 


Group Output 


Adds a group output node, this serves as a convenient way 
to re-add the output node in case it is accidentally deleted. 
Note, groups can only have one output, if more than one is 
added they are duplicates of each other. 


Node Groups 


This section lists all the node groups either from the current 
blend-file or Linked or Appended from another blend-file. 


Layout Nodes 


These are nodes which help you control the layout and 
connectivity of nodes within the Compositor. 


e Switch Node 


Switch Node 


Switch between two images using a 
checkbox. 


Y Switch 


Image 


Switch 


Inputs 


Image 
First image input. 


Image 
Second image input. 


Properties 


Switch 
e When it is unchecked, the first input labeled “Off” is 
passed to the output. 
e When checked, the second input labeled “On” is 
passed to the output. 


Outputs 


Image 
Standard color output. 


Tip 


Switch state may be animated by adding a keyframe. This 
makes the Switch node useful for bypassing nodes which 
are not wanted during part of a sequence. 


Motion Tracking & 
Masking 
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Editing 
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Introduction 


You perform masking and tracking with the Movie Clip 
Editor. 


» Metadata 
Proxy/Timecode 


¥ Footage Settings 


Y Marker 


® | Add Delete 


5 Detect Features 


¥ Tracking Settings 


» Tracking Settings Extra 
» Track 


The Movie Clip Editor. 


See Movie Clip Editor for more information on the Movie Clip 
Editor. 


Motion Tracking 
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Introduction 


Motion Tracking is used to track the motion of objects and/or 
a camera and, through the constraints, to apply this 
tracking data to 3D objects (or just one), which have either 
been created in Blender or imported into the application. 
Blender’s motion tracker supports a couple of very powerful 
tools for 2D tracking and 3D motion reconstruction, 
including camera tracking and object tracking, as well as 
some special features like the plane track for compositing. 
Tracks can also be used to move and deform masks for 
rotoscoping in the Mask Editor, which is available as a 
special mode in the Movie Clip Editor. 


Views 


In Tracking Mode there are three different views available. 
You can toggle between view modes using the View 
selector, which is located in the header. When you selected 
a view in the whole area of the Movie Clip editor will change. 
Hence, to display a curve or dope sheet view, the editor 
must be split into two, with one switched to the curve or 
dope sheet view. 


Manual Lens Calibration 


All cameras record distorted video. Nothing can be done 
about this because of the manner in which optical lenses 
work. For accurate camera motion, the exact value of the 
focal length and the “strength” of distortion are needed. 


Currently, focal length can be automatically obtained only 
from the camera’s settings or from the EXIF information. 
There are some external tools which can help to find 
approximate values to compensate for distortion. There are 
also fully manual tools where you can use a grid which is 
getting affected by distortion model and deformed cells 
defines straight lines in the footage. 


Within Blender you can use the Annotation tool for this - just 
draw a line which should be straight on the footage using 
poly line brush and adjust the distortion values to make the 
annotations match lines on the footage. 


To calibrate your camera more accurately, use the Grid 
calibration tool from OpenCV. OpenCV is using the same 
distortion model, so it should not be a problem. 


Camera and Object Motion 
Solving 


Blender not only supports the solving of camera motion, 
including tripod shots, but also the solving of object motion 
in relation to the motion of the camera. In addition to that 
there is the Plane Track, which solves the motion of all 
markers on one plane. 


Tools for Scene Orientation and 
Stabilization 


After solve, you need to orient the real scene in the 3D 
scene for more convenient compositing. There are tools to 
define the floor, the scene origin, and the X/Y axes to 
perform scene orientation. 


Sometimes, the video footage includes spurious jumps and 
tilting movements, like e.g. when using a hand-held camera. 
Based on some tracked image elements, the 2D 
Stabilization is able to detect and compensate such 
movements to improve the quality of the final result. 


Clip View 
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Introduction 


The Clip View is the main part of the Movie Clip editor; 
almost all motion tracking tools are concentrated within the 
Clip View. 


It should be mentioned that the camera solver consists of 
three quite separate steps: 


1. 2D tracking of footage. 

2. Camera intrinsics (focal length, distortion coefficients) 
specification/estimation/calibration. 

3. Solving camera, scene orientation, and scene 
reconstruction. 


Main View 


When a clip is loaded a Timeline is shown at bottom of the 
Preview. It expands over the full area limited by the 
animation range. You can move the Playhead by dragging 
with LMB. 


The Timeline is composed of the following visual elements: 


e Blue line: Playhead 

e Yellow: Motion track 

e Yellow line: Keyframe 

e Orange line: Shape keyframe 

e Purple: Prefetched frames 

e Light green line: Solve start/end keyframe 


Tracking Marker 


Point 


Position Handle Search Area 


Pattern Area 
Scale- 
Rotation 
Handle 


Position 


Pattern Corner 


Scale Handle 


Marker schematic. 


The whole marker can be moved with rms or by dragging the 
anchor point (black dot) with LMB. Pressing G also moves the 
whole marker. When pressing Gc twice the marker will be 
moved while keeping the anchor in place. Note that the 
anchor point outside the pattern area is shown as a cross 
connected with marker position with a dashed line. 


Ss scales the whole marker. The whole pattern area only will 
be scaled by pressing s twice; The Pattern can also be 
rotated using the R key which, depending on the used pivot 
point, will either rotate patterns around their own centers or 
rotate the whole markers around e.g. the median point. 


To match the perspective transformation of a marker ona 
plane, the individual corners must be edited manually. Each 
marker corner can deform individually to define the shapes. 
Corner positions can be edited by dragging them with a 
mouse. Dragging with LmMB will change the position of an 
individual corner. 


Note 


Note that deforming a pattern is not only useful for planar / 
affine tracking. Since only pixels within the pattern will be 
considered this can help to specify a better pattern to 
track even for simple position tracking. 


The Search area can not be rotated; this is intentional. It 
doesn’t make sense to deform the search area. 


Plane 


The left bottom corner of the plane does have X/Y axis (X is 
red, Y is green) to help distinguishing orientation of the 
plane in space. 


It is likely that corner of the plane object need to be 
manually adjusted. To do this sliding individual corners with 
mouse LMB or general transform tools G, R, S could be used. 


Adjusting plane corners will keep it following the plane 
defined by tracks it was originally created from. 


Toolbar 


Clip 

Marker 

Tracking Settings 
Track 


Plane Track 
Solve 
Cleanup 
Geometry 
Orientation 
Scene Setup 


Track 
Clip 
Set Scene Frames 


See Set Scene Frames. 


Prefetch 
See Prefetch. 


Reload 
See Reload Clip. 


Marker 


Add 
See Add Marker. 


Delete 
See Delete Track. 


Detect Features 
See Detect Features. 


Tracking Settings 


This panel contains all settings for the 2D tracking 
algorithms. Preset tracking settings can be configured in the 
panel header. These presets are based on tracking 
experience of real footage and provides good start values to 
begin working with a specific footage. 


Pattern Size, Search Size 
Defines size of a newly created tracks. 


Motion Model 
Defines which possible motions tracking feature has. This 
option should be set depending on which motion a 
particular feature has and it will make tracking most 
accurate for such a motion. 


Location, Location & Rotation, Location & Scale, Location, 
Rotation & Scale, Affine 


Perspective 
Is usually used to track a planar feature, but often 
Affine is a good enough approximation and may have 
more stable tracks. 


Match 
Controls which patterns get tracked; to be more precise, 
the pattern from which frame is getting tracked. Here is 
an example which should make things clearer. 


The tracker algorithm receives two images inside the 
search area and the position of a point to be tracked in 
the first image. The tracker tries to find the position of 
that point from the first image in the second image. 


Now, this is how tracking of the sequence happens. The 
second image is always from a frame at which the 
position of marker is not known (next tracking frame). 
But a different first image (instead of the one that 
immediately precedes the second image in the footage) 
can be sent to the tracker. 


Keyframe 


An image created from a frame on which the track 
was keyframed. This configuration prevents sliding 
from the original position (because the position which 
best corresponds to the original pattern is returned by 
the tracker), but it can lead to small jumps and can 
lead to failures when the feature point is deformed 
due to camera motion (perspective transformation, for 
example). 


Previous Frame 
Keyframes for tracks are creating every frames, and 
tracking between keyframed image and next image is 
used. In this configuration the pattern is tracking 
between two neighboring frames. It allows dealing 
with cases of large transformations of the feature 
point but can lead to sliding from the original position, 
so it should be controlled. 


Prepass 
Enables a two pass tracking, where the first pass is a 
brute force tracking of location only, and the second pass 
will use tracking of the full motion model refining the first 
pass. 


Normalize 
Means patterns will be normalized by their average 
intensity while tracking, to make them invariant to 
illumination changes. An example where this is useful is a 
scene where a marker moves in the shadow of an object. 


R,G, B 
Defines color channels which will be used by a tracking 
algorithm. Disabling some colors might increase the 
contrast to enhance the feature detection. 


Copy from Active Track 


Copies all settings from active track. Allows to ease 
creation of new tracks with the same setting. 


Tracking Extra Settings 


Weight 
See Track Weight. 


Correlation 
This value defines the minimal correlation between a 
matched pattern and a reference to be considered a 
successful tracking. If the tracker is stops too early, 
decrease this value, or if the track is slipping too much 
when it should stop sooner, increase this value. 


Margin 
Can be used disable tracks when they become too close 
to the image boundary. This slider sets “too close” in 
pixels. 


Use Mask 
Allows to use annotation tool to mask part of a pattern, 
narrowing down what the tracker algorithm is attempting 
to match across frames. 


Frames Limit 
Controls how many frames can be tracked when the 
Track Sequence operator is called. So, each Track 
Sequence operation would track maximum Frames Limit 
frames. This also helps to notice a slide-off of tracks and 
correct them. 


Speed 
Marker settings only - Can be used to control the speed 
of sequence tracking. This option does not affect the 
quality of tracking; it just helps to control if tracking 


happens accurately. In most cases tracking happens 
much faster than real-time, and it is difficult to notice 
when a track began to slide out of position. In such cases 
Speed can be set to Double or Half to add some delay 
between tracking two frames, so a slide-off would be 
noticed earlier and the tracking process can be canceled 
to adjust positions of tracks. 


Track 


Track 
See Track Motion. 


Clear 
See Before. 


Refine 
See Refine. 


Merge 
Join Tracks 
See Join Tracks. 


Solve 


Plane Track 


See Create Plane Track. 


Solve 


Tripod 


Tripod Motion can be used for footage where the camera 
does not move and only rotates. Such footage can’t be 
tracked with a generic solver approach, and it is 
impossible to determine the actual feature points in 
Space due to a lack of information. So this solver will 
solve only the relative camera rotation and then reproject 
the feature points into a sphere, with the same distance 
between feature and camera for all feature points. 


Note 


This is special type of camera solver and it behaves 
different from regular solver. It means using more 
tracks doesn’t imply more accurate solution. Having 5- 
10 tracks on frame is likely what shall be commonly 
used for this kind of solver. 


Keyframe 
Automatically select keyframes for initial reconstruction. 
This option enables complex algorithms which tries to 
find a keyframe pair with minimal reconstruction error 
and best scene scale guess. 


Keyframe A/B 


Start (A) and End (B) frame of the range used for 
reconstruction. 


Refine 
Specifies which parameters should be refined during 
solve. Such refining is useful when you are not sure 
about some camera intrinsics, and solver should try to 
find the best parameter for those intrinsics. But you still 
have to know approximate initial values - it will fail to 
find correct values if they were set completely incorrectly 
initially. 


Focal Length 
Refine the camera’s Focal Length. 


Optical Center 
Refine the camera’s Optical Center. 


Radial Distortion 
Refine the camera’s Radial Distortion Parameters. 


Tangential Distortion 
Refine the camera’s Tangential Distortion Parameters. 


Solve Camera/Object Motion 
See Solve Solution. 


Cleanup 


This panel contains operators and their settings which are 
needed to clean up bad tracks: tracks which are not tracked 
long enough or which failed to reconstruct accurately. 


Frames 


Tracks or tracked segments shorter than this number of 
frames will be removed. 


Error 


Tracks which has reprojection error higher than this value 
will be removed. 


Type 
Several actions can be performed for bad tracks: 


Select 
They can simply be selected. 


Delete Track 
The whole track can be deleted. 


Delete Segments 
Bad segments of tracked sequence can be removed. 


Clean Tracks 
See Clean Tracks. 


Filter Tracks 
See Filter Tracks. 


Geometry 


3D Markers to Mesh 
See 3D Markers to Mesh. 


Link Empty to Track 
See Link Empty to Track. 


Orientation 


Scene orientation tools can be used for orienting object to 
bundles. 


Floor 
See Set Origin. 


Wall 
See Set Floor. 


Set Origin 
See Set Floor. 


Set X, Y Axis 
See Set X/Y Axis. 


Set Scale 
See Set Scale. 


Apply Scale 
See Apply Solution Scale. 


Distance 
Distance in active scene units which is used by Set/Apply 
scale. 


Scene Setup 


Set as Background 
See Set as Background. 


Setup Tracking Scene 
See Setup Tracking_Scene. 


Selecting 


Box Select 


Reference 

Mode: All modes 

Menu: Select >» Box Select 
Shortcut: B 


See Select Box. 


Circle Select 


Reference 

Mode: All modes 

Menu: Select > Circle Select 
Shortcut: C 


See Select Circle. 


Lasso Select 


Reference 
Mode: All modes 
Menu: Select >» Lasso Select 


Shortcut: Ctrl-Alt-RMB 


See Select Lasso. 


(De)select All 


Reference 

Mode: All modes 

Menu: Select > (De)select All 
Shortcut: A 


Selects all items. 


Inverse 

Reference 

Mode: All modes 
Menu: Select > Inverse 
Shortcut: Ctrl-I 


Selects non-selected items and deselects existing selection. 


Select Grouped 


Reference 

Mode: All modes 

Menu: Select >» Select Grouped 
Shortcut: Shift-G 


Select all tracks from specified group. 


Action 
The group of tracks to select. 


Keyframed Tracks: 
Select all keyframed tracks. 
Estimated Tracks: 
Select all estimated tracks. 
Tracked Tracks: 
Select all tracked tracks. 
Locked Tracks: Select all locked tracks. 
Disabled Tracks: 
Select all disabled tracks. 
Track with Same Color: 
Select all tracks with same color as 
active track. 
Failed Tracks: Select all tracks which failed to be 
reconstructed. 


Select Stabilization Tracks 


Reference 
Mode: Tracking mode 
Menu: Select >» Select Stabilization Tracks 


Select tracks which are used for translation stabilization. 


Select Stabilization Rotation 
Tracks 


Reference 


Mode: Tracking mode 


Menu: Select > Select Stabilization Rotation 
Tracks 


Select tracks which are used for rotation stabilization. 
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Open Clip 

Set Scene Frames 

Set Principal to Center 
Prefetch 

Reload Clip 

Proxy 

Set as Background 
Setup Tracking Scene 
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Transform 
Track Motion 
Clear 
Refine 
Add Marker 
Detect Features 
Create Plane Track 
Solve Solution 
Join Tracks 
Average Tracks 
Copy Tracks 
Paste Tracks 
Animation 
Show/Hide 
Clean Up 
Delete Track 
Delete Marker 
e Reconstruction 

o Set Origin 

o Set Floor 

o Set Wall 
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Set X/Y Axis 

Set Scale 

Apply Solution Scale 
Link Empty to Track 
3D Markers to Mesh 


Clip 
Open Clip 


Reference 

Mode: All modes 
Menu: Clip >» Open Clip 
Shortcut: Alt-0 

Todo. 


Set Scene Frames 


Reference 
Mode: Tracking 
Menu: Clip » Set Scene Frames 


Sets end scene frame to match current clip duration. 


Set Principal to Center 


Reference 
Mode: Tracking 
Menu: Clip » Set Principal to Center 


Changes the Optical Center values to the center of image. 


Prefetch 


Reference 

Mode: All modes 
Menu: Clip » Prefetch 
Shortcut: p 


Fills cache with frames. As many frames as fits into cache 
are load form the drive. This allows to fill in the cache as 
fast as possible when you really need to track something, 
but this keeps CPU and drive bandwidth idle if you’ve got a 
Clip editor opened but not actually interacting with it. 


Reload Clip 


Reference 
Mode: All modes 
Menu: Clip » Open Clip 


Force reload the currently loaded movie clip. Is mainly 
useful when the clip gets edited outside of Blender. 


Proxy 
Todo. 


Set as Background 


Reference 


Mode: Tracking 
Menu: Clip » Set as Background 


Sets the clip currently being edited as the camera 
background for all visible 3D Viewports. If there is no visible 
3D Viewports or the Clip Editor is open in full screen, 
nothing will happen. 


Setup Tracking Scene 


Reference 
Mode: Tracking 
Menu: Clip » Setup Tracking Scene 


Performs all usual steps to set up a VFX scene: 


e Create reference objects for floor and test object. 
e Create node set up for combining CG with an actual clip. 


Track 


Transform 


Todo. 


Track Motion 


The Track Motion menu is used to perform tracking of 
selected tracks (i.e. following the selected feature from 
frame to frame). 


This operator depends on settings from the Tracking 
Settings panel. If during sequence tracking the algorithm 
fails to track some markers, they will be disabled and 
tracking will continue for the rest of the markers. If the 
algorithm fails when tracking frame-by-frame, the marker is 
not disabled, and the most likely position of the feature on 
the next frame is used. 


Backwards 

Reference 

Mode: Tracking 

Menu: Track > Track Motion >» Backwards 
Shortcut: Shift-Ctrl-T 


Tracks the motion backward along the sequence. 


Frame Backwards 


Reference 


Mode: Tracking 
Menu: Track > Track Motion > Frame Backwards 
Shortcut: Alt-Left 


Tracks the motion backward by one frame. 


Forwards 

Reference 

Mode: Tracking 

Menu: Track > Track Motion » Forwards 
Shortcut: Ctrl-T 


Tracks the motion forward along the whole sequence. 


Frame Forwards 


Reference 

Mode: Tracking 

Menu: Track > Track Motion >» Frame Forwards 
Shortcut: Alt-Right 


Tracks the motion forward one frame. 


Clear 


Before 


Reference 


Mode: Tracking 
Menu: Track >» Clear >» Before 
Shortcut: Shift-T 


Deletes all tracked and keyframed markers after the current 
frame for all selected tracks. 


Clear Active 
Limits clear action to only active track (as opposite to all 
selected ones). 


After 

Reference 

Mode: Tracking 

Menu: Track > Clear > After 
Shortcut: AUt=T 


Deletes all tracked and keyframed markers before the 
current frame for all selected tracks. 


Clear Active 
Limits clear action to only active track (as opposite to all 
selected ones). 


Track Path 


Reference 


Mode: Tracking 
Menu: Track >» Clear » Track Path 


Shortcut: Shift-Alt-T 


Clears all markers except the current one from all selected 
tracks. 


Clear Active 
Limits clear action to only active track (as opposite to all 
selected ones). 


Clear Solution 


Todo. 


Refine 


This operator will run a tracker from previous keyframe to 
current frame for all selected markers. Current markers 
positions are considering initial position guess which could 
be updated by a tracker for better match. 


Useful in cases when feature disappears from the frame and 
then appears again. Usage in this case is the following: 


e When feature point re-appeared on frame, manually 
place marker on it. 

e Use Refine Markers operation to allow tracker to find a 
better match. 


Depending on direction of tracking use either Forwards or 
Backwards refining. Accordingly if tracking happens 
forwards, use Refine Forwards, otherwise use Refine 
Backwards. 


Backwards 


Reference 


Mode: Tracking 
Menu: Track » Refine >» Backwards 


Refine the track backwards. 


Forwards 

Reference 

Mode: Tracking 

Menu: Track >» Refine >» Forwards 


Refine the track forwards. 


Add Marker 


Reference 
Mode: Tracking 
Menu: Track » Add Marker 


Places a new marker at the position of the mouse (which is 
under the button in this case, not ideal but it is just how 
things work) and then it can be moved to the needed 
location. When it is moved to the desired position, LMB can 
be used to finish placing the new marker. Also, Return and 
Spacebar Can be used to finish placing the marker. But it is 
faster to use Ctrl-LMB to place markers directly on the 
footage. This shortcut will place the marker in the place you 
have clicked. 


In addition to this until you have released the mouse button, 
you can adjust the marker position by moving the mouse 
and using the track preview widget to control how 
accurately the marker is placed. 


Detect Features 


Reference 
Mode: Tracking 
Menu: Track » Detect Features 


Detects all possible features on the current frame and 
places markers at these features. This operator does not 
take other frames into account, so it might place markers on 
features which belong to moving objects. If the camera is 
turning away from this shot, no markers could be present 
within the frames after the camera moved away. 


There are several properties for this operator: 


Placement 
Controls where to place markers. 


Whole Frame 
Places markers throughout the whole frame. 


Inside Annotated Area 
Places markers inside the area outlined with the 
Annotation Tools. This can be used to outline some 
areas with interesting features and place markers only 
inside the outlined area. 


Outside Annotated Area 


Places markers outside the area outlined with the 
Annotation Tools. This can be used to outline areas of 
no interest (like trees, humans, etc.) and place 
markers outside of these areas. 


Margin 
Controls the distance from the image boundary for 
created markers. If markers are placed too close to the 
image boundary, they will fail to track really quickly and 
they should be deleted manually. To reduce the amount 
of manual clean-up, this parameter can be used. 


Threshold 
Limits minimal threshold for placing markers. This value 
comes from the feature detection algorithm and it 
means: low values means most probably this feature 
would fail to track very soon, high value means it is not 
much such track. Amount of markers to be added can be 
controlled with this value. 


Distance 
Defines the minimal distance between placed markers. It 
is needed to prevent markers from being placed too close 
to each other (such placement can confuse the camera 
solver). 


Create Plane Track 


Reference 


Mode: Tracking 
Menu: Track » Create Plane Track 


The Create Plane Track operator creates a new plane track. 
Planar tracking takes advantage of the fact that there are 
often planar surfaces in footage, by attaching markers to 
points on these flat planes. It can be used to replace things 
like billboards and screens on the footage with another 
image or video. It also might be used for masking. 


This button will create a plane object which is deforming in 
the same way as plane defined by all selected point tracks. 
At least four feature points tracked across the footage which 
belongs to the plane you want to replace are needed. More 
tracks will give better estimation of plane motion. 


Feature points used to estimate plane motion could be used 
from any place on the plane, meaning it’s not necessarily 
need to be corners. Corners are not always easy to be 
tracked, they might be occluded. In this case you can 
position tracked features that lay on the same plane far 
away from the actual plane which should be replaced. 


This provides more information about the possible 
deformation of the marker in following frames, and such 
markers can be tracked even if partially occluded (appear 
and disappear during the time). It is only required that two 
neighbor frames have at least four common tracks. 


An image can be projected onto the plane with the Plane 
Track Deform Node compositing node. 


Solve Solution 


Reference 


Mode: Tracking 
Menu: Track >» Solve Solution 


The Camera Motion operator solves the motion of camera 
using all tracks placed on the footage and two keyframes 
specified on this panel. There are some requirements: 


e There should be at least eight common tracks on the 
both of the selected keyframes. 

e There should be noticeable parallax effects between 
these two keyframes. 


If everything goes smoothly during the solve, the average 
reprojection error is reported to the information space and 
to the Clip editor header. Reprojection error means the 
average distance between reconstructed 3D position of 
tracks projected back to footage and original position of 
tracks. Basically, reprojection error below 0.3 means 
accurate reprojection, (0.3 - 3.0) means quite nice solving 
which still can be used. Values above 3 means some tracks 
should be tracked more accurately, or that values for focal 
length or distortion coefficients were set incorrectly. 


Join Tracks 


Reference 

Mode: Tracking 

Menu: Track > Join Tracks 
Shortcut: Ctrl-J 


This operator joins all selected tracks into one. Selected 
tracks should not have common tracked or keyframed 
markers at the same frame. 


Average Tracks 


Reference 


Mode: Tracking 
Menu: Track >» Average Tracks 


The Average Tracks operator creates a new tracking marker 
by averaging the data from the selected tracks. This can be 
used to improve stability of tracking on blurry or non-very- 
sharp feature shapes. The operator takes into account all 
Marker properties however, disabled markers do not affect 
the averaging. 


Gaps in the original tracks will be linearly interpolated, to 
reduce result track jump. Note that this only applies to gaps 
“in between”. This means that if a track does not have 
markers in the beginning or end of it, there is nothing to 
interpolate with and the resulting track will jump. 


Keep Original 
When enabled, the selected tracks are not deleted. 


Copy Tracks 


Todo. 


Paste Tracks 


Todo. 


Animation 


Todo. 


Show/Hide 


Todo. 
Clean Up 


Clean Tracks 


Reference 
Mode: Tracking 
Menu: Track >» Clean Up » Clean Tracks 


Identifies all tracks which matches settings from above and 
performs desired action on them. 


Tracked Frames 
Tracks or tracked segments shorter than this number of 
frames will be removed. 


Reprojection Error 
Tracks which has reprojection error higher than this value 
will be removed. 


Action 
Several actions can be performed for bad tracks. 


Select 
They can simply be selected. 


Delete Track 
The whole track can be deleted. 


Delete Segments 


Bad segments of tracked sequence can be removed. 


Filter Tracks 


Reference 


Mode: Tracking 
Menu: Track >» Clean Up » Filter Tracks 


This operator deletes obviously bad tracks (for example, the 
ones which are too short). Additionally, it identifies tracks 


which has suspicious spikes in their motion and selects 
them. 


Delete Track 


Reference 

Mode: Tracking 

Menu: Track >» Delete Track 
Shortcut: X 


Delete all selected tracks. 


Delete Marker 


Reference 
Mode: Tracking 
Menu: Track >» Delete Marker 


Shortcut: Shift-X 


Todo. 


Reconstruction 


Scene orientation tools can be used for orienting object to 
bundles. 


Set Origin 


Reference 
Mode: Tracking 
Menu: Reconstruction » Set Origin 


Transform camera in a way which makes active track to be 
moved to a scene origin. Only translation is applied to the 
camera. 


Set Floor 

Reference 

Mode: Tracking 

Menu: Reconstruction > Set Floor 


Use selected three markers to define a floor. Camera will be 
transformed in a way which makes the selected markers to 
be flat (have Z = 0). 


Set Wall 


Reference 


Mode: Tracking 
Menu: Reconstruction » Set Wall 


Similar to the floor orientation, but defines a wall (selected 
tracks are placed onto the XZ plane). 


Set X/Y Axis 


Reference 
Mode: Tracking 
Menu: Reconstruction > Set X/Y Axis 


Transform camera in a way which makes active track to 
become on X or Y axis. No translation is applied, meaning 
scene origin which was specified before will be preserved. 


Set Scale 

Reference 

Mode: Tracking 

Menu: Reconstruction >» Set Scale 


Scale camera or tracking object in a way which makes 
distance between two selected tracks match the given value 
in Distance. 


Apply Solution Scale 


Reference 


Mode: Tracking 
Menu: Reconstruction » Apply Solution Scale 


Similar to Set Scale, but actually modifies the tracking data. 


Link Empty to Track 


Reference 


Mode: Tracking 
Menu: Reconstruction » Link Empty to Track 


Creates new empty in 3D Viewport and appends constraint 
which parts it to the active track. 


3D Markers to Mesh 


Reference 


Mode: Tracking 
Menu: Reconstruction >» 3D Markers to Mesh 


Creates a mesh which vertices matches positions of 
reconstructed tracks. It is required to have motion solved 
first before using this operator. Only tracks from the current 
tracking object will be used. The intention of this operator is 


to give a nice starting point for a manual mesh 
reconstruction. 
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Track 


Name 
The track name can be changed 
with this field. Track names are 
used for linking tracking data to 
other areas, like a Follow Track 
constraint. 


Enable (eye icon) 7 
This toggle controls if the marker is |. | 


enabled. If a marker is disabled, its Weight (OOD 
position is not used either by solver Stab Weight (@UNIG0D 
nor by constraints. = Custom Color Presets v [gg 


Lock (padlock icon) 
The toggle controls whether the 
track is locked. Locked tracks 
cannot be edited at all. This helps 
to prevent accidental changes to tracks which are 
“finished” (tracked accurate along the whole footage). 


Track panel. 


Track Preview Widget 


The widget in this panel is called “Track Preview” and it 
displays the content of the pattern area. This helps to check 
how accurately the feature is being tracked (controlling that 
there is no sliding off original position) and also helps to 
move the track back to the correct position. The track can 
be moved directly using this widget by mouse dragging. 


If an anchor is used (the position in the image which is 
tracking is different from the position which is used for 


parenting), a preview widget will display the area around 
the anchor position. This configuration helps in masking 
some things when there is no good feature at position where 
the mask corner should be placed. Details of this technique 
will be written later. 


There is small area below the preview widget which can be 
used to enlarge the vertical size of preview widget (the area 
is highlighted with two horizontal lines). 


Further Options 


R,G, B 
Tracking happens in gray-scale space, so a high contrast 
between the feature and its background yields more 
accurate tracking. In such cases disabling some color 
channels can help. 


Grayscale Preview (B/W) 
Display the preview image as gray-scale even if all 
channels are enabled. 


Mask Preview (black/white icon) 
Applies mask defined by an annotation tool in the 
preview widget. 


Weight 
When several tracks are used for 3D camera 
reconstruction, it is possible to assign a reduced weight 
to some tracks to control their influence on the solution 
result. This parameter can (and often need to) be 
animated. 


Altering the weights of problem tracking markers can 
correct or greatly reduce undesirable jumps as feature 


disappear or become difficult to track. 


Another use of Track Weights is when you want to 
reconstruct a scene from your camera solution. In that 
case you can first carefully track and solve your scene, 
and once you are done, lock all your markers with ctr1-L, 
set the tracker weight in the Extra Settings of the tracker 
settings to zero and use the feature detection to quickly 
add lots of markers. Now track them and solve the scene 
again. Since their weight is zero they will not influence 
your solution at all, but you will have lots of good 
reference points in your scene. 


Stabilization Weight 
While Weight parameter is used for 3D reconstruction, 
the Stabilization Weight is used to control 2D 
Stabilization. 


Custom Color Presets 
The preset for the Custom Color. 


Custom Color 
This setting overrides the default marker color used in 
the Clip editor and 3D Viewport, and it helps to 
distinguish different type of features (for example, 
features in the background vs. foreground and so on). 
Color also can be used for “grouping” tracks so a whole 
group of tracks can be selected by color using the Select 
Grouped operator. 


Tip 


To select good points for tracking, use points in the middle 
of the footage timeline and track backwards and forwards 
from there. This will provide a greater chance of the 
marker and point staying in the camera shot. 


Objects Panel 


This panel contains a list view with all ¥ Objects 
objects which can be used for cna 
tracking, camera or object solving. By Object 


default there is only one object in this 
list which is used for camera solving. It 
cannot be deleted and other objects 
cannot be used for camera solving; all Objects panel. 
added objects are used for object 

tracking and solving only. These 

objects can be referenced from Follow Track and Object 
Solver constraints. Follow Track uses the camera object by 
default. 


a 


If some tracks were added and tracked to the wrong object, 
they can be copied to another object using Track >» Copy 
Tracks and Track » Paste Tracks. 


The usage for all kind of objects (used for camera and object 
tracking) is the same: track features, set camera data, solve 
motion. Camera data is sharing between all objects and 
refining of camera intrinsics happens when solving camera 
motion only. 


Plane Track 


Its properties are shown only when a Y Plane Track 

plane track is selected. peer 

Name emeainaiane = 
The name of the selected plane la]v + New gm Open v 


track is shown. It can also be 
changed from here. 


Plane Track panel. 


Auto Keyframe 
Toggles the auto-keyframing for 
corners of the plane track. With this 
enabled, keyframes will automatically get inserted when 
any corner is moved. 


Image 
Field to select or create an image which will be displayed 
inside the plane track. This image is for preview purposes 
in the Movie Clip editor only. To include it in your final 
render, see Plane Track Deform node. 


New Image from Plane Track 
Creates an image from the pixels of the movieclip that 
the plane marker “sees” at the current frame. This allows 
to create an unwarped texture of any flat surface in the 
footage. The resulting image can then be used for editing 
and retouching, for example to paint out certain parts of 
the footage. 


Update Image from Plane Track 
Updates the pixels of the active Plane Track’s image. 


Opacity 


Used to set the opacity of this image. Again, this is for 
display purposes only, and will not affect your final 
render. 


1.. bpy.types.MovieTrackingCamera: 


Camera 


This panel contains all settings of the camera used for 
filming the movie which is currently being edited in the Clip 
editor. Different predefined settings can be used here and 
can be chosen from the panel header. But such settings as 
distortion coefficients and principal point are not included in 
the presets and should be filled in even if camera presets 
are used. 


Sensor Width 
Is the width of the CCD sensor in the camera. This value 
can be found in camera specifications. 


Pixel Aspect 
Is the pixel aspect of the CCD sensor. This value can be 
found in camera specifications, but can also be guessed. 
For example, you know that the footage should be 
1920x1080, but the images themselves are 1280x1080. 
In this case, the pixel aspect is: 1920 / 1280 = 1.5. 


Lens 


Focal Length 
Is self-explanatory; it is the focal length with which the 
movie was shot. It can be set in millimeters or pixels. 


Optical Center 


Is the optical center of the lens used in the camera. In 
most cases it is equal to the image center, but it can be 


different in some special cases. Check camera/lens 
specifications in such cases. 


Tip 


Optical Center also know as the principal point in 


photogrammetry. 


Set Center 


See Set Principal to Center. 


Lens Distortion 


Mathematical function to convert distorted to undistorted 


coordinates. 


Polynomial: 


Division: 


Nuke: 


Brown: 


Coefficients 


Polynomial radial distortion. Uses three 
distortion coefficients: K1, K2, and K3. 
It defines high distortions, which makes 
this model suitable much better for 
cameras with fisheye lenses. Use two 
distortion coefficients: K1, K2. 
Distortion model used by the Nuke 
compositor. Use two distortion 
coefficients K1, K2. 

Brown-Conrady is one of most 
advanced mathematical lens distortion 
models. Used to model both radial and 
tangential distortion. Can use up to 
four radial distortion coefficients: K1 - 
K4 and up to two tangential distortion 
coefficients: Pl and P2. 


Coefficients are used to compensate for lens distortion 
when the movie was shot. Currently these values can be 
tweaked by hand only (there are no calibration tools yet) 


using tools available in Distortion mode. To do this tweak 
K1 until the solving is the closest to the known focal 
length (but also take grid and annotations into account to 
prevent “impossible” distortion). 


Radial Distortion Coefficients (K1 - K4) 


The coefficients in lens distortion models work 
independent from each other. Positive values will give 
a barrel distortion while negative values give a 
pincushion distortion. With a mixture of both negative 
and positive coefficients you can define more 
complicated mustache distortions or other complex 
distortions, that are less common but not rare. 


Example of radial distortion for positive and 
negative K coefficients. 


Tangential Distortion Coefficients (P1, P2) 
Works independent and allow to compensate for 
situations when the sensor is not perpendicular to a 
group of lens. The optical center (also called principal 
point) will be shifted (distorted) from the center of the 
sensor. Pl is used to compensate for sensor rotation in 
Z (vertical) axes, while P2 is for compensating sensor 
rotation in X (horizontal) axes. Such distortions can be 
found in sources from cameras with a sensor 
stabilization system. 


Example of tangential distortion for P 
coefficients. 


Marker 


Search Area 


Center Pattern Area 


Height 


*« ae: . Position 


Position 5 


Width 


Marker schematic. 


This panel contains numerical settings for marker position, 
pattern and search area dimensions, and offset of anchor 
point from pattern center. 


Enabled 
Toggles the markers affect on the current frame. 


Position X, Y 


The X/Y positions of the marker at frame in screen 
coordinates. 


Offset X, Y 
The X/Y offset to parenting point. 


Pattern Area Width, Height 
The width/height of a marker’s pattern in screen 
coordinates. 


Search Area X, Y 
The X/Y position of search at frame relative to the 
marker’s position. 


Search Area Width, Height 
The width/height of the markers search in screen 
coordinates. 


2D Stabilization 
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Introduction 


The 2D video stabilization is a feature built on top of 
Blender’s image feature tracking abilities: You can use some 
tracking points to remove shakiness, bumps and jerks from 
video footage. Typically, image stabilization is part of a 2D 
workflow to prepare and improve footage prior to further 
processing or modeling steps. This page helps to 
understand how it works, introduces related terms and 
concepts, describes the available interface controls in detail 
and finally gives some hints about usage in practice. 


Typical usage scenarios of the stabilizer: 


e Fix minor deficiencies (shaky tripod, jerk in camera 
movement). 

e “Poor man’s steadycam” (when a real steadycam was 
not available, affordable or applicable). 

e As a preparation for masking, matching and 
rotoscoping. 


It is not uncommon for 2D stabilization to have to deal with 
somewhat imperfect and flawed footage. 


How It Works 


To detect spurious movement in a given shot, we’ll assume 
a simplified model about this movement. We then try to fit 
the movement of tracked features with this simplified model 
to derive a compensation. Of course, this works only to the 
degree our model is adequate - yet in practice, this 
simplified approach works surprisingly well even with rather 


complicated shots, where our basic assumption was just an 
approximation of much more elaborate movements. 


This simplified model underlying the 2D stabilization as 
implemented here assumes movement by an affine-linear 
transform: 


e The camera is pushed up/down/sideways by some 
translation component. 

e The image is then tilted and scaled around a pivot point 
(rotation center). 


To compensate movement according to this simplified 
model, the 2D stabilizer proceeds in two steps. First we try 
to detect the translation offset from the weighted average 
of all translation tracking points. After compensating this 
translation component, we then use additional 
rotation/scale tracking points to detect rotation around a 
given pivot point. Again, we detect rotation and scale 
changes through a weighted average of all the 
rotation/scale tracking points given. 


In the current version, the pivot point is anchored to the 
weight center of the translation tracking points. So 
effectively the detected translation is already factored out. 
In some cases this is not optimal, especially when tracks 
have gaps or do not cover the whole duration of the footage 
- we plan further options to better control the pivot point in 
future releases. 


Stabilization Tracks 


Thus, as foundation for any image stabilization, we need 
tracked image features to derive the movements. These 
tracking points or “tracks” can be established with Blender’s 
image feature tracking component The right choice of points 


to track is somewhat tricky, yet crucial for successful image 
Stabilization. Often, we’re here because we'll have to deal 
with imperfect footage. In such cases, the averaging of 
tracks helps to work around image or tracking errors at 
some point. Moreover, when the footage contains 
perspective induced movements, symmetrically placed 
tracking points above and below the horizon can be used to 
cancel out spurious movement and get stabilization to the 
focal area in between. 


Diverging movements caused by perspective. 


Tracks can be added in two groups: 


1. First of all is the list of tracks to be used to compensate 
for jumps in the camera location. From all the tracking 
points added to this group, we calculate a weighted 
average. We then try to keep this average location 
constant during the whole shot. Thus it is a good idea to 
use tracking markers close to and centered around the 
most important subject. 

2. Asecond selection of tracks is used to keep the rotation 
and scale of the image constant. You may use the same 
tracks for both selections. But usually it is best to use 
tracking points with large distance from the image 
center, and symmetrically, on both sides, to capture the 
angular movements more precisely. Similar to the 


“location” case, we calculate an average angular 
contribution and then try to keep this value constant 
during the whole shot. 


Footage, Image & Canvas 


When talking about the movement stabilization of video, we 
have to distinguish several frames of reference. The image 
elements featured by the footage move around irregularly 
within the footage’s original image boundaries - this is the 
very reason why we are using the stabilizer. When our 
attempt at stabilization was successful, the image elements 
can be considered stable now, while in exchange the 
footage’s image boundaries have taken on irregular 
movement and jump around in the opposite way. This is the 
immediate consequence of the stabilizer’s activity. 


Since the actual image elements, i.e. the subject of our 
footage can be considered stable now, we may use these as 
a new frame of reference: we consider them attached to a 
fixed backdrop, which we call the canvas. Introducing this 
concept of a “canvas” helps to deal with deliberate 
movements of the camera. And beyond that, it yields an 
additional benefit: It is very frequent for the pixels of video 
footage to be non-square. So we have to stretch and expand 
those pixels, before we’re able to perform any sensible 
rotation stabilization. Thus the canvas becomes, by 
definition, the reference for an undistorted display of the 
image contents. 


But when the camera was moved intentionally, we have to 
consider yet another frame of reference beyond the canvas: 
namely the frame (or “cadre”) of the final image we want to 
create. To understand this distinction, let’s consider a hand- 
held, panning shot to the right: Since our camera was 


turned towards the right side, the actual image contents 
move towards the left side within the original image frame. 
But let’s assume the stabilizer was successful with “fixing” 
any image contents relative to the canvas - which in turn 
means, that the original image boundaries start to move 
irregularly towards the right side, and the contents of the 
image will begin to disappear gradually behind the left 
boundary of the original image. After some amount of 
panning, we'll have lost all of our original contents and just 
see an empty black image backdrop. The only solution to 
deal with that problem is to move the final image frame 
along to the right, thus following the originally intended 
panning movement. Of course, this time, we do want to 
perform this newly added panning movement in a smooth 
and clean way. 


a! 
Alley. disabled 


Stabilizing a panning shot. 


To allow for such a compensation and to reintroduce 
deliberate panning, or tilting and zoom of the resulting 
image, the stabilizer offers a dedicated set of controls: 
Expected position, Expected rotation and Expected scale. 
These act like the controls of a virtual camera filming the 
contents we have fixed onto the canvas. By animating those 
parameters, we’re able to perform all kinds of deliberate 
Camera movements in a smooth fashion. 


Restoring the expected camera movement. 


The “Dancing” Black Borders 


As explained above, when we succeed with stabilizing the 
image contents, the boundaries of the original footage start 
to jump around in the opposite direction of the movements 
compensated. This is inevitable - yet very annoying, since 
due to the irregular nature of these movements, these 
“dancing black borders” tend to distract attention from the 
actual subject and introduce an annoying restlessness. Thus 
our goal must be to hide those dancing borders as good as 
possible. A simple solution is to add a small amount of 
zoom. Sometimes we'll also need to animate the parameter 
Expected position in order to keep the image centered as 
good as we can - this helps to reduce the amount of zoom 
necessary to remove those annoying borders. 


The Autoscale function can be used to find the minimal 
amount of zoom just sufficient to remove those black 
borders completely. However, if the camera jumps a lot, the 
autoscale function often zooms in too much, especially since 
this calculation aims at finding a single, static zoom factor 
for the whole duration of the footage. When this happens, 
you'll typically get overall better results with animating both 
the zoom factor and the expected position manually. 


2D Stabilization Panel 


The purpose of 2D stabilization is to smooth out jerky 
camera handling on existing real-world footage. To activate 
the 2D stabilizer, you need to set the toggle in the panel, 
and additionally you need to enable Show Stable in the Clip 
Display pop-over. Then you'll need to set up some tracking 
points to detect the image movements. 


The 2D Stabilization panel is used to define the data used 
for 2D stabilization of the shot. Several options are available 
in this panel: you may add a list of tracks to determine 
lateral image shifts and another list of tracks to determine 
tilting and zooming movements. Based on the average 
contribution of these tracks, a compensating movement is 
calculated and applied to each frame. 


When the footage includes panning and traveling 
movements, the stabilizer tends to push the image out of 
the visible area. This can be compensated by animating the 
parameters for the intentional, “expected” camera 
movement. 


Note 


To activate the 2D stabilizer, you need to set the toggle in 
the panel, and additionally you need to enable Show 
Stable in the Clip Display pop-over. 


Options 


Anchor Frame 


Reference point to anchor 
Stabilization: other frames will 
be adjusted relative to this 
frame’s position, orientation and 
scale. You might want to select a 
frame number where your main 
subject is featured in an optimal 
way. 


Stabilization Type 
Rotation 

In addition to location, 
stabilizes detected rotation 
around the rotation pivot 
point, which is the weighted 
average of all location 
tracking points. 


Scale 
Compensates any scale 
changes relative to center of 
rotation. 


Tracks for Stabilization 
Location 
List of tracks to be used to 
compensate for camera 
jumps, or location movement. 


Rotation/Scale 


¥ ™ 2D Stabilization 


Anchor Frame 
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Autoscale 


Target X 

Y 

Expected Rotati.. 
Expected Scale 1.000 
Location Influen.. 1.000 
Rotation Influen.. 1.000 


Scale Influence 1.000 


Interpolate Bilinear 


2D Stabilization panel. 


List of tracks to be used to compensate for camera 


tilts and scale changes. 


Autoscale 


Finds smallest scale factor which, when applied to the 
footage, would eliminate all empty black borders near 


the image boundaries. 


Max 
Limits the amount of automatic scaling. 


Expected Position X/Y 


Known relative offset of original shot, will be subtracted, 
e.g. for panning shots. 


Expected Rotation 


Rotation present on original shot, will be compensated, 
e.g. for deliberate tilting. 


Expected Zoom 


Explicitly scale resulting frame to compensate zoom of 
Original shot. 


Influence 


The amount of transformation applied to the footage can 
be controlled. In some cases it is not necessary to fully 
compensate camera jumps. The amount of stabilization 
applied to the footage can be controlled. In some cases 
you may not want to fully compensate some of the 
camera's jumps. Please note that these “* /nfluence” 
parameters do control only the compensation 
movements calculated by the stabilizer, not the 
deliberate movements added through the “Expected *”- 
parameters. 


Interpolate 
The stabilizer calculates compensation movements with 
sub-pixel accuracy. Consequently, a resulting image pixel 
needs to be derived from several adjacent source 
footage pixels. Unfortunately, any interpolation causes 
some minor degree of softening and loss of image 
quality. 


Nearest 
No interpolation, uses nearest neighboring pixel. This 
setting basically retains the original image’s 
Sharpness. The downside is we also retain residual 
movement below the size of one pixel, and 
compensation movements are done in 1 pixel steps, 
which might be noticeable as irregular jumps. 


Bilinear 
Simple linear interpolation between adjacent pixels. 


Bicubic 
Highest quality interpolation, most expensive to 
calculate. 


Workflow 


Depending on the original footage’s properties, achieving 
good stabilization results might be simple and easy, or it 
might require some work, dedication and careful planning. 
This section covers some practical considerations to help 
improving the results. 


The Simple Case 


Whenever the camera is basically fixed, or at least “almost” 
stationary, and the footage is crisp and without motion blur, 
perfect stabilization is easy to achieve. This might be the 
case when a tripod was used, but wind or vibrations on the 
floor (e.g. on a stage) caused some minor shakes. Shoulder 
camera shots done by an experienced operator also 
frequently fall into this category. 


e Use as few points as possible. Start with a single point 
right on the main subject. 
e Track this single point as accurate as possible. Beware 
of movements and shape changes of the tracked 
feature. Proceed in small increments (e.g. 50 frames), 
zoom in and readjust the target point manually when it 
drifts away. Another option is to use a larger target area 
for tracking; since we're tracking only a single point, the 
Slower tracking speed might be acceptable. 
After enabling the basic (location) stabilization, consider 
if you really need rotation stabilization. Often, some 
minor, slow swinging movements are not really 
noticeable and do not warrant the additional working 
time and quality loss caused by rotation and scale 
stabilization. 


For rotation, start with one extra point, well spaced but 
preferably still attached to the main subject. 

Consider to fix some slow residual motion by manually 
animating the “Expected *” parameters, before you 
even think of adding more tracking markers. Because 
doing so is often not worth the effort. 

If you need to add more points, the most important goal 
is to achieve symmetry. Place location tracking points 
symmetrically above and below the horizon. Place 
rotation tracking points into diagonally opposed 
direction, always centered around the main focal area. 


Avoid Problematic Footage 


The 2D stabilizer can not work miracles; some flaws simply 
can not be fixed satisfactory. Notorious issues are motion 
blur, rolling shutter, pumping autofocus and moving 
compression artifacts. Especially if you do succeed with 
basic stabilization, such image flaws become yet the more 
noticeable and annoying. When on set or on location, it 
might be tempting to “fix matters in postpro”. Resist that 
deception, it rarely works out well. 


Prefer a short exposure time to avoid motion blur. While 
motion blur is good to render filmed movements more 
smooth and natural, it seriously impedes the ability to 
track features precisely. As a guideline, try to get at 
least to 1/250 s. 

Prefer higher frame rates. The more temporal resolution 
the stabilizer has to work on, the better the results. If 
you have the option to choose between progressive and 
interlaced modes, by all means use interlaced and 
deinterlace the footage to the doubled frame rate. This 
can be done with the yadif filter of FFmpeg: use the 
mode 1 (send field). 


e Beware of the Rolling Shutter effect. Avoid fast lateral 
movements. If you can, prefer a camera which produces 
less rolling shutter. Also, using a higher frame rate 
reduces the amount of rolling shutter; another reason to 
prefer interlaced over progressive for the purpose at 
hand. 

Switch off autofocus. Better plan your movement 
beforehand, set a fixed focus and rely on depth of field 
through using a small aperture. Pumping movements 
might not be so noticeable to the human observer, but 
the feature tracking tends to slide away on defocused 
image elements; fixing this manually after the fact can 
cause a huge waste of time. 

Increase the lighting level, at least use a higher 
sensitivity. This helps to set a fast shutter speed plus a 
Small aperture. Better lighting and good exposure also 
help to reduce the impact of compression artifacts. If 
you can, also select a codec with less data reduction, 
better color space, etc. Inevitably, we’re loosing some 
quality through the interpolation necessary for 
Stabilization. Plus we’re loosing some quality due to 
color space conversion. 


Elaborate Movements 


When the footage builds on elaborate intended movement 
of the camera, the process of stabilization becomes more 
involved - especially when there is a shift in the main area 
of interest within the shot. When working with many tracks 
and fine-grained animation, it is easy to get into a situation 
where additional manipulations actually decrease the 
quality, while it might be hard to spot and locate the root 
cause of problems. Recommendation is to proceed 
systematically, starting from the general outline down to 
tweaking of specific aspects. 


1. Understand the nature of the movements in the shot, 
both the intended and the accidental. 


2. Track some relevant features for location. 


3. Establish the basic location stabilization. This includes 
the decision, which feature to use for what segment of 
the shot. Work with the track weights to get an overall 
consistent movement of the weight center, in 
accordance with the inherent focus of the shot. 


4. Define the panning movements of the virtual camera 
(through animation of the Expected Position parameter). 


5. Add tracking for rotation and zoom stabilization. 
6. Fine-tuning pass: 


Break down the whole duration of the shot into logical 
segments to define the intended camera movement. 
Then refine those segments incrementally step-by-step, 
until the overall result looks satisfactory... 


Animating Stabilization 
Parameters 


Animating some parameters over duration of the shot is 
often necessary, at least to get the final touch, including 
control of the scale factor to hide the dancing black borders. 
Unfortunately there is a known limitation in the current 
version: it is not possible to open the generic animation 
editors (Graph editor and Dope Sheet) for animation data 
beyond the 3D scene. So, while it is possible to set 
keyframes right within the UI controls of the stabilizer 
(either through pressing the I key or with the help of the 


context menu), it is not possible to manipulate the resulting 
curves graphically. The only way to readjust or remove a 
misguided keyframe is to locate the timeline to the very 
frame and then use the context menu of the animated UI 
control. (Hint: the color of the UI control changes when you 
have located at precisely the frame number of the 
keyframe.) 


Irregular Track Setup 


It might not be possible to track a given feature over the 
whole duration of the shot. The feature might be blurred or 
obscured; it might even move out of sight entirely, due to 
deliberate camera movement. In such a situation, we need 
another tracked feature to take on its role, and we need 
some overlap time to get a smooth transition without visible 
jump. 


The stabilizer is able to deal with 
gaps and partial coverage within 
the given tracks. However, the 
basic assumption is that each 
track covers a single, fixed 
reference point whenever there 
is any usable/enabled data. 
Thus, you must not “reuse” a 
given track to follow several 
different points, rather you Irregular Tracks. 
should disable and thus end one 

track, when tracking this feature 

is no longer feasible. You may include “gaps”, when a 
tracking point is temporarily disabled or unavailable, but 
you should start a new track for each distinct new feature to 
be tracked. 


Each track contributes to the overall result by the degree 
controlled through its Stab Weight parameter. It is evaluated 
on a per-frame basis, which enables us to control the 
influence of a track by animating this Stab Weight. You may 
imagine the overall working of the stabilizer as if each 
tracking point “drags” the image through a flexible spring: 
When you turn down the Stab Weight of a tracking point, 
you decrease the amount of “drag” it creates. Sometimes 
the contribution of different tracks has to work partially 
counter each other. This effect might be used to cancel out 
Spurious movement, e.g. aS Caused by perspective. But 
when, in such a situation, one of the involved tracks 
suddenly goes away, a jump in image position or rotation 
might be the result. Thus, whenever we notice a jump at the 
very frame where some partially covered track starts or 
ends, we need to soften the transition. We do so by 
animating the Stab Weight gradually down, so that it 
reaches zero at the boundary point. In a similar vein, when 
we plan a “handover” between several partially covered 
tracks, we define a cross-fade over the duration where the 
tracks overlap, again by animating the Stab Weight 
parameters accordingly. But even with such cross-fade 
smoothing, some residual movement might remain, which 
then needs to be corrected with the Expected Position or 
Expected rotation parameters. It is crucial to avoid 
“overshooting” movements in such a situation - always 
Strive at setting the animation keyframes onto precisely the 
same frame number for all the tracks and parameters 
involved. 


View 
Annotations 


Annotation tool strokes can be enabled/disabled with the 
checkbox in the panel header. It is a standard annotations 
panel where annotation layers and frames can be 
controlled. There is one difference in the behavior of the 
annotation tools from other areas - when a new layer is 
created “on-demand” (when making a stroke without adding 
a layer before this) the default color for the layer is set to 
pink. This heightens the color contrast to make the stroke 
more noticeable on all kinds of movies. 


Data Source 


Determines the data-block type the current annotation 
layer is stored. 


Clip: Store the current annotation layer with 
the active Movie Clip data-block. 
Track: Store the current annotation layer with 


the active Track data-block. 
See also 


Annotation Tools for more information on general 
annotation layers. 


Graph View 


Graph View. 


Introduction 


The graph or curves view has numerous purposes based on 
the color of the lines. The red and green lines on the graph 
show you the speed of the trackers at a given frame. Green 
is vertical movement, Red is horizontal. Therefore the first 
frames will always be at zero. 


The blue line is the line that comes out when you click on 
the film strip is the average per-frame error. This curve is 
available only after pressing camera solve and is not 
editable. This is the one line that you want to be as flat as 
possible and as closer to zero as you can. The high points 
will show you where in your shot you are having inaccurate 
tracking. 


Frames outside of scene frame range are darkened. 


Header 


Show Selected (mouse cursor icon) 
Displays the graph for only selected trackers. 


Display Hidden (ghost icon) 
Displays channels from objects that are hidden. 


Filter 
Display options, defines what curves are visible. 


Frames 
Visualizes per-frame average reprojection error of all 
tracks in the active tracking object. 


Motion 
Shows curves for X and Y speed of tracks. 


Error 
Per-frame reprojection error of tracks. 


Usage 


The curves are useful to see if particular trackers are 
moving differently than the average. A line that spikes from 
the rest of the curve usually means a tracking error. 


You can manually edit the curve by selecting a point in the 
curve and dragging it or deleting, that will affect the 
corresponding tracker on that particular frame. 


Lock to Selection L 


Locks the view to selected markers during playback. 


Dope Sheet View 


Dope Sheet View. 


The Dope Sheet View is used to visualize motion tracking 
data, it is implemented as separate view of the Movie Clip 
editor just like the Graph View. 


It displays channels for selected tracks and each channel 
visualizes tracked segments of tracks as dark bars and 
keyframed positions of tracks as small diamonds. 


The background is highlighted depending on the number of 
tracks in a frame. This means that if for a frame (or 
sequence of frames) there are less than eight tracks, the 
background will turn red; if there are from eight to sixteen 
tracks, the background will be yellow. 


This is only a visual feedback, which doesn’t mean that the 
camera motion will not reconstruct with less than eight 
tracks. It only means that you should pay attention to those 


frames and check if all possible good feature points are 
tracked there. Remember, if there are no good feature 
points in the frame and there are less than 16 tracks in the 
frame, it doesn’t mean the solution won’t be accurate. 
Rather, adding more tracks on bad feature points will reduce 
the accuracy of solution. 


Header 

Show Only Selected (mouse (lv View Layer (oc 

cursor icon) > @| Name \ | invert 
Limits Dope Sheet channels 0 1150 1200 1250 1300 
to only information about 
selected tracks. Sort order of the channels. 


Hidden (ghost icon) 
Includes information from 
hidden tracks. 


Sort Method 
Sort order of the tracks. 


Name: Sort selected tracks in alphabetical 
order based on their names. 

Longest: Sort tracks by longest tracked segment 
length. 

Total: Sort tracks by overall amount of 
frames. 


Average Error: Sort tracks by their average 
reprojection error after solving camera 
or object motion. 

Start Frame: Sort channels by first frame number. 

End Frame: Sort channels by last frame number. 


Invert 


To change the sort order from ascending to descending. 


Usage 


The Dope Sheet View is for visualization and does not have 
any tools to actually edit data. 


Masking 
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All 

None 

Invert 

Box Select 
Circle Select 
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Transform 

Clear Feather Weight 
Toggle Cyclic 

Set Handle Type 
Recalculate Handles 
Switch Direction 
Copy Paste 

Clear Parent 

Make Parent 
Animation 
Show/Hide 

Delete 
Miscellaneous 
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Mask Settings 


Mask Layers 
Active Spline 


o Active Point 


Introduction 


Masks can be created in the /Jmage and Movie Clip editors, 
by changing the mode to Mask in the header. This will add 
various tools and properties to the editor panels, while 
hiding others that are not needed for interacting with 
masks. 


Masks have many purposes. They can be used in a motion 
tracking workflow to mask out, or influence a particular 
object in the footage. They can be used for manual 
rotoscoping to pull a particular object out of the footage, or 
as a rough matte for green-screen keying. Masks are 
independent from a particular image of movie clip, and so 
they can just as well be used for creating motion graphics or 
other effects in the Compositor. 


Using the Mask node to isolate an object in 
compositing. 


While the Movie Clip Editor and Image Editor are used to 
edit masks, the Compositor and Sequencer are just using 
already created mask. 


Masks can be animated over the time so that they follow 
some object from the footage, e.g. a running actor. This can 
be achieved with shape keys or parenting the mask to 
tracking markers. 


Mask Data-block 


Mask data-block containing multiple mask layers and 
splines. They are the most high-level entities used for 
masking purposes. Masks can be reused in different places, 
and hold global parameters for all the entities they consist 
of. 


Header 


The Movie Clip Editor header in Mask mode. 


Menus 


View 
Center View to Cursor 
Move the view so that the 2D cursor is at the center of 
the editor. 


Add 
Use to add primitive shapes. 


Mask 
Operators used to Edit masks. 


Controls 


Mask 


Once set to Mask mode, a mask data-block can be added 
with a data-block menu. Any image, movie clip, render or 
compositing result can be used as a backdrop to display 
masks over. 


New + ALt-N 


Mask Display 
See Mask Display. 


S-Curves 


The curve type used for creating mask splines is almost a 
Bézier curve, but with some differences. Smooth edges of 
the mask are defined by feathering. The curve needed to 
support feathering in a way that stuck to the curve as you 
edited it, for ease of editing an animation. These are called 
S-curves. 


Besides the handles, every control point also has points that 
define the feather between the current point and the next 
point on the spline. Each feather point is stored in UW 
space, where U means position across spline segment, and 
W (weight) means distance between main spline and 
feather points. 


S-Curve explained. 


This allows for deforming the main spline in almost any way, 
and the feather will be updated automatically to reflect that 
change. 


For example if there is just rotation of the spline, feather 
would stay completely unchanged. If one point’s feather is 
moved, the other feathers will be automatically stretched 
uniformly along that segment and the overall shape will be 
almost the same as artists would want it to be. 


Primitives 
Reference 

Mode: Mask Mode 
Tool: Add 
Shortcut: Shift-A 


There are two primitives available: a Bézier Circle and a 
Square with vector handles. 


Selecting 
All 


Reference 

Mode: All modes 
Menu: Select > All 
Shortcut: A 


Selects all items. 


None 

Reference 

Mode: All modes 
Menu: Select >» None 
Shortcut: Alt-A 


Resets the selection to nothing. 


Invert 

Reference 

Mode: All modes 
Menu: Select > Inverse 


Shortcut: Ctrl-I 


Selects non-selected items and deselects existing selection. 


Box Select 


Reference 

Mode: All modes 

Menu: Select > Box Select 
Shortcut: B 


See Select Box. 


Circle Select 


Reference 

Mode: All modes 

Menu: Select > Circle Select 
Shortcut: C 


See Select Circle. 


Lasso Select 


Reference 

Mode: All modes 

Menu: Select >» Lasso Select 
Shortcut: Ctrl-Alt-LMB 


See Select Lasso. 


Select Linked 


Reference 

Mode: All modes 

Menu: Select >» Select Linked 
Shortcut: Ctrlel 


Select all curve points linked to already selected ones. 


Editing 


The tools and panels available to edit masks are the same in 
both editors. Editing of mask splines happens in a way 
similar to editing Bézier curves or paths in GIMP or other 
curve editors. 


Tip 


To get interactive feedback on the resulting mask, a Mask 
node can be connected directly to a Viewer node in the 
Compositor, which will then keep updating the compositing 
result while editing. 


Transform 

Reference 

Mode: Mask Mode 
Menu: Mask > Transform 
Move G 


Change the location of control points. Control points can 
also be moved with Lms. The whole spline can be moved 
by dragging the center dot with Lms. 


Rotate R 
Change the location of control points by rotating about a 
pivot point. 


Scale s 


Change the location of control points by expanding the 
distance between points. 


To Sphere Shift-Alt-S 
Morphs the control points to the shape of a circle. 


Shear Shift-Ctrl-Alt-S 
Shifts control points along a defined axis so parallel 
control points move past one another. 


Push/Pull 
Moves the control points closer together (Push) or further 
apart (Pull). 


Scale Feather Alt-S 
Will scale the feather size. 


Clear Feather Weight 


Reference 
Mode: Mask Mode 
Menu: Mask » Clear Feather Weight 


Resets the feather weight to zero. 


Toggle Cyclic 


Reference 
Mode: Mask Mode 
Menu: Mask » Toggle Cyclic 


Shortcut: Alt-C 


Toggle to create a closed curve or open it again. Close the 
mask by joining the last control point to the first. 


Set Handle Type 


Reference 

Mode: Mask Mode 

Menu: Mask » Set Handle Type 
Shortcut: V 


Set handle type for selected spline points. 


Recalculate Handles 


Reference 

Mode: Mask Mode 

Menu: Mask > Recalculate Handles 
Shortcut: Shift-N 


Make normals (handle directions) consistent. 
Switch Direction 


Reference 


Mode: Mask Mode 
Menu: Mask > Switch Direction 


Switch Direction handle directions in/out. 


Copy Paste 


Todo. 


Clear Parent 


Reference 

Mode: Mask Mode 

Menu: Mask > Clear Parent 
Shortcut: Alt-P 


Clears any parenting relationship for the selected spline 
points. 


Make Parent 


Reference 

Mode: Mask Mode 

Menu: Mask > Make Parent 
Shortcut: Ctrl-P 


Parents one or more selected spline points to the active 
motion tracker. 


Animation 


Reference 


Mode: Mask Mode 


Menu: Mask » Animation 


Masks can be animated with the shape keying system. This 
can be useful when there are not enough good feature 
points to track in the footage, or the mask is not based on 
footage. Mask animation timing can be edited from the 
Dope Sheet’s Mask Mode. 


Insert Shape Key I 
Will insert a shape key for the active mask layer at the 
current frame. This works on the level of mask layers, so 
inserting a shape key will keyframe all the splines and 
points contained in it. 


Clear Shape Key Alt-I 
Will clear the shape key for the active mask layer at the 
current frame. 


Feather Reset Animation 
Resets the feather offset across all animated frames. 


Re-Key Points of Selected Shapes 
Re-interpolate selected points on across the range of 
keys selected in the Dope Sheet. 


Show/Hide 


Reference 
Mode: Mask Mode 
Menu: Mask > Show/Hide 


e Hide Selected H 
e Hide Unselected Shift-H 
e Clear Restricted View Alt-H 


Delete 


Reference 

Mode: Mask Mode 
Menu: Mask > Delete 
Shortcut: x 


Removes control points. 


Miscellaneous 


Slide Spline Curvature LMB 
Moves the curve and/or control points by clicking on 
them and dragging. 


Add Vertex and Slide ctrl-LMB 
Inserts new control points and defines handle 
orientations by a continued mouse drag. If the last point 
was selected, double-click will also close the curve. 


Add Feather Vertex and Slide Shift-Ctrl-LMB 
Inserts new feather control points that can be 
transformed independently of the main spline curve. If no 
feather mask is in use this will create a basic feather 
mask to the curve. 


Sidebar 
Mask Settings 


Start Frame, End Frame 
Set the frame range of the mask for Sequencer. 


Mask Layers 


Mask layers consists of one or several [RMRESSENES 
splines and used to “grouped” 
operation on splines. Layers can be 
used to create complex shapes and to 
define how the splines interact with 
each other. Splines belonging to the 
same layer can be animated 
together, for example by an item 
from motion tracker footage. Example 
of such tools might be parenting the 
whole set of splines to single motion 
tracking data or simple to transform 
all of them together. Mask Layer panel. 


MaskLayer 


Opacity 1.000 


Blend Merge Add 


Falloff pk Smooth 


Overlap 4 


Holes 


Opacity 
Used to set the opacity of the mask layer. 


Invert (black/white icon) 
Inverts the values (colors) in the mask layer. 


Blend 
The layer blending operation to perform. See Color Blend 
Modes. 


Modes Merge Add and Merge Subtract give better results 
when using a Feather on overlapping masks than 
straightforward mathematical addition and subtraction. 


Falloff 
Type of the Feather falloff, controls the shape of the 
transition between black and white. 


Overlap 
Fills the self-intersecting areas. 


Holes 


Overlapping splines from the same layer will generate 
holes in the mask. 


@ & 


The Overlap option The Holes option 
example. example. 
Example 


The purpose of mask layers can be explained with an 
example. Suppose there are two unwanted people in the 
footage, and one of them goes from left to right, and the 
other in the opposite direction. Two mask layers can then be 
used to mask them separately by using a single mask data- 
block. At the point of intersection of these shapes they will 
be added together rather than creating a hole, as would 
happen if they were on the same layer. If the motion is 


simple enough, a single motion tracked point can be used to 
drive the location of the entire mask layer. 


Active Spline 


Feather Offset ¥ Active Spline 
The method used for calculating Feather Offset Even 
the offset of the mask Spline Interpolation Ease 


feather. Cyclic @ 
Fill 
Even: Self Intersection Check 


Active Spline panel. 


Preserves the thickness of the feather, 
but can give undesirable loops of the 
feather curve. 

Smooth: Gives a nicer and smoother shape, but 
can also give an undesirable sharp 
feather when a curve segment forms 
an S-shape. 


Weight Interpolation 
The type of weight (thickness of feather) interpolation 
between points. Linear or Ease (i.e. changes occur slowly 
at the beginning and at the end). 


Cyclic 
If the spline is closed or not. 


Fill 
Creates splines with filled areas. If disabled, Blender will 
create curves with a thickness to mask out thin objects 
such as wires or hair. 


Self Intersection Check 
Prevent the feather (not the curve itself) from 
intersecting with itself. 


Active Point 


This panel is shown when both a ¥ Active Point 
tracking marker and mask is selected. revert 


Parent Type Point T.. Plane T.. 


Object @ Camera X 


Track 2s Track 


Active Point panel. 


Parent 


In the Movie Clip Editor it is possible to link the whole mask 
or its points to motion tracks. This way the mask or points 
will follow the tracks. 


Parent 
Data ID to which the mask or spline is parented to in 
case of parenting to movie tracking data set to Movie 
Clip data-block. 


Parent Type 
Point Track, Plane Track 


Object 
Object to parent to. 


Track 
Name of individual tracks. 
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Introduction 


In addition to modeling and animation, Blender can be used 
to edit videos. There are two possible methods for this, one 
being the Compositor and the other, described in this 
chapter, being the Video Sequencer. The Video Sequencer 
within Blender is a complete video editing system that 
allows you to combine multiple video channels and add 
effects to them. You can use these effects to create powerful 
video edits, especially when you combine it with the 
animation power of Blender! 


To use the Video Sequencer, you load multiple video clips 
and lay them end-to-end (or in some cases, overlay them), 
inserting fades and transitions to link the end of one clip to 
the beginning of another. Finally, you can add audio and 
synchronize the timing of the video sequence to match it. 
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Default Video Editing screen layout. 


Setup Your Project 


e Introduction 
e Directory Structure 


Introduction 


The proverb “A good start is half the battle”, certainly 
applies to video editing. Setting up your work environment 
and project to your needs is key to success. In setting up 
your video project, you have to distinguish between: 


e Work Environment related settings and activities: 


These settings apply to all of your projects and are set 
at “Blender level”; for example the installation of add- 
ons. In fact, they can also influence your non-video 
editing projects. Most of these settings remain more or 
less stable throughout your projects and should 
probably only set once. 


Project related settings and activities: 


These settings vary from project to project and are very 
specific for your project; for example the output media 
format. For each new project, you have to evaluate 
these settings and activities. 


Of course, many settings and activities occur at both levels. 
For example, automatic proxies can be enabled globally but 
changed on a per project or even strip basis. The layout of 
the Video Editing Workspace is defined at Blender level but 
can be tweaked per project. 


Directory Structure 


A video project is most likely a combination of several 
different assets. You can separate them into three broad 
categories. 


e Video files: video clips (or movies in Blender-talk), 
photos, graphic files (charts, logos, ...), and Visual 
Effects (VFX) such as masks, lens flares, animation. 

e Audio files: recorded dialog, voice-over, music, and 
Sound Effects (SFX) such as environmental sounds, 
swooshes, ... 

e Project files: the blend files and backups, (partial) render 
results, documentation such as scripts and storyboards. 


Together they can form rapidly an intangible heap of files. 
It’s good practice to collect all those assets in one project 
directory with appropriate subdirectories. Why? It will lower 
the probability that you accidentally delete a file (which will 
result in a ‘file not found’ error) or that you forget to include 
a necessary file when transferring the project (‘file is 
missing’ error). And most of all, an appropriate directory 
structure, will help you to keep a clear overview of your 
assets. 


See also 


Blender can incorporate some files within the Blend file 
(see Packed Data). However, this doesn’t work with video 
files, which can have very huge file sizes. So, it’s better to 
assure that your project directory contains all necessary 
files. 


It’s also good practice to use some kind of naming 
convention and add metadata. Figure 1 shows a possible 
example, based on our categorization of the assets above. 
The directories are numbered so that they mimic a normal 


workflow. 
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Figure 1: Organizing your project. 
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Introduction 


There is no single optimal workflow for editing your video 
projects that fits every case. Although there certainly are 
some specific use cases; e.g. tutorial editing, wedding 
videos, ..., some agreement exists about distinguishing four 
basic activities. 


1. Montage: starting with your raw footage, you'll have to 
deliver a coherent and fluent succession of strips that 
tell your story. Clips have to be rearranged, combined, 
split (cut) and trimmed. 

2. Effects: these can be simple transition effects between 
Strips, e.g. fade or full-fledged animations, e.g. rolling 
end credits. 

3. Color grading: because your assembled timeline 
consists of different shots taken with different cameras 
under different lighting conditions, colors can vary 
widely between them. With color grading and color 
correcting you can harmonize the color perception. 

4. Sound: this ranges from adding background music and 
voice-over to creating special sound effects and using 
third-party software such as Audacity. 
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Transform 
Image Transform 
Split 

Hold Split 
Duplicate Strips 
Delete 

Separate Images 
Movie Strip 
Effect Strip 
Lock/Unlock 
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Inputs 

Change 
Context Menu 
Fades 

Overlap Mode 
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Introduction 


Montage is the technique of assembling separate clips 
(video, audio, text, effects) into a coherent sequence. The 
importance of montage was first demonstrated by the 
Russian filmmaker Lev Kuleshov in the 1910s and 1920s. 
Famous is the Kuleshov effect: viewers derive more meaning 
from the interaction of two sequential shots than from a 
single shot in isolation (see the Wikipedia article for a nice 
illustration). 


Obviously, the first thing in assembling your timeline is 
importing or adding strips. There are several ways to do this 
and each has its own advantages and disadvantages. 


Before you can do anything with a strip, you have to select 
them. There are multiple ways of selecting strips. 


Strips can be moved in time (left to right on the X axis) or in 
the display stack (bottom to top on the Y axis). 


Splitting or cutting a strip will create two parts of the strip 
(before and after the split). There are two variants: Split and 
Hold Split. 


Trimming is the process of removing or adding a portion of 
the video at its head or tail. This will result in a decrease or 
increase of the duration of the video. 


Grouping is the creating of a meta strip whereby several 
strips are grouped together. 


Hint 


Creating a good montage is a time consuming process. 
Therefore, all basic operations (add, split, trim, ...) have an 
associated shortcut. It pays off to learn these shortcuts, 
even though the same result could be obtained with the 
menu and/or mouse. 
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Scene Strip 

Clip Strip 

Mask Strip 

Movie Strip 

Sound Strip 
Image/Sequence Strip 
Color Strip 

Text Strip 


Adjustment Layer Strip 
Effect Strips 
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Add Strip 

Subtract Strip 

Multiply Strip 

Color Mix Strip 
Multicam Selector Strip 
Transform Strip 

Speed Control Strip 
Glow Strip 

Gaussian Blur Strip 
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Sound Crossfade 
Cross Strip 
Gamma Cross Strip 
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Introduction 


A strip is a container which carries frames provided by one 
or more sources (input). It is defined by a Start Frame and a 
Length, and is displayed as a colored horizontal rectangle. 


Hold start Hold end 


ne 


Soft start Soft end 


Strip 
Offset 


Left handle Right handle 
Strip schematic. 


Adding Strips 


Reference 
Menu: Add 
Shortcut: Shift-A 


The Add menu is the main menu you will be using to add 
content to the Video Sequencer. In general, you load up 
your strips, create strips of special transition effects, and 
then animate out your sequence by selecting “Do 
Sequence” and clicking the Animation button. You can use 
the Add menu in the header, or hover your mouse cursor 
over the Sequence workspace and press Shift-A. 


Blender does not care which of these Add 
you use; you can freely mix and match ro paae 
any of them. When you choose to add 4 Clip 
one of these, it lets you either choose a © Mask 
data-block or the editor area will switch HE] Movie 


to a File Browser for you to select what J Sound 
you want to add. Supported files are la] Image/Sequence 
filtered by default. B% Color 
a Text 
The start frame of the newly created ie Maconmes Laver 


Strips will be placed at the position of +t effect Strip 
the frame indicator. When loading 
multiple files (movie and sound) at the 
same time each will be added one after The Add Menu. 
the other. 


Adding Effects & Transitions 


Blender offers a set of effects that can be added to your 
sequence. 


To add an effect strip, select one base strip (image, movie, 
or scene) by LMB clicking on it. For some effects, like the 
Cross transition effect, you will need to Shift-LMB a second 
overlapping strip (it depends on the effect you want). From 
Add menu pick the effect you want. When you do, the Effect 
Strip will be shown above the source strips. If it is an 
independent effect, like the Color Generator, it will be 
placed at the position of the frame indicator. 


Note 


Since most Effects strips depend on one or two source 
Strips, their frame location and duration depends on their 
source strips. Thus, you may not be able to move it; you 


have to move the source strips in order to affect the effect 
Strip. 


With some effects, like the Aloha Over, the order in which 
you select the strips is important. You can also use one 
effect strip as the input or source strip with another strip, 
thus layering effects on top of one another. 


If you picked the wrong effect from the menu, you can 
always exchange it using Effect Strip. 


Visualization 


They all become a color-coded strip in the Video Sequencer: 


Scene strip: Light green. 
Clip strip: Dark blue. 
Mask strip: Red. 

Movie strip: Aquamarine. 
Image strip: Purple. 
Sound strip: Turquoise. 


Each of the effect strips has its own color. 


Besides each of these default colors you can also assign 
individual strips an alternative color in the Strip Properties. 


Note 


These colors are dependent on the user interface Theme. 
The colors described above are in reference to Blender’s 
default theme. 


Scene Strip 


Scene strips are a way to insert the render output of another 
scene into your sequence. Instead of rendering out a video, 
then inserting the video file, you can insert the scene 
directly. 


The strip length will be determined based on the animation 
settings in that scene. 


Note 


Scene strips cannot be used to reference the sequence’s 
own scene; a secondary scene must be used instead. 


Adding Scene Strips 


Existing scenes strips can be added from the Add » Scene » 
“Scene Name”. New scenes can also be created directly 
from the add menu with Add > Scene > New Scene. 


Options 


Start Frame 
The first frame to start the scene strip. 


Channel 
The channel to place the strip in. 


Replace Selection 
Replace the active strip with the new scene strip. 


When creating a new scene you have the following options: 


Type 


How the new scene is created. 


New: 


Copy Settings: 


Linked Copy: 


Full Copy: 


Options 


Scene 


Add new Strip with a new empty Scene 
with default settings. 

Add a new Strip, with an empty scene, 
and copy settings from the current 
scene. 

Add a Strip and link in the collections 
from the current scene (shallow copy). 
Add a Strip and make a full copy of the 
current scene. 


A Data-Block Menu to select or create the scene to 


render from. 


Input 


Input type to use for the Scene strip. 


Camera: 
Sequencer: 


Camera 


Use the Scene’s 3D camera as input. 


Use the scene’s Sequencer timeline as 
input, allowing one scene to reuse 
another scene’s edit (instead of taking 
the render output from the scene). 
This is similar to how Meta Strips work, 
with the added advantage of 
supporting multiple instances of the 
Same data. 


This can be used to override the scene’s camera with any 
other object. 


It is useful to support switching views within a single 
scene. 


Volume 
Volume of the audio taken from the chosen scene. 


Show 
Annotations 
Shows Annotations while in non-render Preview 
Shading Modes t.e. Solid or Wireframe mode. 


Transparent 
Creates a transparent background. This is useful for 
doing overlays like rendering out Grease Pencil films 
via the Sequencer. 


Limitations 


Scene strips do not render individual Render Passes; only 
the Combined render pass will be used. 


Clip Strip 


Clip can be modified within the Movie Clip Editor. 


Options 


This strip has no options. 


Mask Strip 


The Mask strip generates a mask image from the selected 
mask data-block generated in the Movie Clip Editor. This 
works similar to the Mask Node but without the options 
available for finer control. The mask image is always 
generated at the render resolution, scaling along with 
different proxy levels. 


Options 


Mask 
Data-block menu to select a mask. 


Movie Strip 


To add a movie (with or without audio) select a movie file(s) 
in the File Browser e.g. in the Audio-Video Interleaved 
format (*.avi file). 


Note 
Clips can be Huge 


A three minute Quicktime .mov file can be 140MB. Loading 
it, even over a high-speed LAN can take some time. Do not 
assume your computer or Blender has locked up if nothing 
happens for awhile. 


Tip 


Movie strips can display thumbnails in the Sequencer 
overlaid on their strips by enabling the Thumbnails overlay. 


Add Movie Strip 


Reference 


Menu: Add > Movie 


Relative Path 
Store the location of the image file relative to the blend- 
file. 


Start Frame 


The Start Frame to place the left handle of the strip. 


Channel 


The Channel to place the strip. 


Replace Selection 


Replaces the currently selected strips with the new strip. 


Fit Method 


Determines how images with an aspect ratio different 
than the scene’s Resolution are scaled to fit inside the 


render area. 


Scale to Fit: 


Scale to Fill: 


Stretch to Fill: 


Adjusts the strips Scale Transforms so 
the visual contents of the strip to fit 
exactly within the project’s Resolution 
while maintaining the original aspect 
ratio. 

This may mean that the transparent 
areas may be added along the 
content’s border to fit the content in 
the rendered area. 


Adjusts the strips Scale Transforms so 
the visual contents of the strip to span 
the project’s Resolution while 
maintaining the original aspect ratio. 
This may mean that portions of the 
Original image no longer fit the content 
inside the rendered area. 


Adjusts the strips Scale Transforms so 
the visual contents of the strip to fill 
the project’s Resolution. Note, unlike 
the other two methods described 
above, Stretch to Fill does not 
maintaining the original aspect ratio. 


This may mean that the original image 
becomes distorted to fit the content 
inside the rendered area. 


Set View Transform 


Automatically sets an appropriate View Transform based 
on the Color Space of the imported media. In most cases, 
the Standard should be used; using the wrong transform 
could result in inaccurate colors or degraded rendering 
performance. 


Adjust Playback Rate 


Automatically adjusts the video’s speed to playback at 
the original soeed regardless of the scene’s framerate. 


Sound 
Add a Sound Strip that contains the movie’s audio track. 


Use Movie Frame Rate 


Sets the Scene Frame Rate to the frame rate encoded in 
the movie file. 


Example 


8625.MP4: C:\Users\john\Desktop\vid\MVI_8625.MP4 | 684 


Imported Movie strip with audio track underneath. 


In the strip itself, you can see strip name, path to source 
file, and strip length. 


Sound Strip 


As well as images and movies the Video Sequencer can also 
edit audio tracks. You can add Waveform Audio format wav, 
mp3 and other audio formats files from your drive, or from 
sound encoded within a movie, and mix them using an F- 
Curve as a volume control. 
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Example of sound editing. 


Working with Audio Tracks 


A Sound strip is just like any other strip in the Video 
Sequencer. You can select and move it, adjust its starting 
offset using LMB over the strip handles, and kK cut it into 
pieces. A useful example is cutting out the “um’s” and dead 
voice time. 


You can have as many Sound strips as you wish and the 
result will be the mixing of all of them. You can give each 
Strip its own name and volume via the Sidebar region. 


Overlapping strips are automatically mixed down during the 
rendering process. For example, you can have the 
announcer on channel 5, background music on channel 6, 
and Foley sound effects on channel 7. 


See also 


In the Playback Popover menu of the Timeline you will find 
some options concerning audio playback behavior. 


Animating Audio Track 
Properties 


To animate Sound strips simply hit I over any of its values. 
Examples of animating an audio strip are to fade in/out 
background music or to adjust volume levels. 
Layered/crossed Sound strips are added together; the lower 
channel does not override and cut out higher channels 
(unlike image and video strips). This makes Blender an 
audio mixer. By adding audio tracks and using the curves to 
adjust each tracks’ sound level, you have an automated 
dynamic multi-track audio mixer! 


See also 


Sounds can be crossfaded by adding a Sound Crossfade 
effect. 


Output 


There are two ways to render out your audio. You can either 
have it encoded with a video file or in its own audio file. 
Read more on how to select a proper audio format and how 
to start rendering. 


Add Sound Strip 


Reference 


Menu: Add > Sound 


Relative Path 
Store the location of the image file relative to the blend- 
file. 


Start Frame 
The Start Frame to place the left handle of the strip. 


Channel 
The Channel to place the strip. 


Replace Selection 
Replaces the currently selected strips with the new strip. 


Cache 
Cache the sound in memory, enables Caching in the 
Source properties. 


Mono 
Merge all sound channels into one channel, enables Mono 
in the Sound properties. 


Image/Sequence Strip 


Tip 


Image strips can display thumbnails in the Sequencer 
overlaid on their strips by enabling the Thumbnails overlay. 


Single Image 


When you add a single still image (*.jpg, *.png, etc.), Blender 
creates a 25 frames long strip which will show this image 
along the strips range. 


Image Sequence 


In the case of (numbered) image sequences (e.g. *-0001. jpg, 
*-Q002.jpg, *-0003.jpg, etc, of any image format), you have a 
choice: 


Range 
Navigate into the directory and LmB click and drag over a 
range of names to highlight multiple files. You can page 
down and continue Shift-LMB click-dragging to add more 
to the selection. 


Batch 
Shift-LMB click selected non-related stills for batch 
processing; each image will be one frame, in sort order, 
and can be a mix of file types (jpg, png, exr, etc.). 


All 


Press A to select/deselect all files in the directory. 
Tip 
Dealing with Different Sizes 


Dealing with different sized images and different sized 
outputs is tricky. If you have a mismatch between the size 
of the input image and the render output size, the Video 
Sequencer will try to auto-scale the image to fit it entirely 
in the output. This may result in clipping. If you do not 
want that, use Crop and/or Offset in the Input panel to 
move and select a region of the image within the output. 
When you use Crop or Offset, the auto-scaling will be 
disabled and you can manually re-scale by adding the 
Transform effect. 


Add Image Strip 


Reference 


Menu: Add > Image/Sequence 


Relative Path 
Store the location of the image file relative to the blend- 
file. 


Start Frame 
The Start Frame to place the left handle of the strip. 


End Frame 
The end frame to place the right handle of the strip. 


Tip 


Subtract the Start Frame from the End Frame to get the 


strip’s duration. 


Channel 


The Channel to place the strip. 


Replace Selection 


Replaces the currently selected strips with the new strip. 


Fit Method 


Determines how images with an aspect ratio different 
than the scene’s Resolution are scaled to fit inside the 


render area. 


Scale to Fit: 


Scale to Fill: 


Stretch to Fill: 


Adjusts the strips Scale Transforms so 
the visual contents of the strip to fit 
exactly within the project’s Resolution 
while maintaining the original aspect 
ratio. 

This may mean that the transparent 
areas may be added along the 
content’s border to fit the content in 
the rendered area. 


Adjusts the strips Scale Transforms so 
the visual contents of the strip to span 
the project’s Resolution while 
maintaining the original aspect ratio. 
This may mean that portions of the 
Original image no longer fit the content 
inside the rendered area. 


Adjusts the strips Scale Transforms so 
the visual contents of the strip to fill 
the project’s Resolution. Note, unlike 
the other two methods described 
above, Stretch to Fill does not 
maintaining the original aspect ratio. 
This may mean that the original image 
becomes distorted to fit the content 
inside the rendered area. 


Set View Transform 
Automatically sets an appropriate View Transform based 
on the Color Space of the imported media. In most cases, 
the Standard should be used; using the wrong transform 
could result in inaccurate colors or degraded rendering 
performance. 


Use Placeholders 
Image sequences can use placeholder files. This works by 
enabling Use Placeholders checkbox when adding an 
image strip. The option detects the frame range of 
opened images using Blender’s frame naming scheme 
(filename + frame number + .extension) and makes an image 
sequence with all files in between even if they are 
missing. This allows you to render an image sequence 
with a few frames missing and still the image strip will 
have the correct range to account for the missing frames 
displayed as black. 


When the missing frames are rendered or placed in the 
same folder, you can refresh the Sequencer and get the 
missing frames in the strip. The option is also available 
when using the Change Data/File operator and allows you 
to add more images to the range. 


Color Strip 


This effect generates solid color frames. By default, when it 
is created, the Color strip is 25 frames long, but you can 
extend it by selecting and moving one of the ends. Use this 
Strip crossed with your main movie to provide a fade-in or 
fade-out. 


Options 


Color 
Click on the color field in the Effect panel in the Sidebar 
region, to pick a different color. 


Text Strip 


The Text strip allows you to directly display text in the 
Sequence editor. The strip will display the text inserted in its 
text field on the final sequence. 


Tip 


All Text strips in a video sequence can be exported as a 
SubRip file. This is useful when using Text strips as 
subtitles. 


Options 


Text 
The actual text displayed. 


Wrap Width 
Wraps the text by the percentage of the frame width, 
setting this to zero disables word wrapping. 


Style 


Font 


Data-Block Menu to choose which font-file is used to 
render the text. 


Bold 
Use a bold font face with a strong/thick visual 
appearance. 


Italics 
Use an italicized font face with a slanted visual 
appearance. 


Size 
Size of the text. 


Color 
The text color. 


Shadow 
Creates a shadow of the specified color under the text. 


Box 
Creates a background for the text to improve the 
readability and clarity of text in some situations. The 
color and opacity of the box can be adjusted using the 
color selector. 


Box Margin 
The distance the box boundaries extends from the 
boundaries of the font glyphs. The distance is measured 
as a factor of the image’s width. 


Layout 


Location X, Y 
Positions the text on the X, Y axis. 


Anchor X, Y 
Horizontal (X) or vertical (Y) anchor point of the text 
relative to the location. 


Example 
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Text effect. 


Adjustment Layer Strip 


The Adjustment Layer strip works like a regular input file 
Strip except for the fact, that it considers all strips below it 
as its input. 


Real-world use cases, you want to add some last finishing 
color correction on top of parts of your final sequence, 
timeline without messing with meta strips around. Just add 
an adjustment layer on top and activate the color balance. 


Or you can stack a primary color correction and several 
secondary color corrections on top of each other (probably 
using the new mask input for area selection). 


Options 


This strip has no options. 


Effect Strips 


Add Strip 

Subtract Strip 

Multiply Strip 

Color Mix Strip 
Multicam Selector Strip 
Transform Strip 

Speed Control Strip 
Glow Strip 

Gaussian Blur Strip 


Add Strip 


The Add effect strip adds the colors of two strips together. 
Use this effect with a base image strip, and a modifier strip. 
The modifier strip is either a solid color or a black-and-white 
mask, or another image entirely. 


You can use this effect to increase the brightness of an 
image, or if you use a BW mask, selectively increase the 
brightness of certain areas of the image. The Mix node, in 
Add mode, does exactly the same thing as the Add SFX strip 
here, and is controlled the same way by feeding the Factor 
input. 


The example shows what happens when you add gray to an 
image. The image gets bright because we are adding gray 
RGB(0.5, 0.5, 0.5) to say, a blue color RGB(0.1, 0.1, 0.5) 
resulting in RGB(0.6, 0.6, 1.0) which retains the original hue 
(relationship between the colors) but is much brighter (has a 
higher value). When applied to the whole image like this, it 
seems to flash. 


Options 
This strip has no options. 
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Add Effect. 


Subtract Strip 


This effect takes away one strip’s color from the second. 


Make a negative of an image using this effect, or switch the 
order of the strips and just darken the strip. Subtracting a 
hue of blue from a white image will make it yellow, since red 
and green make yellow. 


Options 


This strip has no options. 


Example 


Subtract Effect. 


Multiply Strip 


The Multiply effect multiplies two colors. Blender uses 
values between (0.0 to 1.0) for the colors. This operation 
does not have to be normalized, the multiplication of two 
terms between (0.0 to 1.0) always gives a result between 
(0.0 to 1.0). 


(With the “traditional” representation of three bytes, like 
RGB(124, 255, 56), the multiplications give far too high 
results, like RGB(7316, 46410, 1848), that have to be 
normalized (brought back) by dividing them by 256 to fit in 
the range of (0 to 255)...) 


This effect has two main usages: 


With a Mask 


A mask is a black-and-white picture which, after 
multiplication with a “normal” image, only show this one in 
the white areas of the mask (everything else is black). 


The opening title sequence to James Bond movies, where 
the camera is facing down the barrel of a gun at James, is a 
good example of this effect. 


With Uniform Colors 


Multiplying a color with a “normal” image allows you to 
soften some hues of this one (and so - symmetrically - to 
enhance the others). 


For example, if you have a brown pixel RGB(0.50, 0.29, 
0.05), and you multiply it with a cyan filter (uniform color 


RGB(0.0, 1.0, 1.0)), you will get a color RGB(0.0, 0.29, 0.5). 
Visually, the result is to zero the reds and bring up (by 
“symmetry” - the real values remain unchanged!) the blues 
and greens. Physically, it is the same effect as shining a 
cyan light onto a chocolate bar. Emotionally, vegetation 
becomes more lush, water becomes more Caribbean and 
inviting, skies become friendlier. 


Note 

This effect reduces the global luminosity of the picture (the 
result will always be smaller than the smallest operand). If 
one of the images is all white, the result is the other 


picture; if one of the images is all black, the result is all 
black! 


Options 
This strip has no options. 
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Multiply Effect. 


Alpha Over, Under & Over 
Drop Strips 


Using the alpha (transparency channel), this effect 
composites a result based on transparent areas of the 
dominant image. If you use a Scene strip, the areas of the 
image where there is not anything solid are transparent; 
they have an alpha value of 0. If you use a Movie strip, that 
movie has an alpha value of 1 (completely opaque). 


So, you can use the Alpha Over / Alpha Under effect to 
composite the CGI Scene on top of your movie. The result is 
your model doing whatever as if it was part of the movie. 
The Adjust » Compositing >» Opacity controls how much the 
foreground is mixed over the background, fading in the 
foreground on top of the background. The colors of 
transparent foreground image areas are ignored and do not 
change the color of the background. 


Alpha Over 


With Alpha Over, the strips are layered up in the order 
selected; the first strip selected is the background, and the 
second one goes over the first one selected. The Opacity 
controls the transparency of the foreground, i.e. Opacity of 
0.0; will only show the background, and an Opacity of 1.0 
will completely override the background with the foreground 
(except in the transparent areas of this one, of course!) 


Warning 


By clicking the Premultiply Alpha button in the Sidebar of 
the foreground strip, the alpha values of the two strips are 
not multiplied or added together. Use this effect when 
adding a foreground strip that has a variable alpha channel 
(Some opaque areas, some transparent, some in between) 
over a Strip that has a flat opaque (alpha=1.0 or greater) 
channel. If you notice a glow around your foreground 
objects, or strange transparent areas of your foreground 
object when using Alpha Over, enable Premultiply. 


Example 


Alpha Over Effect. 


Alpha Under 


With Alpha Under, this is the contrary: The first strip 
selected is the foreground, and the second one, the 
background. Moreover, the Opacity controls the 
transparency of the background, |.e. an Opacity of 0.0; will 
only show the foreground (the background is completely 
transparent), and an Opacity of 1.0 will give the same 
results as with Alpha Over. 


Over Drop 


Over Drop is between the two others: as with Alpha Under, 
the first selected strip will be the foreground, but as with 
Alpha Over, the Opacity controls the transparency of this 
foreground. 


The Over Drop effect is much like the Cross, but puts 
preference to the top or second image, giving more of a 
gradual overlay effect than a blend like the Cross does. Of 
course, all of the Alpha effects respect the alpha 
(transparency) channel, whereas Cross does not. 


The degree of Alpha applied, and thus color mixing, can be 
controlled by an F-Curve. Creating a Sine wave could have 
the effect of the foreground fading in and out. 


Color Mix Strip 


The Color Mix effect strip mixes two strips by working on the 
individual and corresponding pixels of the two input strips. 


This effect can do the exact same operation as the Add, 
Subtract, or Multiply effect strips but also other color 
blending modes. 


Options 


Blend 
The Blend modes can be selected in the select menu. 
See Color Blend Modes for details on each blending 
mode. 


Add, Subtract, Multiply, Screen, Divide, Difference, 
Darken, Lighten, Overlay, Color Dodge, Color Burn, Hue, 
Saturation, Value, Color, Soft Light, Linear Light 


Opacity 
The amount of the blend of the second image gets 
composed onto the first. 


Multicam Selector Strip 


The Multicam Selector strip is used for multi-camera editing. 
Multi-camera editing is when a scene is recorded using 
multiple cameras from different angles and then edited 
together afterwards. 


Workflow 


The process of multi camera editing can be rather easy in 
the Video Sequencer if properly setup. The following guide 
shows the basic steps to setup a basic multi camera editing 
workflow. 


1. First you are going to want to add in each of your video 
Strips. 


2. Next, you will want to sync all your cameras by either 
using Audio Waveforms or by the movement of objects. 


Tip 


To make syncing strips easier you can group cameras, 
their audio, and their effects together using Meta 
Strips. 


3. Split the editor into many Previews, one for each input 
track. Then change the Display Channel of each of the 
previews to the channel number of the input track. 


4. Add a Multicam Selector strip above all the video 
channel tracks. 


After completing these steps you should get something 
similar to the following image: 


Multi-camera editing setup. 


5. Now select the Multicam strip, if you take a look at the 
strip options (in the Sidebar), you will notice, that 
Multicam is a rather simple effect strip: It just takes a 
selected channel as its input. That is all. The magic 
comes with the convenient keyboard layout. 


6. When you select the Multicam strip, the keys 1 to 9 are 
mapped to the cut buttons. So, select the Multicam strip 
and start playback and press the keys for the correct 
input while watching the individual cameras. 


7. You will end up with a small Multicam Selector strip for 
every cut. 


In reality, it boils down to: watch a few seconds to see, what 
is Coming, watch it again and do a rough cut using the 
number keys. Then fine-tune the placement by selecting the 
outer handles of two neighboring Multicam for A/B rolling. 
Tip 


To improve playback performance enable Proxies. 


Options 


Source Channel 


The channel which the Multicam Selector gets its input 
from. 


Cut To 


Cuts the Multicam strip at the current frame and changes 
the Source Channel! automatically to the selected 
channels. 


Workflow 


1. First you are going to want to add in each of your video 
Strips. 


2. Next, you will want to sync all your cameras by either 
using Audio Waveforms or by the movement of objects. 
Tip 


To make syncing strips easier you can group cameras, 
their audio, and their effects together using Meta 
strips. 


3. Split the editor into many Previews, one for each input 
track. Then change the Display Channel of each of the 
previews to the channel number of the input track. 


4. Add a Multicam Selector strip above all the video 
channel tracks. 


After completing these steps you should get something 
similar to the following image: 


Multi-camera editing setup. 


5. Now select the Multicam strip, if you take a look at the 
strip options (in the Sidebar), you will notice, that 
Multicam is a rather simple effect strip: It just takes a 
selected channel as its input. That is all. The magic 
comes with the convenient keyboard layout. 


6. When you select the Multicam strip, the keys 1 to 9 are 
mapped to the cut buttons. So, select the Multicam strip 
and start playback and press the keys for the correct 
input while watching the individual cameras. 


7. You will end up with a small Multicam Selector strip for 
every cut. 


In reality, it boils down to: watch a few seconds to see, what 
Is coming, watch it again and do a rough cut using the 
number keys. Then fine-tune the placement by selecting the 
outer handles of two neighboring Multicam for A/B rolling. 


Tip 


To improve playback performance enable Proxies. 


Transform Strip 


Transform is a swiss-army knife of image manipulation. It 
moves, rotates, and scales the images within a strip. 


Options 


Interpolation 
None 
No interpolation, uses nearest neighboring pixel. 


Bilinear 
Simple interpolation between adjacent pixels. 


Bicubic 
Highest quality interpolation. 


Translation Unit 
Control whether the input values are in Percent or Pixels. 


Position 
Moves the input along the X and Y axis. 


Uniform Scale 
Scale the input evenly along the X and Y axis. 


Scale 
Scale the image on the X and Y axis. 


Rotation 
Rotates the input two-dimensionally along the Z axis. 


Example 


7 Effect Strip 
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Transform Effect. 


Speed Control Strip 


Speed Control time-warps the strip, making it play faster or 
Slower than it normally would. Playing faster means that 
some frames are skipped, and the strip will run out of 
frames before the end frame. When the strip runs out of 
frames to display, it will just keep repeating the last one 
action that will appear to be frozen. To avoid this, position 
the next strip under the original at a point where you want 
the motion to continue. 


Options 


Speed Control 
The method used to adjust the speed of the strip. 


Stretch: Automatically calculates the speed 
effect based on the length of the input 
strip. If you scale a strip to 1/2 the 
Original size the sequence will play 
back at 2 times the speed. 


Multiply: Multiplies the current speed of the 
sequence by a Multiply Factor. Thus a 
value of 0.5 will make the sequence 
half as fast while 2 would make the 
sequence twice as fast. Negative 
values will reverse the input while also 
adjusting the speed, so a value of 
negative two will play in reverse and 
twice as fast as normal. 


Note 


You will have to manually re-adjust 
the length of the strip accordingly. 


Frame Number: 
Specifies a frame to remap the current 
frame to, for example, setting the 
Frame Number value to 50 displays the 
50th frame. This can then be manually 
keyframed to recreate the animation. 


Length: Maps the frame range on a percentage 
scale. For example, using this and a 
value of 50% will select the frame 
halfway through the sequence. 


Interpolation 
Crossfades between frames to reduce screen tearing 
when the speed is slower than the original frame rate. 


Examples 


Creating a Slow-Motion Effect 


Suppose you want to slow your strip down. You need to 
affect the speed of the video clip without affecting the 
overall frame rate. Select the clip and Add » Effect » Soeed 
Control! effect strip. 


Choose the Multiply option in the Effect Strip panel in the 
Sidebar. Set the Multiply Factor to be the factor by which 
you want to adjust the speed. To cut the displayed speed by 
50%, enter 0.5. Now, a 275-frame clip will play at half 
speed, and thus display only the first 137 frames. 


If you want the remaining frames to show in slow motion 
after the first set is displayed, double the Length of the 


source strip (since effects strip bounds are controlled by 
their source strips). If you are using a speed factor other 
than 0.5 then use the formula: 


new_length = real_length / speed _ factor 


That is it, set your render to animate (in this example) all 
550 frames. 


Keyframing the Speed Control 


To get even finer control ¥ Effect Strip 
over your clip timing, you 
can use curves! While it is ope = 
possible to keyframe the 2.00 
Multiply factor, usually you 
want to keyframe the 
Frame number directly. 


Input 1 


Interpolation 


Keyframing the Frame number. 
Choose the Frame Number 
option. You now have a 
Frame number field which you can keyframe. If you want the 
Strip to animate at all you will have to insert some 
keyframes, otherwise it will look like a still. In most cases 
you will want to use the Graph editor view to set the curve 
interpolation to Linear since the default Bézier will rarely be 
what you want. 


Tip 
If you choose to keyframe the Speed factor instead, 


remember to Refresh All or the changes will not take 
effect. 


Changing Video Frame Rates 


You can use the speed control to change the frame rate in 
frames per second (fps) of a video. If you are rendering your 
video to a sequence set, you can effectively increase or 
decrease the number of individual image files created, by 
using a Multiply value less than or greater than one, 
respectively. 


For example, if you captured a five-minute video at 30 fps 
and wanted to transfer that to film, which runs at 24 fps, 
you would enter a Multiply Factor of 30/24, or 1.25 (and 
enable Interpolation frame blending to create a film blur 
effect). Instead of producing 5 x 60 x 30 = 9000 frames, 
Blender would produce 9000 / 1.25 = 7200 = 5 x 60 x 24 
frames. In this case, you set a start = 1 and end = 7200, set 
your Format output to jpeg 30fps, and image files 0001. jpg 
through 7200.jpg would be rendered out, but those images 
cover the entire 9000 frames. The image file 7200. jpg is the 
same at frame 9000. When you read those images back into 
your film blend-file at 24 fps, the strip will last exactly 5 
minutes. 


Glow Strip 


This effect makes parts of an image glow brighter by 
working on the luminance channel of an image. The Glow is 
the superposition of the base image and a modified version, 
where bright areas are blurred. 


To “animate” the glow effect, mix it with the base image 
using the Gamma Cross effect, crossing from the base 
image to the glowing one. 


Options 


Threshold 
Areas brighter than the Threshold are blurred. 


Clamp 
The maximum luminosity that is added. 


Boost Factor 
Multiplier of the brightness. 


Blur Distance 
The size of the blur. 


Quality 
Improves the quality of the glow by giving smoother 
results but will be slower. 


Only Boost 
This checkbox allows you to only show/use the 
“modified” version of the image, without the base one. 
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Glow effect. 


Gaussian Blur Strip 


The Gaussian Blur strip is used to blur the input strip ina 
defined direction. This can be used to blur a background or 
to blur a transition strip. 


Options 


Size X 
Distance of the blur effect on the X axis. 


Size Y 
Distance of the blur effect on the Y axis. 


Example 
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Gaussian Blur Effect. 


Transitions 


e Sound Crossfade 

e Cross Strip 

e Gamma Cross Strip 
e Wipe Strip 


Sound Crossfade 


The Sound Crossfade transition works by animating the 
Volume of two overlapping Sound strips to evenly fade 
between them. Because this simply animates a value it does 
not create a strip like other effects or transitions. 


Cross Strip 


The Cross transition fades from one strip to another, also 
known as a crossfade. Strips can be overlapping or have a 
gap between them, however, when strips contain a gap the 
last and first frame of each strip is extend which can cause 
a pause if any of the strips are a sequence. 


Options 


Default Fade 


Automatically calculates a linear fade over the length of 
the strip. 


Effect Fader 
Allows you to manually keyframe a custom fade. This 
can be used with different easings to fine-tune the 
fade in/out. 


Example 
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Cross Effect. 


Gamma Cross Strip 


The Gamma Cross transition is similar to the Cross Strip 
transition, however, the Gamma Cross strip transition uses 
color correction while transitioning between the two strips, 
resulting in a smoother transition that is easier on the eyes. 


Options 


Default Fade 


Automatically calculates a linear fade over the length of 
the strip. 


Effect Fader 
Allows you to manually keyframe a custom fade. This 
can be used with different easings to fine-tune the 
fade in/out. 


Wipe Strip 


The Wipe transition strip can be used to transition from one 
Strip to the next. The wipe will have no effect if created from 
a single strip instead of two strips. The duration of the wipe 
is the intersection of the two source strips and cannot be 
adjusted. To adjust the start and end of the wipe you must 
adjust the temporal bounds of the source strips in a way 
that alters their intersection. 


Options 


Transition 
The type of transition used. 


Single 
Reveals the next strip by uncovering it in a straight 
line moving across the image. 


Double 
Similar to Single, but uses two lines either starting 
from the middle of the image or the outside. Like the 
blink of an eye. 


Iris 
Reveals the next strip through an expanding (or 
contracting) circle. Like the aperture of a camera or 
pupil of an eye. You can blur the transition, so it looks 
like ink bleeding through a paper. 


Clock 
Like the hands of an analog clock, it sweeps clockwise 
or (if Wipe In is enabled) counterclockwise from the 


9:00 position. As it sweeps, it reveals the next strip. 


Direction 
Controls whether to fade /n or Out. 


Blur Width 
The width of the blur used to blur the transition. 


Angle 
Controls the angle of the line for Single and Double 
transition types. 


Default Fade 


Automatically calculates a linear fade over the length of 
the strip. 


Effect Fader 
Allows you to manually keyframe a custom fade. This 
can be used with different easings to fine-tune the 
fade in/out. 


Example 
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Wipe Effect. 


Selecting 


The active sequence strip is displayed with a light outline. 
The entire strip could be selected by clicking LmsB in the 
middle of the strip. 


Select Menu 


The Select Menu helps you select strips in different ways. 


All A 
Selects all the strips in the timeline. 


None Alt-A 
Deselects all the strips in the timeline. 


Invert Ctrl-I 
Inverts the current selection. 


Box Select B 
Click and drag a rectangular lasso around a region of 
strips in your Sequence workspace. Selects strips all 
intersecting this rectangle. 


Box Select (Include Handles) ctri-B 
Works the same as Box Select but it selects only the 
Strip’s handles, if just one handle is selected moving the 
Strip after selecting will change the strip’s length. If both 
handles are selected the strip will move and behave the 
exact same as Box Select. 


Side of Frame 
Left/Right [/] 


Select strips laying left or right to the current frame. 


Current 
Select strips intersecting with the current frame. 


Handle 
Operators to select strip handles. These operators are 
useful to change the timing of a cut by moving the 
handles after selecting them. 


Both, Left, Right 
Select the left, right, or both handles of selected 
Strips. 


Both/Left/Right Neighbor 
Select the handle of the neighboring strip to the left, 
right, or on both sides of the selected strips. 


Channel 
Select strips in the same channel laying left or right to 
active strip. 


Linked 
All ctri-L / Less Ctrl-NumpadMinus / More Ctrl-NumpadPlus 
Selects strips, that are placed next to each other 
without any gaps. 


Grouped Shift-G 
Selects strips according to their relation with other strips. 


Type 
Selects any strips of the same type within a category 
for example, if you have a Cross strip selected this will 
select all other effect strips. 


Global Type 


Selects any strips of the same type, e.g. Effect, Image, 
Movie, etc. 


Effect Type 
Selects all effect strips. 


Data 
Selects strips that share the same data, for example, 
two image strips sharing the same image file. 


Effect 
Selects the strip that shares an effect strip. 


Effect/Linked 
Selects the effect strips, if any, linked to the currently 
selected strip. 


Overlap 
Selects any strips that occur on the same frame as the 
current. 


Editing 


Transform 

Move 

Reference 

Menu: Strip > Transform » Move 
Shortcut: G 


Pressing G moves all the selected strip(s). Move your mouse 
horizontally (left/right) to change the strip’s position in time. 
Move vertically (up/down) to change channels. 


Holding down ctrt while dragging snaps to the start and 
endpoints of other strips. The position of the mouse relative 
to the selection influences where the strips are snapped. If it 
is closer to the start of the selection, then the start frame of 
the selection gets snapped, else the end frame will get 
Snapped. 


To “ripple edit” (make room for strips you drag) hold Alt 
when placing a strip. 


You can also lock the direction to time with x or to change 
the strip’s channel with y. 


It is possible to move strips using mouse by dragging them 
while holding Lms. Currently it is possible to move only one 
Strip by dragging. 


Start Frame Offset 


The Start Frame Offset for that strip can be selected by 
clicking LmB on the left handle of the strip; holding it down 
(or pressing G and then moving the mouse left/right) 
changes the start frame within the strip by the number of 
frames you move it. The frame number label under the strip 
displays the start frame of the strip. 


e If you have a 20-image sequence strip, and drag the left 
handle to the right by 10 frames, the strip will start at 
image 11 (images 1 to 10 will be skipped). Use this to 
clip off a roll-up or undesired lead-in. 

e Dragging the left handle left will create a lead-in 
(copies) of the first frame for as many frames as you 
drag it. Use this when you want some frames for a 
transition at the start of the clip. 


End Frame 


The End Frame of the strip could be selected by clicking LmB 
on the right handle of the strip; holding it down (or pressing 
G) and then moving the mouse changes the ending frame 
within the strip. The frame number label over the strip 
displays the end frame of the strip. 


e Dragging the right handle to the left shortens the clip; 
any original images at the tail are ignored. Use this to 
quickly clip off a roll-down. 

Dragging the right handle to the right extends the clip. 
For movies and images sequences, more of the 
animation is used until exhausted. Extending a clip 
beyond its length will render as a copy of the last image. 
Use this for transitions out of this clip. 


Note 
Multiple selection 


You can select several (handles of) strips by Shift-LMB 
clicking: when you press G, everything that is selected will 
move with your mouse - this means that, for example, you 
can at the same time move a strip, shorten two others, 
and extend a forth one. 


Move/Extend from Current Frame 


Reference 

Menu: Strip » Transform >» Move/Extend from 
Current Frame 

Shortcut: E 


With a number of strips selected, pressing E lets you 
interactively extend the strips. This is similar to moving but 
is useful for extending (or shortening) time around the 
current frame. 


All selected strip handles to the “mouse side” of the current 
frame indicator will transform together, so you can change 
the duration of strips at the current frame. 


Hint 


Extend is a convenient way to adjust the time of rough 
edits such as an “animatic” (Sequential storyboards). 
Where it’s possible to select everything and adjust the 
length of strips around the current frame. This can be 


especially useful when adding in audio or other elements 
that could cause the timing to need adjustment. 


When performing this operation you may want to enable 
Markers >» Sync Markers so markers are updated too. 


This simply a convenience operation, instead of manually 
selecting strips on one side of the current frame, as well as 
handles on one side of overlapping strips. Then selecting 
and transforming markers as well. This avoids the manual 
process, so re-timing can be accessed quickly. 


Slip Strip Contents 


Reference 
Menu: Strip » Transform » Slip Strip Contents 
Shortcut: S 


The Slip tool allows you to change the position of the 
contents of a strip without moving the strip itself. 


Snap Strips to the Current Frame 


Reference 

Menu: Strip » Transform » Snap Strips to the 
Current Frame 

Shortcut: Shift-S 


Moves the strip or control point to the current frame. 


Clear Strips Offset 


Reference 


Menu: Strip > Transform » Clear Strips Offset 
Shortcut: Alt-0 


To reset the (soft) start/end frame handles. 
Swap Strips 

Reference 

Menu: Strip » Transform >» Swap Strips 


Left Alt-Left 
Swaps the active strip with the strip to the left. 


Right Alt-Right 
Swaps the active strip with the strip to the right. 


Remove Gaps 


Reference 
Menu: Strip » Transform > Insert Gaps 
Shortcut: Backspace 


Remove blank frames between the current frame and the 
first strip to the left, independent of selection or locked state 
of strips. 


All Gaps 
Remove gaps to the right of the strip along with the left. 


Insert Gaps 


Reference 


Menu: Strip » Transform >» Insert Gaps 
Shortcut: Shift-Equals 


Insert blank frames between the current frame and the first 
Strips to the right, independent of selection or locked state 
of strips. 


Image Transform 
Scale to Fit 


Reference 


Menu: Strip » Image Transform » Scale to Fit 


Adjusts the strips Scale Transforms so the visual contents of 
the strip to fit exactly within the project’s Resolution while 
maintaining the original aspect ratio. 


This may mean that the transparent areas may be added 
along the content’s border to fit the content in the rendered 
area. 


Scale to Fill 
Reference 
Menu: Strip » Image Transform » Scale to Fill 


Adjusts the strips Scale Transforms so the visual contents of 
the strip to span the project’s Resolution while maintaining 


the original aspect ratio. 


This may mean that portions of the original image no longer 
fit the content inside the rendered area. 


Stretch to Fill 

Reference 

Menu: Strip » Image Transform » Stretch to Fill 
Adjusts the strips Scale Transforms so the visual contents of 
the strip to fill the project’s Resolution. Note, unlike the 


other two methods described above, Stretch to Fill does not 
maintaining the original aspect ratio. 


This may mean that the original image becomes distorted to 
fit the content inside the rendered area. 


Clear Position 
Reference 
Menu: Strip » Image Transform » Clear Position 


Resets the strips Position Transforms to a value of zero. 


Clear Scale 


Reference 


Menu: Strip » Image Transform » Clear Scale 


Resets the strips Scale Transforms to a value of one. 


Clear Rotation 


Reference 


Menu: Strip » Image Transform >» Clear Rotation 


Resets the strips Rotation Transform to a value of zero. 
Clear All 


Reference 


Menu: Strip » Image Transform » Clear All 


Resets the strips position, scale, and rotation Transforms to 
their default values. 


Split 


Reference 


Menu: Strip > Split 
Shortcut: K 


This splits the selected strip in two at the current frame. 
This will result in two strips which use the same source, 
fitting the original strip’s timing and length. 


Hint 


This can be thought of as a quick way to duplicate the 
current strip, adjusting the start/end frames to form two 


non-overlapping strips showing the same content as 
before. 


Hold Split 


Reference 
Menu: Strip » Hold Split 
Shortcut: Shift-K 


Like Split, it splits a strip in two distinct strips; however you 
will not be able to drag the endpoints to show the frames 
past the split of each resulting strip. 


Although you can adjust the Hold Offset number fields in the 
Strip Info panel. 


Hint 


This can be thought of as a way to simulate splitting the 
video file in two parts at the cut-point, replacing the 


Current strip with each. 


Duplicate Strips 


Reference 


Menu: Strip » Duplicate Strips 
Shortcut: Shift-D 


Duplicate a strip to make an unlinked copy; drag it to a time 
and channel, and drop it by LmB click. 


Delete 

Reference 

Menu: Strip » Delete 
Shortcut: Delete, X 


Delete the selected strip(s). 


Delete Data 
After removing the Strip, delete the associated data also. 


Separate Images 


Reference 
Menu: Strip » Separate Images 
Shortcut: Y 


For images sequence only - Converts the strip into multiple 
strips, one strip for each frame. Useful for slide shows and 
other cases where you want to bring in a set on non- 
continuous images. 


Length 


You have to specify the duration you want the resulting 
Strips will be. 


Movie Strip 


Set Render Size 
Reference 
Menu: Strip » Set Render Size 


Sets the render resolution and aspect to match the strip’s 
resolution. 


Deinterlace Movies 


Reference 


Menu: Strip » Deinterlace Movies 


Converts interlaced video into progressive video. 


Effect Strip 
Change Effect Input 


Reference 


Menu: Strip > Effect Strip » Change Effect Type 


Swaps which strips are the input for the effect strip. 


Change Effect Type 


Reference 


Menu: Strip > Effect Strip » Change Effect Type 


Switch the effects on a selected Effect strip. 


Reassign Inputs 


Reference 
Menu: Strip > Effect Strip » Reassign Inputs 
Shortcut: R 


This tool can be used to assign (reconnect) effect strips ina 
different way. Select three arbitrary strips and press R. If you 
don’t create a cycle, those will be connected to a new effect 
chain. 


Swap Inputs 


Reference 
Menu: Strip > Effect Strip » Swap Inputs 
Shortcut: Alt-S 


Swaps the first two inputs for the effect strip. 


Lock/Unlock 


Lock Strips Ctrl-H 
Disables the strip from being transformed. 


Unlock Strips Ctrl-Alt-H 
Enables disabled strips allowing them to be transformed. 


Mute/Unmute 


Mute/Unmute Strips H, Alt-H 
Mute or unmute the selected strips. 


Mute/Unmute Deselected Strips Shift-H, Shift-Alt-H 
Mute or unmute all strips but the selected. 


Inputs 


Reload Strips Alt-R 
Reloads the strips from their external saved location. 


Reload Strips and Adjust Length Shift-Alt-R 
Reloads the strips from their external saved location and 
re-adjusts the strip duration. 


Change Path/Files 
Changes the source file contained in a selected strip. 


Swap Data 
Swaps two sequence strips. 


Change 


Reference 


Shortcut: C 


Change Scene 
Change the scene assigned to the selected strip. 


Context Menu 


You can activate context menu by clicking RMB in the 


Sequencer’s timeline. In this menu you can quickly access 


some commonly used tools. 


Fades 


Reference 


Menu: Add >» Fades 


This submenu contains tools to add or remove fades to 
Strips. In case of visual strips the tools will animate the 
Opacity or volume in case of audio strips. 


Clear Fades 
Removes fade animation from selected sequences. 


Fade In and Out 
Fade selected strips in and out. 


Fade In 
Fade in selected strips. 


Fade Out 
Fade out selected strips. 


From Current Frame 
Fade from the current frame to the end of overlapping 
sequences. 


To Current Frame 


Fade from the start of sequences under the Playhead to 


the current frame. 


Overlap Mode 


Overlap Mode defines the result of transforming a strip so 
that it overlaps another strip. 


Shuffle 
The overlapping strip will be moved to the nearest free 
space so that it does not overlap. 


Overwrite 
The overlapped strip will be overwritten, trimmed or split 
by the overlapping strip. 


Expand 
All strips on the right side of (each) transformed will be 
shifted forward to accommodate the overlapping strip. 


Snapping 


It is possible to enable snapping in the header of the VSE. 
The snapping behavior can be configured as follows: 


Snap to 
Current Frame 
Snaps the transformed selection to the Playhead. 


Hold Offset 
Snaps the transformed selection to the Hold Offset. 


Ignore 
Muted Strips 
Muted Strips are not considered as snap targets. 


Sound Strips 
Sound Strips are not considered as snap targets. 


Current Frame 
Snap to Strips 


Snaps the Playhead to all strips. 


Meta Strips 


A Meta Strip is a strip which contain multiple strips treated 
as if it was one Strip. It allows you to reduce the vertical 
space used in the Sequencer. You can edit it the same way 
as any other strips. 


It is organization tool. For example, if you are using a lot of 
strips with complicated arrangement, you can group them 
together using Meta strips. 


Make Meta Strip ctrl-G 
To create a Meta strip, select all the strips you want to 
group, and ctri-G to group them. The Meta strips will 
span from the beginning of the first strip to the end of 
the last one, and condenses all channels into a single 
Strip. 


UnMeta Strip ctri-Alt-G 
Separating (ungrouping) the Meta strip restores the strips 
to their relative positions and channels. This can be used 
if you choose to delete a Meta strip and want to keep the 
Strips inside. 


MetaStrip | 153 


Example of Meta strips. 


You can edit the content inside a Meta strip by pressing Tab. 
It will expand the strip to the whole view and hide any other 
Strips. To exit the Meta strip press Tab again. Meta strips can 
also be nested, which make editing them a little confusing. 
To exit out one level of Meta Strip make sure you do not 
have a Meta strips selected when you press Tab. 


Note 


The default blend mode for a Meta strip is Replace. There 
are many cases where this alters the results of the 


animation so be sure to check the results and adjust the 
blend mode if necessary. 


One convenient use for Meta strips is when you want to 
apply the same effect to multiple strips. For example: if you 
have a video that was recorded in different files and want to 
add an effect strip. It is much more convenient to apply a 


single set of effects to one Meta strip than applying it to 
each individual strip. 


See also 


It is also possible to do the similar task described above 
with an Adjustment Layer effect strip. 
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o Scalable Vector Graphics (SVG) as Grease Pencil 
o Portable Document Format (PDF) as Grease Pencil 


Introduction 


Each blend-file contains a database. This database contains 
all scenes, objects, meshes, textures, etc. that are in the 
file. 


A file can contain multiple Scenes and each scene can 
contain multiple Objects. Objects can contain multiple 
materials which can contain many textures. It is also 
possible to create links between different objects, or share 
data between objects. A file can link data from other 
Blender files. 


Outliner 


You can easily inspect the contents of your file by using the 
Outliner editor, which displays all of the data in your blend- 
file. 


The Outliner allows you to do simple operations on objects, 
such as selecting, renaming, deleting, linking and parenting. 


Read more about the Outliner. 


Blen 


der File 


Opening & Saving 
o Opening Files 

Open Recent 

o Recover 

o Saving Files 

o Save As 
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Save Copy 
Relative Paths 


Packed Data 


o Pack Data 

o Unpack Data 

o Pack Linked Libraries 

o Unpack Linked Libraries 


Blend-Files Previews 


o Blend-File Preview 
o Data-Blocks Previews 


Rename 


o Rename Active Item 
o Batch Rename 


Opening & Saving 


Opening and saving blend-files is usually done using the File 
Browser. 


Tip 

Blend-files can also be opened by dragging and dropping 
blend-files into the Blender window. This method also 
allows to link/append the file. 

Note 

Unsaved Changes 

By default, when exiting Blender or loading a new blend- 
file, if you have unsaved changes, a pop-up will ask you to 


either confirm discarding those changes, or save them. 


This behavior can be disabled with the Save Prompt option 
in the Save & Load section of the Preferences. 


Opening Files 


Reference 
Menu: File » Open... 
Shortcut: Ctrl-0 


The upper text field displays the current directory path, and 
the lower text field contains the selected filename. 
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Trusted Source 


The File Browser in open configuration. 
Options 


Load UI 


When enabled, the screen layout saved inside each 
blend-file is used, replacing the current layout and 
Workspaces. Otherwise the file screen layout is ignored. 


Tip 
If you want to work on a blend-file using your own 


defaults, start a fresh Blender, open the File Browser 


and turn off the Load U/ button, and open the desired 
file. 


Trusted Source 


When enabled, Python scripts and drivers that may be 

included in the file will be run automatically. Enable this 
only if you created the file yourself, or you trust that the 
person who gave it to you did not include any malicious 


code with it. See Python Security to configure default 
trust options. 


Open Recent 


Reference 
Menu: File » Open Recent 
Shortcut: Shift-Ctrl-0 


Lists recently used files. Click on one to load it in. 


Recover 
Last Session 


Reference 


Menu: File » Recover > Last Session 


This will load the quit.blend file Blender automatically saved 
just before exiting. This option enables you to recover your 
last work session if, for example, you closed Blender by 
accident. 


Auto Save 


Reference 


Menu: File » Recover > Auto Save 


This will allow you to open an automatically saved file to 


recover it. 


See also 


Auto Save 


Saving Files 


Reference 
Menu: File >» Save 
Shortcut: Ctrl-S 


Save current blend-file over itself (if it was not saved yet, 


this will automatically switch to Save As...). 
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Save Copy 


The File Browser in save configuration. 


Save As Blender File 


Cancel 


Save As 


Reference 
Menu: File > Save AS... 
Shortcut: Shift-Ctrl-S 


Choose a file path to save the blend-file to. 
Warning 


If a file with the same given name already exists, the text 
field will turn red as a warning that the file will be 
overwritten. 


Tip 


Use the p/us or minus buttons to the right of the file name, 
Or NumpadPlus, NumpadMinus to increase/decrease a number at 
the end of the file name (e.g. changing file _01.blend to 
file 02.blend). 


Options 


Compress 


Reduces the file size of the resulting blend-file but takes 
longer to save and load. This option is useful for 
distributing files online and saving drive space for large 
projects. But it can cause slowdowns when quitting 
Blender, or under normal operation when auto-saving 


backup files. See Compression & Memory Use for more 
information. 


Hint 

The used compression algorithm is Zstandard. It is not 
unique to Blender so files can be 
compressed/decrompressed with external tools. 


Changed in version 3.0: Prior to this version, the 
compression algorithm used was Gzip. This means to 
open newer blend-files in versions prior to 3.0, blend-files 
must first be saved without compression in a newer 
version of Blender or decompressed using an external 
Gzip tool. 


Remap Relative 
This option remaps Relative Paths (such as linked 
libraries and images) when saving a file in a new 
location. 


Save Copy 
Saves a copy of the actual working state but does not 
make the saved file active. 


Save Copy 


Reference 


Menu: File » Save Copy... 


Choose a file path to save the blend-file to, but return to 
editing the original file upon completion. This can be used to 
save backups of the current working state without modifying 
the original file. 


For options see Save As. 


Relative Paths 


Many blend-files reference external images or other linked 
blend-files. A path tells Blender where to look for these files. 
If the external files are moved, the blend-file that references 
them will not look right. 


When you specify one of these external files, the default 
option is to make the path relative. Blender stores a partial 
path evaluated relative to the directory location of the 
referencing blend-file. This choice helps when you need to 
reorganize folders or move your files. 


With a relative path, you can move the blend-file to a new 
location provided the externally linked files are moved along 
with it. For example, you could send someone a folder that 
contains a blend-file and a subfolder of external images that 
it references. 


When relative paths are supported, the File Browser 
provides a Relative Path checkbox, when entering the path 
into a text field, use a double slash prefix (//) to make it so. 


Relative paths are the default but this can be changed in the 
File tab of the Preferences. 


Note 

You cannot use relative paths into a new untitled blend-file. 
Save it before linking to external files. 

Hint 


If it is necessary to relocate a blend-file relative to its 
linked resources, use Blender’s File Save As function which 


has an option to Remap Relative file links. 


Packed Data 


Blender has the ability to encapsulate (incorporate) various 
kinds of data within the blend-file that is normally saved 
outside of the blend-file. For example, an image texture that 
is an external image file can be put “inside” the blend-file. 
This allows sharing a full project as a single file, instead of 
e.g. an archive containing the blend-file and all its 
dependencies. 


You know that a data is packed when you see a little “gift 
box” icon displayed next to its path. 


Warning 
Not all external files can be packed 


Some typically heavy external files, like videos from the 
Sequence Editor or Movie Clips, cannot be packed ina 
blend-file. 


Pack Data 
Pack Resources 
Reference 


Panel: File » External Data >» Pack Resources 


Mark all eligible external resource files used by the blend- 
file as packed. Actual packing will happen on the next save 


of the blend-file. 
Automatically Pack Resources 


Reference 


Panel: File » External Data >» Automatically Pack 
Resources 


When enabled, this option will ensure that all eligible 
external resource files, existing or added later, are 
systematically marked as packed. As with Pack Resources, 
the blend-file must be saved to the drive for this to have an 
effect. 


Disabling that option won’t unpack anything, but future 
external files won’t be automatically marked as packed 
anymore. 


Selective Packing 


A single file can be packed by clicking on the little “gift box” 
icon to the left of its file-path Ul widget. 


Unpack Data 


Unpack Resources 


Reference 


Panel: File » External Data » Unpack Resources 


Unpack all external resource files stored into a blend-file. 


Options 


Use files in current directory (create when necessary) 
Unpacks all files in the same directory // as the blend- 
file, grouping them in proper folders (like ‘’textures’’ for 
instance). However, if the final file exists already, it will 
use that file, instead of unpacking it. 


Write files to current directory (overwrite existing files) 
As with previous option, but if the final file exists already, 
it will overwrite it. 


Use files in original location (create when necessary) 
Unpacks all files in their original location. However, if the 
final file exists already, it will use that file, instead of 
unpacking it. 


Write files to original location (overwrite existing files) 
As with previous option, but if the final file exists already, 
it will overwrite it. 


Disable AutoPack, keep all packed files 
Only deactivates the Automatically Pack Resources 
option. 


Selective Unpacking 


A single file can be unpacked by clicking on the little “gift 
box” icon to the left of its file-path UI widget. 


Options 
Remove Pack 


Just mark the file as unpacked, without actually writing it 
or reloading it from the drive. 


Create <local file path> 


Unpack the file at the proposed path, which is local to the 
current blend-file. 


Use <original file path> (differs) |(identical) 
If the original file path still exists, mark it as unpacked. 
Note that it won’t be automatically reloaded from the 
drive. (differs) or (identical) show difference status 
between the packed version and the one on-drive. 


Overwrite <original file path> 
If the original file path still exists but differs from the 
packed version, mark it as unpacked and overwrite the 
on-drive file with the packed version. 


Create <original file path> 


If the original file path does not exist, mark it as 
unpacked and write it to drive. 


Pack Linked Libraries 


Reference 


Panel: File » External Data >» Pack Linked 
Libraries 


Mark all linked library files in the current blend-file as 
packed. Actual packing will happen on the next save of the 
blend-file. 


Unpack Linked Libraries 


Reference 


Panel: File » External Data » Unpack Linked 
Libraries 


Unpack all used linked library files from this blend-file. 


Blend-Files Previews 


A blend-file can store previews, both for itself, and for some 
of its data-blocks. You can disable writing any previews 
when saving a blend-file using the Save Preview Images 
setting from the Save & Load section of the Preferences. 


Blend-File Preview 


Blender saves by default a small preview of current scene in 
the blend-file. This will show in the Thumbnail view of the 
File Browser. 


During its installation, Blender also adds a small tool to your 
OS, that will allow your system file browser to show those 
previews as file thumbnails as well. 


Data-Blocks Previews 


Blender will automatically generate previews for some type 
of data, mainly the ones related to shading (like images, 
textures, materials, lights and world shaders). 


It can also store previews for scenes, collections and 
objects, but those need to be generated manually. 


These previews can then be used by the Thumbnail view of 
the File Browser, when linking or appending data-blocks. 


Refresh Data-Block Previews 


Reference 


Menu: File » Data Previews » Refresh Data- 
blocks Previews 


Refresh all data-block previews that can be automatically 
generated by Blender (shading-related ones), in the current 
blend-file. You still need to save the file if you want to write 
them to the drive. 


Batch Generate Previews 


Reference 


Menu: File » Data Previews >» Batch Generate 
Previews 


Generate some data-block types’ previews (you can choose 
which in its options), in one or more blend-files on your 
drive. You should not use this operator on the file currently 
opened in Blender. 


This is currently the only way to generate and store in 
blend-files previews for scenes, collections and objects. Note 
that since this involves a lot of rendering, even of small 
sizes, the process may take some time to complete. 


Scenes 
Generate previews of scenes and their collections. 


Collections 
Generate previews of collections of objects. 


Objects 
Generate previews of objects. 


Materials & Textures 
Generates previews for materials, textures, images, and 
other internal data. 


Trusted Blend Files 
When enabled, Python scripts and drivers that may be 
included in the file will be run automatically. Enable this 
only if you created the file yourself, or you trust that the 
person who gave it to you did not include any malicious 
code with it. See Python Security to configure default 
trust options. 


Save Backups 
Keep a backup version (blend1-file) of the files when 
saving with generated previews. 


Clear Data-Block Previews 


Reference 


Menu: File » Data Previews » Clear Data-blocks 
Previews 


Clear all, a generic type of, or a specific data-block type of 
previews in the current blend-file. You still need to save the 
file if you want to clear them from the drive. 


Batch Clear Previews 


Reference 


Menu: File » Data Previews » Batch Clear 
Previews 


Clear some data-block types’ previews (you can choose 
which in its options), in one or more blend-files on your 
drive. You should not use this operator on the file currently 
opened in Blender. 


Scenes 
Generate previews of scenes and their collections. 


Collections 
Generate previews of collections of objects. 


Objects 
Generate previews of objects. 


Materials & Textures 
Generates previews for materials, textures, images, and 
other internal data. 


Trusted Blend Files 
When enabled, Python scripts and drivers that may be 
included in the file will be run automatically. Enable this 
only if you created the file yourself, or you trust that the 
person who gave it to you did not include any malicious 
code with it. See Python Security to configure default 
trust options. 


Save Backups 
Keep a backup version (blend1-file) of the files when 
saving with generated previews. 


Rename 


Rename Active Item 


Reference 
Menu: Edit » Rename Active Item 
Shortcut: F2 


The Rename Active Item operator renames the active Bone, 
Node, Object and Sequence Strip. 


When the operator is executed, a pop-up dialog appears. 
The text field shows the name of the current item and can 
be overwritten to rename the item. Return confirms the 
name while Esc cancels the operator. 


Batch Rename 


Reference 
Menu: Edit » Batch Rename 
Shortcut: Ctrl-F2 


The Batch Rename operator can rename many data-block 
names at once. This uses a pop-up dialog with operations 
and their options to change the name. These actions are 
applied in order, from first to last. 


Data Source 


Where to look for the data-blocks that are intended to be 
renamed. 


Selected: Operates on the currently selected 
objects. 
All: Operates on all data in the blend file. 
Data Type 


The data-block type to perform the batch rename 
operations on. 


Operations 


The Batch Rename has several sub Operations to change 
the data names. The default operation is Find/Replace 
however, other operations can be added to change the data 
names further. Below all the operations gives a message in 
the status bar on how many data-blocks were renamed. 


Find/Replace 


Find/Replace searches for a particular text in the names and 
optionally replaces it with a new text. Regular Expressions 
can be used as a powerful way to tailor the Find/Replace 
texts and can be enabled using the icon to the right of the 
text fields. 


Find 
The text to search for in names. 


Replace 
The text to replace for in matching names found from the 
Find text. 


Case Sensitive 


Search results must exactly match the case of the Find 
text. 


Set Name 
Set Name works the most similar to Rename Active Item by 


renaming the current data-block without having to do a find 
and replace operation. 


Method 
New: Disregards the current name replacing 
it with the “new” name. 
Prefix: Adds text to the beginning of the 


current name. This is useful for tools 
that look for special text in the prefix of 
a data-block name. 

Suffix: Adds text to the end of the current 
name. This is useful for tools that look 
for special text in the suffix of a data- 
block name. 


Name 
Defines the new name or the text to add asa 
prefix/suffix. 


Strip Characters 


Strip Characters cleans up names by removing certain 
character types from either the beginning or the end of the 
name. 


Characters 
Spaces: Strips any space characters from the 
name, e.g. “Living Room ” becomes 
“Living Room”. 
Digits: 


Strips any numerical characters from 
the name, @€.g. cube.001 becomes cube.. 

Punctuation: = Strips any punctuation characters 
(,.?!:; etc.) from the name, e.g. cube? 
becomes cube. 


Tip 


Multiple character types can be removed at once by 
Shift-LMB on the types. 


Strip From 
Start: Strips any leading characters in the 
name. 
End: Strips any trailing characters in the 
name. 


Change Case 


Change Case modifies the case of names to be one of the 
following: 


Convert To 
Upper Case 
Changes all text to be in upper case, e.g. cube.001 
becomes CUBE.001. 


Lower Case 
Changes all text to be in lower case, e@.g. CUBE.001 
becomes cube.001. 


Title Caps 
Changes all text to be in title case, €.g. living room 
becomes Living Room. 


Data-Blocks 


The base unit for any Blender project is the data-block. 
Examples of data-blocks include: meshes, objects, 
materials, textures, node trees, scenes, texts, brushes, and 
even Workspaces. 


A data-block is a generic 
abstraction of very 
different kinds of data, ve 
which features a common tas Sequence 
set of basic features, ene 
properties and behaviors. eS be 


vy Orphan Data 


Some common 
characteristics: 


¥ Current File 

e They are the primary a 
contents of the . 
blend-file. 
They can reference 
each other, for reuse 
and instancing. 
(Child/parent, 
object/object-data, 
materials/images, in 
modifiers or 
constraints too...) 
e Their names are 

unique within a 


blend-file, fora given Blender File view of the Outliner. 
type. 

e They can be 
added/removed/edite 


d/duplicated. 

e They can be linked between files (only enabled fora 
limited set of data-blocks). 

e They can have their own animation data. 

e They can have Custom Properties. 


User will typically interact with the higher level data types 

(objects, meshes, etc.). When doing more complex projects, 
managing data-blocks becomes more important, especially 
when inter-linking blend-files. The main editor for that is the 


Outliner. 


Not all data in Blender is a data-block, bones, sequence 
strips or vertex groups e.g. are not, they belong to 


armature, scene and mesh types respectively. 


Data-Block Types 


For reference, here is a 
table of data-blocks 


© Material CS Workspace 
types stored in blend- © Mask © word 
files. ff Lattice PF) Window Manager 
@ Line Style Fed Texture 
Link & Library Text 


Library Linking, 
supports being linked 
into other blend-files. 


Pack 
File Packing, Supports 
file contents being 
packed into the 
blend-file (not 
applicable for most 
data-blocks which 


© Light 

@ key 

fa’ Image 

(J Collection 
s Grease Pencil 
Qa Font 

o Curve 


(_] Cache File 


© Camera 
By Brush 


- 
“Ve Armature 


(el Speaker 
Ja Sound 

ro) Scene 
Light Probe 
*< Particle 
Bf Palette 
Paint Curve 
@) Object 

Ly Node Tree 
++ Movie Clip 
VW Mesh 


C? Metaball 


have no file 


reference). 
Type Link 
Action J 
Armature Vv 
Brush v 
Camera J 
Cache File Vv 
Curve v 
Font v 


Data-blocks types with their icon. 


Pack Description 


Stores animation F-Curves. 
Used as data-block animation 
data, 

and the Nonlinear Animation 
editor. 


Skeleton used to deform meshes. 
Used as data of armature objects, 
and by the Armature Modifier. 


Used by paint tools. 


Used as data by camera objects. 


Used by Mesh Cache modifiers. 


Used as data by curve, font & 
surface objects. 


References font files. 
Used by curve object-data of text 
objects. 


Type 


Grease 


Pencil 


Collection 


Link 


Pack Description 


2D/3D sketch data used by 
Grease Pencil objects. 

Used as overlay helper info, by 
the 

3D Viewport, Image, Sequencer & 
Movie Clip editors. 


Group and organize objects in 
scenes. 

Used to instance objects, and in 
library linking. 


Image files. 
Used by shader nodes and 
textures. 


Geometry shape storage, which 
can be animated. 

Used by mesh, curve, and lattice 
objects. 


Used as object data by light 
objects. 


Type 


Library 


Line Style 


Material 


Metaball 


= 
O 
W 
= 


Link 


Pack Description 


References to an external blend- 
file. 

Access from the Outliner’s 
Blender File view. 


Used by the Freestyle renderer. 


Grid based lattice deformation. 
Used as data of lattice objects, 
and by the Lattice Modifier. 


2D animated mask curves. 
Used by compositing nodes & 
sequencer strip. 


Set shading and texturing render 
properties. 

Used by objects, meshes & 
curves. 


An isosurface in 3D space. 
Used as data of metaball objects. 


Geometry made of 
vertices/edges/faces. 
Used as data of mesh objects. 


Type Link Pack Description 


Reference to an image sequence 
Movie Clip v x or video file. 
Used in the Movie Clip editor. 


Groups of re-usable nodes. 


Node ree ¥ =~ Used in the node editors. 


An entity in the scene with 
location, 


Object v -_ ; 
scale, rotation. 
Used by scenes & collections. 
Paint J = Stores a paint or sculpt stroke. 
Curve Access from the paint tools. 
Store color presets. 
Palette 7 Access from the paint tools. 
: Particle settings. 
7 = ; 
Particle Used by particle systems. 
Light y _ Help achieve complex real-time 


robe lighting in Eevee. 


Type 


Scene 


Sounds 


Speaker 


Texture 


Link 


Pack Description 


Primary store of all data displayed 
and animated. 

Used as top-level storage for 
objects & animation. 


Reference to sound files. 
Used as data of speaker objects. 


Sound sources for a 3D scene. 
Used as data of speaker object. 


Text data. 
Used by Python scripts and OSL 
shaders. 


2D/3D textures. 
Used by brushes and modifiers. 


The overarching manager for all 
of Blender’s user interface. 
Includes Workspaces, notification 
system, operators, and keymaps. 


Define global render environment 
settings. 


Type Link Pack Description 


UI layout. 
Workspace X — Used by each window, which has 
its own workspace. 


Life Time 


Every data-block has its usage counted (reference count), 
when there is more than one, you can see the number of 
current users of a data-block to the right of its name in the 
interface. Blender follows the general rule that unused data 
is eventually removed. 


Since it is common to add and remove a lot of data while 
working, this has the advantage of not having to manually 
manage every single data-block. This works by skipping 
zero user data-blocks when writing blend-files. 


Protected 


Since zero user data-blocks are not saved, there are times 
when you want to force the data to be kept irrespective of 
its users. 


If you are building a blend-file to serve as a library of assets 
that you intend to link to and from other files, you will need 
to make sure that they do not accidentally get deleted from 
the library file. 


To protect a data-block, use the button with the shield icon 
next to its name. The data-block will then never be silently 


deleted by Blender, but you can still manually remove it if 
needed. 


Sharing 


Data-blocks can be shared among other data-blocks. 
Examples where sharing data is common: 


e Sharing textures among materials. 

e Sharing meshes between objects (instances). 

e Sharing animated actions between objects, for example 
to make all the lights dim together. 


You can also share data-blocks between files, see linked 
libraries. 


Making Single User 


When a data-block is shared between several users, you can 
make a copy of it for a given user. To do so, click on the user 
count button to the right of its name. This will duplicate that 
data-block and assign the newly created copy to that usage 
only. 


Note 


Objects have a set of more advanced actions to become 
single-user, see their documentation. 


Removing Data-Blocks 


As covered in Life Time, data-blocks are typically removed 
when they are no longer used. They can also be manually 
unlinked or deleted. 


Unlinking a data-block means that its user won’t use it 
anymore. This can be achieved by clicking on the “X” icon 
next to a data-block’s name. If you unlink a data-block from 
all of its users, it will eventually be deleted by Blender as 
described above (unless it is a protected one). 


Deleting a data-block directly erases it from the blend-file, 
automatically unlinking it from all of its users. This can be 
achieved by Shift-LMB on the “X” icon next to its name. 


Warning 


Deleting some data-blocks can lead to deletion of some of 
its users, which would become invalid without them. The 
main example is that object-data deletion (like mesh, 
curve, camera...) will also delete all objects using it. 


Those two operations are also available in the context menu 
when prmB-clicking on a data-block in the Outliner. 


Custom Properties 


Custom properties are a way to |SSSeiieesees 
store your own data in Add 
Blender’s data-blocks. It can be 
used for rigging (where bones 
and objects can have custom ae en 
properties driving other 


properties), and Python scripts, Custom Properties panel. 
where it’s common to define 


float property 1.000 


new settings not available in 
Blender. It is also possible to access custom properties from 
materials via the Attribute Node. 


Only certain data supports custom properties: 


e All data-blocks types. 
e Bones and pose bones. 


e Sequence strips. 


To add a custom property, search for the Custom Properties 
panel, found at the bottom of most Properties or Sidebar 
region, and click New. Properties can be removed from the 
same location with the delete icon. Once properties are 
added they can be configured via the edit icon to work for a 
particular use case; see Editing Properties for more 
information. 


Editing Properties 
User Interface 


Custom properties can be edited using the panel available 
for data types that support it. Editing the properties allows 
you to configure things such as default values, ranges, and 
even add a custom tooltip. 


Type 
The data type of the property; different data types have 
can only have specific data properties. 


A numeric value with decimals e.g. 
3.141, 5.0, or 6.125. 


Float: 
Float Array: 


Integer: 


Integer Array: 


String: 


Python: 


Note 


Custom Properties edit pop-up. 


A collection of multiple float data types 
e.g. [3.141, 5.0, 6.125] . This data type 
can also be used for data that can be 
represented as a float array such as 
colors. These special float arrays can 
be set in the Subtype selector. 

A numeric value without any decimals 
e.g. 1, 2, 3, or 4. 

A collection of multiple integer data 
types e.g. [1, 2, 3, 4]. 

A sequence of characters such as 
“Some Text”. 

Edit a Python data type directly, used 
for unsupported data types. 


Boolean values must be handled as integers and only 
work when using Min/Max values that are integers and 
that are no more than 1 apart. 


At this point, the Boolean values will still look like 
integers but behave like a Boolean having one lower, 
off, value and a higher, on, value. 


Array Length 
The number of elements in the array. Note that if the 
array length is greater than 7 you cannot directly edit its 
elements, you must press Edit Value to edit the elements 
of the array. 


Property Name 
The text that is displayed to the left of the value. This 
name is also used to access the property via Python. 


Default Value 
This sets the default value of the property used by the 
Reset to Default Value operator. 


Warning 


Default values are used as the basis of NLA blending, 
and a nonsensical default (e.g. 0 for a property used for 
scaling) on a property intended for being keyframed is 
likely to cause issues. 


Min, Max 
The minimum/maximum value the custom property can 
take. 


Library Overridable 


Allow the property to be overridden when the data-block 
is linked. 


Soft Limits 


Enables limits that the Property Value slider can be 
adjusted to without having to input the value numerically. 


Soft Min, Max 
The minimum/maximum value for the soft limit. 


Step 
A multiplier to control how much the data type is 
incremented at a time. The internal step size for floats is 
0.01, so a Step value of 5 will increment at a rate of 0.05 
and a Step value of 100 will increment by 1.0. For 
integers the internal step size is 1. 


Precision 


The number of digits after the decimal to display in the 
user interface for float data types. 


Subtype 
Specifies the type of data the property contains, which 
affects how it appears in the user interface. In order for 
this property to appear the Property Value must be a 
vector of floats. For either of the color subtypes to work 
the Property Value must be a vector with three or four 
values depending on the availability of an Aloha Channel. 


Plane Data: Data values do not have any special 
behavior. 
Linear Color: — Color in linear color space. 
Gamma-Corrected Color: 
Color in gamma corrected color space. 
Euler Angles: = Euler Rotation angles. 
Quaternion Angles: 


Quaternion Rotation angles. 


Description 
Allows you to write a custom Tooltip for your property. 


Python Access 


Custom properties can be accessed in a similar way to 
dictionaries, with the constraints that keys can only be 
strings, and values can only be strings, numbers, arrays of 
such, or nested properties. 


See the AP] documentation for details. 
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Link & Append 


These functions help you reuse materials, objects and other 
data-blocks loaded from another blend-file. You can build 
libraries of common content and share them across multiple 
referencing files. 


Newly added collections types are available in Add >» 
Collection Instance in the 3D Viewport. 


Look in the Outliner, with display mode set to Blender File, 
to see all your linked and appended data-blocks. 


Link 


Reference 

Editor: Topbar 
Mode: All Modes 
Menu: File > Link 


Link creates a reference to the data in the source file such 
that changes made there will be reflected in the referencing 
file the next time it is reloaded. But linked data is not 
editable (to some extent, see Proxies). 


In the File Browser, navigate to the external source blend- 
file and select the data-block you want to reuse. 


When you link an object, it will be placed in your scene at 
the 3D cursor position. Many other data types, cameras, 
curves, and materials for example, must be linked to an 
object before they become visible. 


Options 


Relative Path 
See Relative Paths. 


Select 
Makes the object Active after it is loaded. 


Active Collection 
The object will be added to the active collection of the 
active view layer. Otherwise, it will be added to a new 
collection in the active view layer. 


Instance Collections 
This option instantiates the linked collection as an object, 
adding it to the active scene. Otherwise, the linked 
collection is directly added to the active view layer. 


Instance Object Data 
Create instances for object data which are not referenced 
by any objects. 


Append 


Reference 

Editor: Topbar 
Mode: All Modes 
Menu: File > Link 


Append makes a full copy of the data into your blend-file, 
without keeping any reference to the original one. You can 
make further edits to your local copy of the data, but 
changes in the external source file will not be reflected in 
the referencing file. 


In the File Browser, navigate to the external source blend- 
file and select the data-block you want to reuse. 


Tip 


Blend-files can also be linked/appended by dragging and 
dropping blend-files into the Blender window. 


Note 


Appending data you already have linked will add 
objects/collections to the scene, but will keep them linked 
(and un-editable). 


This is done so existing relationships with linked data 
remain intact. 


Options 


Select 
Makes the object Active after it is loaded. 


Active Collection 
The object will be added to the active collection of the 
active view layer. Otherwise, it will be added to a new 
collection in the active view layer. 


Instance Collections 
This option instantiates the linked collection as an object, 
adding it to the active scene. Otherwise, the linked 
collection is directly added to the active view layer. 


Instance Object Data 


Create instances for object data which are not referenced 
by any objects. 


Fake User 
Defines the appended data-block as Protected. 


Localize All 
Appends also all indirectly linked data, instead of linking 
them. 


Library Reload & Relocate 


Reloading is useful if you changed something in the library 
blend-file and want to see those changes in your current 
blend-file without having to re-open it. You can reload and 
relocate a whole library from the context menu of the library 
items in the Outliner’s Blender File view, 


Relocating allows you to reload the library from a new file 
path. This can be used to either fix a broken linked library 
(e.g. because the library file was moved or renamed after 
linking from it), or to switch between different variations of a 
same set of data, in different library files. 


Broken Library 


While loading a blend-file, if Blender cannot find a library, it 
will create placeholder data-blocks to replace missing linked 
ones. That way, references to the missing data is not lost, 
and by relocating the missing library, the lost data can be 
automatically restored. 


Make Local 


Reference 


Editor: 3D Viewport 

Mode: Object Mode 

Menu: Object > Relations » Make Local... 
Reference 

Editor: Outliner 

Menu: Context menu » ID Data » Make Local 


Makes the selected or all external objects local to the 
current blend-file. Links to the original library file will be lost, 
but it will make those data-blocks fully editable, just like the 
ones directly created in that blend-file. 


Options 


The operation available from the Outliner’s context menu 
has no options, and only affects the selected data-block. 


The operation available from the 3D Viewport only directly 
affects selected objects, but it can also make local the 
objects’ dependencies: 


Type 
Optionally unlinks the object’s Object Data and Material 
Data. 


Selected Objects, + Object Data, + Materials, All (i.e. 
including all scenes) 


Known Limitations 


For the most part linking data will work as expected, 
however, there are some corner cases which are not 
Supported. 


Circular Dependencies 


In general, dependencies should not go in both directions. 
Attempting to link or append data which links back to the 
current file will likely result in missing links. 


Object Rigid Body Constraints 


When linking objects directly into a blend-file, the Rigid 
Body settings will not be linked in since they are associated 
with their scene’s world. As an alternative, you can link in 
the entire scene and set it as a Background Set. 


Compression & Memory Use 


Linking to blend-files with compression enabled may 
significantly increase memory usage while loading files. 


Reading data on demand isn’t supported with compression 
(this only impacts load time, once loaded there is no 
difference in memory use). 


Proxies 


Proxies were the historical way in Blender to allow some 
local editing of linked data-blocks. This was mostly aimed at 
character animation. 


They are now fully deprecated as of Blender 3.0, replaced 
by the new Library Overrides. 


Existing proxies in older blend-files will be converted to 
library overrides when opening it in Blender 3.2 and later. 


Library Overrides 


Library Overrides is a system designed to allow editing 
linked data, while keeping it in sync with the original library 
data. Most types of linked data-blocks can be overridden, 
and the properties of these overrides can then be edited. 
When the library data changes, unmodified properties of the 
overridden one will be updated accordingly. 


Note 


The old proxy system has been deprecated in Blender 3.0, 
and fully removed in Blender 3.2. Automatic conversion 
from proxies to library overrides happens when loading a 
blend-file, but results on complex characters are not 
guaranteed and may need manual fixes. 


Library overrides supports: 


e Multiple independent overrides of a same linked data 
(e.g. having the same character multiple times in the 
Same scene). 

e Adding new modifiers and constraints, anywhere in the 
stack. 

e Recursively chaining overrides (i.e. link and override 
overrides from another library file, etc.). 


Note 


There are known issues that have to be addressed. See 
Phabricator main task of the project, for more details. 


Warning 


While in most cases library overrides data is preserved 
accross a loss of reference linked data (if e.g. the library 
file becomes unavailable or is relocated), there are some 
exceptions. 


The main one is probably posed (but not animated) 
armature objects, when their Aramture obdata itself is not 
overridden. The Pose bones of an armature object are fully 
linked to the bones of its Armature obdata, if the later goes 
missing, the pose bones are definitively lost. 


Note 
Proper Collections Layout Matters 


For library overrides to work well, it is much better if all 
the collections needed by the character are children of the 
root (linked and instantiated) one, such that there is a 
clear hierarchy. Otherwise, some data may not be properly 
automatically overridden, and other operations may be 
less reliable. 


Override Hierarchies 


Hierarchy is a very important concept to understand when 
working with library overrides. In Blender, a real-life asset (a 
character, a prop, a set, etc.) is almost never made of a 
single data-block, but is rather a group of data-blocks with 
dependency relationships to each-other. E.g. a character will 
typically have an armature object, several geometry 


objects, rig-controllers objects, the object data for all of 
these objects, materials, textures, etc. 


These relationships can be represented as a tree, with a root 
data-block ‘linking-in’ all its dependencies, recursively. With 
library overrides, typically, the root of the hierarchy is also 
the data-block that is directly linked when importing the 
asset (usually a collection). 


This concept of hierarchy can also be seen as some sort of 
Super meta-data-block. It is critical wnen there are several 
overrides of the same linked data, since it allows to clearly 
identify a given data-block to one override, leaving no 
ambiguity to processes that affect the whole hierarchy (e.g. 
resyncing overrides with their linked data). It also allows to 
Share relationships between data-blocks of different 
hierarchies, like a parenting relationships between two 
different overrides of a same character. 


Resyncing Overrides 


The relationships between linked data-blocks can change, 
resulting in outdated overrides. When this happens, 
overrides need to be resynced to match the new structure of 
their hierarchy. Overrides are automatically resynced if 
needed on blend-files opening. However, it may be needed 
to resynced them manually sometimes, see Troubleshoot an 
Override Hierarchy. 


Tip 
Blender is also able to resync library overrides from 


external libraries, that are then linked into a working file. 
However, this is a costly process that needs to be fully 


redone every time the working file is loaded, since Blender 
cannot edit/modify the external library directly. 


So users linking overrides (or creating recursive overrides) 
should ensure that their library files are regularly updated, 
to avoid this overhead on file load (typically, opening and 
saving those library files should be enough to update 
them). 


Tip 


Auto resyncing can be disabled in the Experimental 
Preferences. 


Non-Editable Overrides 


For technical reasons (how relationships between data- 
blocks are stored), Blender needs to create overrides of a lot 
of data-blocks, even when only one or two of them actually 
needs to be edited by the user. To reduce the amount of 
information and risk of potential unwanted editing, most of 
these data-blocks are now marked as non-editable by 
default. This can be changed once the override has been 
created. 


Make an Override 


Reference 
Editor: 3D Viewport, Outliner, Properties 
Mode: Object Mode 


Menu: 


3D Viewport >» Header > Object > Library 
Override » Make Outliner » Context Menu 
> Library Override » Make ID Widget » 
Context Menu » Library Override » Make 

Shortcut: Shift-LMB on the ‘linked’/’overridden’ 
button of an ID Widget. 


Create overrides from the selected data-blocks. 


Blender automatically create overrides for all required data- 
blocks to ensure that valid override hierarchies are created. 


Only overrides created from selected items will be user- 
editable. 


Warning 


The support for the creation of library overrides from the 
ID Widget (mainly from within the Properties editor) is 
limited. While the most common usages should be 
supported, especially with Objects, meshes, etc., much 
remains to be implemented. 


Selected Items 


Depending on where from the override is created, there are 
several ways to ‘select’ items to be overridden and user- 
editable. 


Note 


This alSo applies to the other common operations (Reset 
and Clear). 


The Troubleshoot advanced operations only available from 
the Outliner always apply to a whole override hierarchy. 


3DView 


The selected objects will be considered as selected. 


When a selected object is a local Empty instantiating a 
linked collection, the following will happen: * The Empty 
object will be removed. * Its linked collection will be 
overridden, and that override will be instanced in the same 
collection in the current View Layer. * If the collection 
contains Armature objects, they will be user-editable. 
Otherwise, no created override will be defined as user- 
editable. 


Outliner 


The operation can be applied on either the selected items 
only, their content only, or both. 


Tip 

Using Selected & Content is an easy way to get all newly 
created overrides immediately user-editable. 

ID Widget 


Only the linked data-block in the ID Widget is considered as 
selected, and set as editable once overridden. 


Make Editable 


That same operation can also be used to make existing 
overrides user-editable, after they have been created, or 


cleared 


Reset an Override 


Reference 


Editor: 
Mode: 
Menu: 


3D Viewport, Outliner, Properties 

Object Mode 

3D Viewport >» Header > Object > Library 
Override » Reset Outliner » Context 
Menu » Library Override >» Reset ID 
Widget » Context Menu » Library 
Override » Reset 


Reset the selected overrides to their original values (from 
the linked reference data). Unlike with the Clear operation, 
the overrides remain fully editable, and are never deleted. 


Clear an Override 


Reference 


Editor: 
Mode: 
Menu: 


Shortcut: 


3D Viewport, Outliner, Properties 

Object Mode 

3D Viewport >» Header > Object > Library 
Override >» Clear Outliner » Context Menu 
>» Library Override >» Clear ID Widget > 
Context Menu » Library Override > Clear 
Shift-LMB on the ‘overridden’ button of an 
ID Widget. 


Reset the selected overrides to their original values, and if 
possible without breaking the existing hierarchy, delete 
them and replace them by their linked reference data. 
Otherwise, keep the overrides but mark them as non- 
editable. 


Edit an Override 


Essentially, an override is edited the same way as a regular 
local data-block. You can use operators on them, edit their 
properties from various editors, etc. There are some 
limitations however, most notably Edit Mode is not allowed 
for overrides. In most cases, aS soon as you edit a property, 
you can see that it’s overridden by its teal blue 
outline/background. 


You can also animate overrides, animated properties just 
replace/supersede overrides then. Note that you cannot 
override/edit an existing animation, you’ll have to create a 
new action. You can manually define or remove an override 
from the context menu of the relevant property. If an 
override is not editable, you have to make it editable first. 


Define Overrides 


Reference 

Editor: Any 

Mode: Object Mode 

Property: Context Menu » Define Overrides 


Context Menu > Define Override 


Mark a property to be overridden in the local blend file. For 
array properties all elements will be overridden. 


Define Single Override 


Reference 

Editor: Any 

Mode: Object Mode 

Property: Context Menu » Define Single Override 


Mark a property to be overridden in the local blend file. For 
array properties only the selected element will be 
overridden. 


Remove Overrides 


Reference 

Editor: Any 

Mode: Object Mode 

Property: Context Menu >» Remove Overrides 


Context Menu > Remove Override 


Remove the property from the overrides. The value of the 
linked in data-block will be used. For array properties all 
elements will be removed from the override. 


Remove Single Override 


Reference 
Editor: Any 
Mode: Object Mode 


Property: Context Menu » Remove Single Override 


Remove the property from the overrides. The value of the 
linked in data-block will be used. For array properties only 
the selected elements will be removed from the override. 


Troubleshoot an Override 
Hierarchy 


Reference 

Editor: Outliner 

Mode: Object Mode 

Outliner: Context Menu » Library override » 


Troubleshoot 


These operations are only available from the Outliner 


contextual menu. They can help fixing a broken override 
hierarchy. 


Resync 

Reference 

Editor: Outliner 

Mode: Object Mode 

Outliner: Context Menu » Library override » 


Troubleshoot » Resync 


The hierarchy of the linked data (the relationships between 
linked data-blocks) can change. Overrides need to be 
resynced to match the new hierarchy. This operator will 


resync the override to match the new hierarchy in the 
library. 


Warning 


While resyncing a library override it is possible that edited 
overrides get deleted if they are changed in the original 
library. If this is the case, a warning message will be 
displayed stating how many overrides were deleted, if the 
deletion is undesirable the resync can be undone before 
saving the blend-file. 


Note 
This Process is Automatic 


Usually, this operation happens automatically when 
blender detects it is needed, on file load, unless it is 
disabled in the Experimental Preferences. 


Resync Enforce 


Reference 

Editor: Outliner 

Mode: Object Mode 

Outliner: Context Menu » Library override » 


Troubleshoot » Resync Enforce 


In some cases, especially with older blend-files that were 
saved with ‘broken’ (non-hierarchy-matching) overrides, a 
regular resync itself cannot rebuild properly the override as 
expected (e.g. some objects might go missing). To solve this 
issue, this operator rebuilds the local override from its linked 
reference, as well as its hierarchy of dependencies, 
enforcing that hierarchy to match the linked data (i.e. 


ignoring existing overrides on data-blocks properties). This 
is similar to a regular resync, but is more forceful, 
aggressive, at the cost of a potential loss of some overrides 
on ID pointers properties. 


Delete 

Reference 

Editor: Outliner 

Mode: Object Mode 

Outliner: Context Menu » Library override » 


Troubleshoot >» Delete 


Remove the whole library override hierarchy, and replace all 
of these override data-blocks by their original linked data- 
blocks. This fully reverts the Make operation. 
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Introduction 


This section describes Blender’s asset library system. It was 
introduced in Blender 3.0, and will be improved and 
expanded over multiple upcoming releases. 


See also 


Asset Browser 
The main interface for organizing and using assets. 


Asset Catalogs 
For organizing assets. 


Pose Library 
Build on top of the Asset Browser. 


The following blog posts were written during the design 
and development of the Asset Browser. They are linked 
here for historical reasons, and to give some more context 
to the current design. 


e 2020-03: Asset Manager 
e 2021-06: Asset Browser Project Update 
e 2021-06: Asset Browser Workshop Outcomes 


What is an Asset? 


An asset is a data-block with meaning. 


A blend-file is a database with multiple Data-Blocks: objects, 
textures, materials, etc. When planning to re-use or share 


these, the data needs a meaning. What is this? What is this 
for? Assets are curated data-blocks that are meant for 
easy reuse. 


Note 


The general term “asset” often also refers to other file 
types, such as images, sounds, video files, etc. These are 
currently not supported as asset in Blender. 


For more info, see Future Development. 


What its an Asset Library? 


An asset library is a directory on your drive that is registered 
in the Preferences as an asset library. Registering it means 
that you give the library a name (like “Sprite Fright”) and 
the location on drive (like /home/sybren/projects/sprite- 
fright/assets). 


Y Asset Libraries 


Name Path 


User Library /home/sybren/Documents/Blender/Assets a 
a_ 
[means 


Simon's Materials /home/sybren/syncthi...ndles/simon-materials/ 


Name and Location of asset libraries in the 
Preferences. 


Once registered, you can select the asset library in the 
Asset Browser. All the blend-files in the asset library will be 


scanned for assets, and all those assets will be shown in the 
Asset Browser. 


Note 


Loading an asset library for the first time may take a while, 
but the next time it is loaded should be significantly faster. 
Blender generates an index of all assets contained inside 
an asset library, and keeps it up-to-date as files are 
modified within it. The indices are stored in the Local 


Cache Directory. 


The blend-files can be directly in the top-level directory of 
the asset library, or in any subdirectory. The on-drive 
organization of asset libraries is all up to you. Regardless of 
which blend-file contains the assets, each asset can be 
assigned a catalog. For more info about how to organize 
your assets this way, see Asset Catalogs. 


Asset Types 


Assets can be broadly divided into two types: primitive and 
preset assets. Which is which depends on the Data-Blocks 


type. 


Primitive assets are data-blocks that are either linked or 
appended to the current file. Examples are objects, 
materials, and worlds. These can be dragged from the Asset 
Browser into the scene (objects and worlds), or onto existing 
objects (materials). 


Preset assets are data-blocks that are loaded and then 
applied to something. An example is a pose asset. When 


applying the pose, the data-block is loaded from its blend- 
file, and then the pose is applied to the active armature. 


In the future, the asset type definition will be expanded; see 
Future Development for more info. 


The Current File Asset Library 


To help with the management of assets in the current blend- 
file, you can set the Asset Browser to show the Current File 
asset library. This always shows the assets in the current 
file, even when the current file is not saved in an asset 
library. This also makes it possible to create assets and use 
them in the same file, for small single-file projects. 


When the current blend-file is part of an asset library, you 
can also see its assets in that library, of course. The assets 
that are in the current file are marked with an icon; only 
those are editable. 


Life Cycle of an Asset 


This section describes how to create, edit, share, and use 
assets. 


Creating an Asset 


To create an asset, first create the thing you want to turn 
into an asset. That is, create the object, material, world, or 
pose your character. The next step depends on the type of 
asset (see Asset Types above). 


For primitive assets, use the Mark as Asset operator. It can 
be found in the data-block selector, in the Outliner, and for 


objects in the 3D Viewport Object menu. When using Mark 
as Asset, an automatic preview is generated. If you want, 
you can also change or replace this with an image of your 
own choosing; use the folder button next to the preview 
image in the Asset Details region of the Asset Browser. 


For preset assets, there will be a dedicated button for the 
different asset types. Currently poses are the only preset 
assets; use the Create Pose Asset button in the Action 
editor. This will copy the pose of the selected bones into a 
new Action, mark it as asset, and put it into the currently 
active asset catalog if there is an Asset Browser open. 


After creating the asset, make sure the current blend-file is 
Saved in your asset library. Blender does not copy the asset 
into the asset library for you. 


Editing Assets 


Since assets are regular data-blocks, with just a little bit of 
metadata attached, they can be edited like any other 
Blender data. Just open the file and edit the object, material, 
world, etc. 


For poses assets, this is also possible. With the pose library 
file open, just click the Assign Action button to assign the 
pose action to the currently selected armature. Then you 
can use all of the animation tooling to edit the pose, remove 
or add keys, etc. 


Editing asset metadata can be done via the Asset Browser. 


Sharing Assets 


Because assets are simply stored in blend-files, they can be 
Shared by sharing their blend-file. Be sure to include the 
Asset Catalog Definition File as well. 


There is currently no functionality to extract selected assets 
and save them (together with their catalog definitions) into 
a different blend-file. This could be implemented as an add- 
on. 


Using Assets 


Assets can be used from the Asset Browser. 


The pose library extends this, and adds an Asset View to the 
3D Viewport. See Use from 3D Viewport. 


Removing Assets 


Asset metadata can be erased by the Clear Asset operator. 
This operator is available in data-block selectors, the Asset 
Browser, and for objects in the 3D Viewport menu. 


Author 
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Refresh Asset Library Zz z 
Clear Asset ~ 


Vv Preview 


Clear Asset (Set Fake Use * 
Delete all asset metadata and turn the selected asset data-blocks back into normal 
data-blocks. 


Display Size 


Clear Asset in the Asset Browser. 


Clear Asset 
Removes the asset metadata (catalog, description, 
author, tags), effectively turning an asset into a regular 
data-block. As such, the same removal rules apply as 


with other data-blocks. For example, if a mesh object is 
still placed in the scene, Clear Asset will not remove it 
from the scene. See Life Time. The preview will be kept 
inside the data-block and not be removed. 


Clear Asset (Set Fake User) 
Performs the same operation as Clear Asset, and then 
marks the data-block as protected. This makes it possible 
to no longer have the data-block marked as asset, and 
still be sure it is not lost when saving the blend-file. 


Design Limitations 


Blender is not allowed to write to other blend-files than 
the one you have currently open. This means that to edit an 
asset, you have to open its blend-file. Fortunately this is 
only a single click away, both in the Source List region of the 
Asset Browser and in the asset context menu. 


This also means that Blender does not copy assets into 
the asset library for you. You are responsible for placing 
the blend-file with the asset in an asset library directory, 
and marking the asset as such. See Asset Pushing for more 
on this topic. 


Future Development 


This section describes interesting avenues for further 
development. Even though it is not an exhaustive list, it 
might help to better understand the current functionality of 
Blender’s Asset Browser. 


Non-Data-Block Assets 


Non-Blender assets, such as image or audio files, will likely 
be supported in a future version. For such files, asset 
metadata is then stored in XMP sidecar files, similar to what 
other software is also doing. Importers (USD, gITF, FBX, ...) 
could add support for their file types as assets this way too. 
Furthermore, it should become possible to enrich an asset 
with a Python script, which can then provide code to be run 
when the asset is used. 


Cross Blend-File Editing 


As described above, Blender itself is not allowed to write to 
other blend-files than the currently open one. This rule helps 
to limit complexities; for example, it is hard to reliably 
implement an undo system when manipulating other files. 
The rule does get in the way of mass-updating assets when 
they are stored in various blend-files. 


Since there is already tooling that can manipulate blend- 
files outside of Blender itself (see Blender Asset Tracer), it’s 
possible to also create an external tool for doing such edits 
across blend-files. Such a tool might even be implemented 
via Blender’s application templates system, or as an add-on; 
the rule above applies to Blender itself, not to its add-ons. 


Asset Pushing 


Asset pushing is a way of getting assets into the asset 
library, where you are working on a file and want to copy 
the asset from that file into the library. This is a concept that 
appears deceptively simple. In certain cases it is actually 
simple, but often enough it gets quite complex. For 
example, when you want to push an object into an external 
asset library, should that also copy the materials? What 
about the texture images referenced by those materials? 


What about objects referenced by custom properties, 
constraints, or modifiers? And in which files would they have 
to go? Do they all go into one big assets.blend, individual 
blend-files, or into a directory per asset type? Blender 
should not be making such decisions for you. 


For specific cases, these things are all solvable. For this 
reason the pose library has been created as an add-on 
which is enabled by default. Studios with specific needs can 
disable the add-on and implement their own functionality; 
the building blocks are all in Blender’s core, and thus do not 
need to be copied for this. Furthermore, add-ons can write 
to other blend-files, so they could make the decisions for 
users. 


Asset pushing is desirable. Because of the questions above, 
it is unknown how to implement this well, in a way that still 
allows artists control over their assets. 


Asset Catalogs 


Asset Catalogs help you to organize your assets. They look a 
little bit like file directories, but they are completely 
independent of the location of your blend-files. Assign each 
asset in a blend-file to its own catalog, or have one big 
catalog with all the assets of all the blend-files combined. 
It’s all up to you. 


Similar to Collections, catalogs can be nested i.e. you can 
have a main catalog that contains several nested catalogs. 
For example, this allows you to have a catalog of assets for 
“Furniture” with sub-catalogs of “Tables”, “Chairs”, “Lamps”, 
etc... 


For more technical information, see Asset Catalogs on the 
Blender Wiki. 


Folder Structure 


asset-library 

chars 

ellie 
ellie_materials.blend 
elllie_poses.blend 
elllie.blend 

rex 
rex_materials.blend 
rex_poses.blend 


shrubberies.blend 
small_trees.blend 
catalogs.txt 

edit 

r scenes 

Hr tools 


Catalog 


Characters 
Ellie 
Poses 
Head 
Hands 
Rex 
Poses 
Head 
Hands 


rex.blend Props 
props Trees 
big_trees.blend Rocks 
rocks.blend Others 


Example file system and catalog structures. 


The Home Location of Assets 


There can be as many catalogs as you want, but an asset 
can be assigned to a single catalog at a time. This is 
similar to a file system, where a file is only in one directory 
(ignoring advanced things like symbolic links). 


Catalogs themselves can be nested and moved by dragging 
and dropping. Moving a catalog will not modify the assets it 
contains; they will simply move along to the new location of 
the catalog. 


Selecting a catalog in the Asset Browser will show all assets 
in that catalog and in child catalogs. So, in the preceding 
example, selecting Characters/Ellie/Poses will also show 
assets from Characters/Ellie/Poses/Head and 
Characters/Ellie/Poses/Hands. 


Assigning an Asset 


Aly View 


“@ Current File v ‘ Yame Scales - Blood Red Corn snake 


fi All 
v Materials 


Metal - Chrome Metal - Galvanized Metal - Gold Author Simon Thommes 


g * 


v Preview 


Scales - Blood Red Corn snake 
AP) 


Metal - Tinged Bro... 


nimal 


Reptile 
Snake 


Pattern 


Assigning a selection of “Scale material” assets to a 
catalog. 


To assign assets to a catalog, just select and drag the assets 
on top of the catalog. 


Tip 


You can assign an asset to the “Unassigned” catalog, this 
will remove it from any existing catalogs. 


Components of a Catalog 


Each catalog consists of a catalog path, a UUID, anda 
simple name. Normally you would only deal with the catalog 
path; the rest is for internal Blender use and/or for 
emergency situations. 


Catalog Path 


The path of a catalog determines where in the catalog 
hierarchy the catalog is shown. Examples are 
Characters/Ellie/Poses/Hand Or Kitbash/City/Skyscrapers, which 
would result in the following catalog tree. The highlighted 
catalog has path Characters/Ellie/Poses/Hand. 


ft All 
wv Characters 
v Ellie 
wv Poses 
Hand 
v Kitbash 


wv City 


Skyscrapers 


Example tree of asset catalogs. 


UUID 


Each catalog has a UUID, which is normally hidden from the 
user interface (enable Developer Extras and the 
experimental Asset Debug Info option to see them). This is 
what is stored in the asset, and what determines the 
“identity” of the catalog. As a result, a catalog can be 


renamed or moved around (i.e. you can change its path), 
and all assets that are contained in it will move along with 
it. This only requires a change to the catalog itself, and not 
to any asset blend-file. 


Simple Name 


Each catalog has an optional simple name. This name is 
stored along with the UUID in each asset. The purpose is to 
make it possible for humans to recognize the catalog the 
asset was assigned to, even when the catalog definition file 
(see below) is lost. 


Like the UUID, the simple name is normally hidden from the 
user interface. Enable Developer Extras in the interface 
preferences to make it visible in the Asset Browser. 


Catalog Definition Files 


Asset catalogs are stored in Catalog Definition Files (CDFs). 
Blender 3.0 supports a single CDF per asset library. It is 
stored in blender_assets.cats.txt in the root directory of the 
asset library. If the file does not exist, Blender will create it 
when the catalogs are saved. When catalogs are changed, 
Blender updates that file, but also creates a backup of the 
previous state to a file named blender assets.cats.txt~. 


Which File to Write To 


Asset catalogs can be saved independently of the blend-file; 
the catalog editor has its own “Save” button. 


Format 


Catalog Definition Files (CDFs) are relatively simple text 
files, encoded in UTF-8. Each CDF consists of a version 
indicator, and a line of text per catalog. Each catalog line is 
colon-separated, of the form {UUID}: {path}: {simple name}. 


Example 


This is an example of a valid catalog definition file: 


# This is an Asset Catalog Definition file for Blender. 

# 

# Empty lines and lines starting with “#° will be ignored. 

# The first non-ignored line should be the version indicator. 
# Subsequent lines are of the format 

"CATALOG UUID:catalog/path/for/assets:simple catalog name" 


VERSION 1 


313ea471-7c81-4de6-af81- 

fb04c3535d0e: catalog/without/simple/name: 
ee9c7b60-02f1-4058 -bed6 - 

539b8d2a6d34: character/Ellie/poselib: character-Ellie-poselib 
cd66bf52-58f4-45cb-a4e2 - 
dcQOe0ee8Ff3fe:character/Ellie/poselib: character-Ellie 
4eb44ec6 - 3424 -405b-9782- 

ca006953e799: character/Ellie/poselib/white space: character- 
Ellie-poselib-white space 

b63ed357 -2511-4b96-8728- 

1b5a7093824c: character/Ruzena/poselib:Ruzena pose library 
dcdee4df -926e-4d72-b995- 

33106983bb9a: character/Ruzena/poselib/face:Ruzena face 
fb698f2e -9e2b - 4146 -a539- 

3af292d44899: character/Ruzena/poselib/hand:Ruzena hands 


Valid Catalog Paths 


Catalog paths follow the following rules: 


All paths are absolute; there is no difference between 
/a/b and a/b. 

Only / as separator (no \; think less filesystem path and 
more URL). 

Not empty (it’s required for a valid catalog). 

No empty components (so not a//b; a/b Is fine). 

Invalid characters: :, \. 

Paths are always interpreted as UTF-8. 


Media Formats 


Supported Graphics Formats 

o Image Formats 

o Opening Images 

o Saving Images 

o Format Details 
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Supported Graphics 
Formats 


Image Formats 


This is the list of image file formats supported internally by 
Blender: 


Channel 


Format Depth Alpha Metadata DPI Extensions 
BMP 8bit x x v . bmp 

Iris 8, 16bit v x x .sgi .rgb .bw 
PNG 8,16bit v Vv v .png 

JPEG 8bit x v v -jpg .jpeg 
2000 tebit a 


Targa 8bit v x x .tga 


Format Senne! Alpha Metadata DPI Extensions 
Depth 


Cineon & 8,10, 12, 


DPX 16bit ns x X cin .dpx 
float 16, 

OpenEXR  32bit 7 e v exr 

Radiance 

HDR float J x x hae 

TIFF 8,16bit Vv x y dae. ati 

Hint 


If you are not interested in technical details, a good rule of 
thumb for selecting output formats for your project is: 


Use OpenEXR 
if you intend to do compositing or color grading on 
these images. 


Use PNG 
if you intend on-screen output or encoding into multiple 
video formats. 


Use JPEG 


for on-screen output where file size is a concern and 
quality loss is acceptable. 


All these formats support compression which can be 
important when rendering out animations. 
Hint 


Bit depths for image formats represent the following 
numbers of tonal levels per channel: 


8: 256 levels 
10: 1024 levels 
12: 4096 levels 
16: 65536 levels 


Opening Images 


Relative Path 


Sets the file path to be relative to the currently opened 
blend-file. 


See Relative Paths. 


Detect Sequences 
Automatically looks for image sequences in the selected 
images (based on the file name). Disable this when you 
do want to get single images that are part of a sequence. 


Detect UDIMs 
Automatically looks for UDIM tiles in the directory of the 
selected image; if matches are found they are loaded 
into Blender as UDIMs. This works by detecting if the 


filename has a .xxxx (four digit number) before the file 
extension. 


Opening an Image Sequence 


To load image sequence in any of the supported image file 
formats, the filename of the images must contain a digit to 
indicate the frame order (e.g. *-0001.jpg, *-0002.jpg, 

*-9003.jpg, etc, of any image format), indicating the frame. 


The sequence could be opened by the selection of the 
images with any of the following methods by the 
confirmation with the Open Image button or Return. 


Range 
Navigate into the directory and LmB click and drag over a 
range of names to highlight multiple files. You can page 
down and continue Shift-LMB click-dragging to add more 
to the selection. 


Batch 
Shift-LMB click selected non-related stills for batch 
processing; each image will be one frame, in sort order, 
and can be a mix of file types (jpg, png, exr, etc.). 


All 
Press A to select/deselect all files in the directory. 


Saving Images 


File Format 
Choose what format to save the image as. 


Color Mode 


Choose the color format to save the image (or video) to. 
Note that RGBA is not available for all image formats, 
check the list above for details. 


BW, RGB, RGBA 


Color Depth 
Some image file formats support a varying number of 
bits per pixel. This affects the color quality and file size. 
Commonly used depths: 


8-bit: Most common for on-screen graphics 
and video. 

10, 12, 16-bit: Used for some formats focusing on 
photography and digital films (such as 
DPX and JPEG 2000). 

16-bit Half Float: 
Since full 32bit float is often more than 
enough precision, half float can save 
drive space while still providing a high 
dynamic range. 

32-bit Float: Highest quality color depth. 


Note 
Internally Blender’s image system supports either: 


e 8 bits per channel (4 x 8 bits). 
e 32 bits float per channel (4 x 32 bits) - using 4 
times as much memory. 


Images higher than 8 bits per channel will be converted 
into a float on loading into Blender. 


Compression 
Used to reduce the size of the image file. How this is 
done may vary depending on the file format and settings 


used. 


Quality 
Similar to Compression but is used for JPEG based file 
formats. The quality is a percentage, 0% being the 
maximum amount of compression and 100% is no 
compression. 


Save As Render 


Save image with render color management. For display 
image formats like PNG, apply view and display 
transform. For intermediate image formats like OpenEXR, 
use the default render output color space. 


Copy 
The Copy checkbox will define if the data-block will 
reference the newly created file or the reference will be 
unchanged, maintaining it with the original one. 


Color Space 
To specify the color space of the source file. 


The list of color spaces depends on the active OCIO 
contig. The default supported color spaces are described 
in detail here: Default OpenColorlO Configuration 


Note 


Note, Cineon, DPX, OpenEXR, and Radiance HDR image 
types default to being saved in a linear color space. 


Format Details 


Cineon & DPX 


Cineon is Kodak’s standard for film scanning, 10 bits per 
channel and logarithmic. DPX has been derived from Cineon 
as the ANSI/SMPTE industry standard. DPX supports 16-bit 
colors/channels, linear as well as logarithmic. DPX is 
currently a widely adopted standard used in the film 
hardware/software industry. 


DPX as well as Cineon only stores and converts the “visible” 
color range of values between 0.0 and 1.0 (as a result of 
rendering or composite). 


OpenEXR 


ILM’s OpenEXR has become a software industry standard for 
HDR image files, especially because of its flexible and 
expandable structure. 


An OpenEXR file can store multiple layers and passes. This 
means OpenEXR images can be loaded into a Compositor 
keeping render layers and passes intact. 


Output Options 


Available options for OpenEXR render output are: 


Color Depth 
Half saves images in a custom 16 bits per channel 
floating-point format. This reduces the actual “bit depth” 
to 10-bit, with a 5-bit power value and 1-bit sign. 


Float (Half), Float (Full) 


Codec 
PXR24: Lossy algorithm from Pixar, converting 
32-bit floats to 24-bit floats. 


ZIP: Standard lossless compression using 
Zlib, operating on 16 scanlines ata 
time. 

PIZ: Lossless wavelet compression. 
Compresses images with grain well. 

RLE: Run-length encoded, lossless, works 
well when scanlines have same values. 

ZIPS: Standard lossless compression using 
Zlib, operating on a single scanline ata 
time. 

DWAA: JPEG-like lossy algorithm from 
DreamWorks; compresses blocks 32 
scanlines together. 

DWAB: Same as DWAA but compresses blocks of 
256 scanlines. 


Z Buffer 
Save the depth information. In Blender, this now is 
written in floats too, denoting the exact distance from 
the camera. 


Preview 
On rendering animations (or single frames via command 
line), Blender saves the same image also as a JPEG, for 
quick preview or download. 


Radiance HDR 


Radiance is a suite of tools for lighting simulation. Since 
Radiance had the first (and for a long time the only) HDR 
image format, this format is supported by many other 
software packages. 


Radiance .hdr files store colors still in 8 bits per component, 
but with an additional (shared) 8-bit exponent value, making 
it 32 bits per pixel. 


Supported Video & Audio 
Formats 


Video Formats 


These formats are primarily used for compressing rendered 
sequences into a playable movie (they can also be used to 
make plain audio files). 


A codec is a little routine that compresses the video so that 
it will fit on a Blu-ray, or be able to be streamed out over the 
Internet, over a cable, or just be a reasonable file size. 
Codecs compress the channels of a video down to save 
Space and enable continuous playback. Lossy codecs make 
smaller files at the expense of image quality, while /ossless 
codecs compress as much as possible the video, but without 
losing any existing data. 


Some codecs, like H.264, are great for larger images. 
Codecs are used to encode and decode the movie, and so 
must be present on both the encoding machine (Blender) 
and the target machine. The results of the encoding are 
stored in a container file. 


There are dozens, if not hundreds, of codecs, including Xvid, 
H.264, DivX, Microsoft, and so on. Each has advantages and 
disadvantages, and compatibility with different players on 
different operating systems. 


Note 


Most codecs can only compress the RGB or YUV colors, but 
some support the Alpha channel as well. Codecs that 
Support RGBA include: 


EFmpeg video codec #1 

PNG 

Quicktime 

PNG TIFF Pixlet is not lossless, and may be only 
available on macOS. 

WebM/VP9 (although Blender will not import the alpha 
channel due to a limitation of FFmpeg). 


Blender offers three ways to export videos, in the File 
Format selector of the Output properties: 


AVI JPEG 
AVI but with JPEG compression. Lossy, smaller files but 
not as small as you can get with a Codec compression 
algorithm. JPEG compression is also the one used in the 
DV format used in digital camcorders. 


AVI Raw 
Audio-Video Interlaced (AVI) uncompressed frames. 


FFmpeg Video 
Video encoding via the FFmpeg library. Which codecs are 
available depends on the operating system and FFmpeg 
version. This options allows for a lot of different 
encodings, some presets are available (to the right of the 
Encoding subpanel) to help with getting started. This 
option is also the only one allowing to export audio. 


FFmpeg Containers 


MPEG-1: .mpg, .mpeg 
A standard for lossy compression of video and audio. It is 
designed to compress VHS-quality raw digital video and 
CD audio down to 1.5 Mbit/s. This container enforces the 
video codec, you can only define quality parameters, and 
the audio codec. 


MPEG-2: .dvd, .vob, .mpg, .mpeg 
A standard for “the generic coding of moving pictures 
and associated audio information”. It describes a 
combination of lossy video compression and lossy audio 
data compression methods which permit storage and 
transmission of movies using currently available storage 
media (notably DVDs) and transmission bandwidth. This 
container enforces the video codec, you can only define 
quality parameters, and the audio codec. 


MPEG-4: .mp4, .mpg, .mpeg 
While being a video codec, it is also a real container, in 
which you can store video and audio streams using 
various codecs. It is widely supported by many modern 
software and hardware players. 


AVI: .avi 
A derivative of the Resource Interchange File Format 
(RIFF). One of the first and most widely used video 
container format. 


Quicktime: .mov 
A multi-tracks format. QuickTime and MP4 container 
formats can use the same codecs. They are mostly 
interchangeable in a QuickTime-only environment. MP4, 
being an international standard, has more support. 


DV: .dv 


An intra-frame video compression scheme, used by many 
digital camcorders back in the days. It uses the discrete 
cosine transform (DCT, similar algorithm to JPEG) to 
compress video on a frame-by-frame basis. Audio is 
stored uncompressed. This container enforces the video 
codec, you can only define quality parameters. 


Qgg: .ogg, .ogv 
A free open-standard container format, that can hold an 
unlimited number of video, audio, picture or subtitle 
tracks in one file. 


Matroska: .mkv 
A free open-standard container format, a file format that 
can hold an unlimited number of video, audio, picture or 
subtitle tracks in one file. 


Flash: .flv 
A container file format used to deliver video over the 
Internet using Adobe Flash Player. This container 
enforces the video codec, you can only define quality 
parameters. 


WebM: .webm 
A free open-standard container format, designed to be 
used for internet streaming. Note that this container can 
only hold a VP9 video codec, and Vorbis or Opus audio 
codecs. 


FFmpeg Video Codecs 


These options are not available with all Containers. 


No Video 
For audio-only encoding. 


DNxHD 
Intended to be usable as both an intermediate format 
suitable for use while editing, and as a presentation 
format. It can be either lossless or lossy. 


DV 


See Containers. 


EFmpeg_video codec #1 
FFV1 is a lossless intra-frame video codec. It can use 
either variable length coding or arithmetic coding for 
entropy coding. The encoder and decoder are part of the 
free, open-source library libavcodec in FFmpeg. Supports 
an alpha channel. 


Flash Video 
See Containers. 


H.264 
A modern variation of the MPEG-4 family, this lossy codec 
is very commonly used. It offers a very good 
compression/quality ratio. 


HuffYUV 
Lossless video codec created by Ben Rudiak-Gould which 
is meant to replace uncompressed YCbCr as a video 
capture format. 


MPEG-1 
See Containers. 


MPEG-2 
See Containers. 


MPEG-4(DivXxX) 
Inherits many of the features of MPEG-1, MPEG-2 and 
other related standards, but also adds new features. 


PNG 
Lossless, this stores each frame as an independent 
image in the video stream. Compression will be poor, but 
as every frame is fully self-contained, scrubbing and 
editing can be simpler. Supports an alpha channel. 


QT rle / QT Animation 
Original format of QuickTime videos. Supports an alpha 
channel. 


Theora 
A free open-standard lossy codec designed together with 
the Ogg_container. 


WEBM / VP9 
A free open-standard lossy video compression format. 
One of the most recent codecs, it is widely used for 
internet streaming. 


AV1 
A free open-standard lossy video compression format, 
designed as a successor to VP9. AV1 offers great 
compression rates and visual quality, AVZ produces video 
files that that are about 30% more space efficient than 
VP9 


FFmpeg Audio Codecs 


No Audio 
For video-only encoding. 


AAC 
Advanced Audio Codec, a standardized, lossy 
compression and encoding scheme for digital audio. AAC 


generally achieves better sound quality than MP3 at 
similar bit rates. 


AC3 


Audio Codec 3, an audio compression technology 
developed by Dolby Laboratories. 


FLAC 
Free Lossless Audio Codec. Digital audio compressed by 
FLAC’s algorithm can typically be reduced to 50-60% of 
its original size. 


A lossy audio compression format. 
2 


MP 
A lossy audio compression format, widely used as final 
audio format. 

Qpus 
A lossy audio compression format, designed to encode 
speech or general audio and is intended to replace the 
Vorbis codec. 


W 


PCM 
Pulse Code Modulation, a method used to digitally 
represent sampled analog signals. It is the standard form 
for digital audio in computers and various Blu-ray, 
Compact Disc and DVD formats, as well as other uses 
such as digital telephone systems. 


Vorbis 
An open-standard, highly-compressed format comparable 
to MP3 or AAC. Vorbis generally achieves better sound 
quality than MP3 at similar bit rates. 


Known Limitations 


Video Output Size 


Some codecs impose limitations on output size, H.264, for 
example requires both the height and width to be divisible 
by 2. 


Importing & Exporting 
Files 


Reference 


Menu: Topbar > File > Import/Export 


Sometimes you may want to utilize files that either came 
from other 2D or 3D software, or you may want to use the 
things you have made in Blender and edit them in other 
software. Luckily, Blender offers a wide range of file formats 
(e.g. ABC, USD, OBJ, FBX, PLY, STL, etc.) that can be used to 
import and export. 


Popular formats are enabled by default, other formats are 
also supported and distributed with Blender, these can be 
enabled in the Preferences through the use of Add-ons. 


Alembic 

Collada 

Universal Scene Description 

Wavefront OB) 

STL 

Scalable Vector Graphics (SVG) as Grease Pencil 
Portable Document Format (PDF) as Grease Pencil 


See also 


More information on the add-ons to import/export these 
file types can be found in the add-ons section. 


Alembic 


From the Alembic home page: 


Alembic is an open computer graphics interchange 
framework. Alembic distills complex, animated scenes 
into a non-procedural, application-independent set of 
baked geometric results. This ‘distillation’ of scenes into 
baked geometry is exactly analogous to the distillation 
of lighting and rendering scenes into rendered image 
data. 


Alembic is focused on efficiently storing the computed 
results of complex procedural geometric constructions. 
It is very specifically not concerned with storing the 
complex dependency graph of procedural tools used to 
create the computed results. For example, Alembic will 
efficiently store the animated vertex positions and 
animated transforms that result from an arbitrarily 
complex animation and simulation process which could 
involve enveloping, corrective shapes, volume- 
preserving simulations, cloth and flesh simulations, and 
so on. Alembic will not attempt to store a representation 
of the network of computations (rigs, basically) which 
are required to produce the final, animated vertex 
positions and animated transforms. 


In brief, Alembic can be used to write an animated mesh to 
a drive, and read it back quickly and efficiently. This means 
that a mesh can be animated with a very CPU-intensive rig 
and then ‘baked’ to an Alembic file. Finally it can be load 
into the shot file for shading and lighting with only moderate 
CPU usage. 


Due to the Open Source nature of the Alembic standard as 
well as the C++ library implementing that standard, 
Blender can be used in a hybrid pipeline. For example, 
other software, such as Houdini or Maya, can export files to 
Alembic, which can then be loaded, shaded, and rendered in 
Blender. It is also possible to animate characters (or other 
models) in Blender, export to Alembic, and load those files 
into other software for further processing. 


Exporting to Alembic Files 


This section describes the effect of the different export 
options. 


Manual Transform 


sca le : Manual Transform 
This sets i 
Scale 
the global z 
scale of the r i Scene Options 
Alembic nau 
file. Keep it ieee 
End 
at the ie 
d efa U It Samples Transform 
value of 1.0 Geometry 
to use Shutter Open 0.000 
Blender’s Close 1.000 
units. ¥Y Use Instancing 


¥ Custom Properties 


Flatten Hierarchy 
Selected Objects 
¥ Renderable Objects 


Visible Objects 


Generic and Scene Alembic Export options. 


Scene Options 


Frame Start, End 


Sets the frame range to export to Alembic. This defaults 
to the current scene frame range. 


Sub-frame Sampling 


These options control the sub-frame sampling of 
animations. 


Samples Transform 
Transform Samples sets the number of times per 
frame at which animated transformations are sampled 
and written to Alembic. 


Geometry 


Geometry Samples sets the same, but then for 
animated geometry. 


Shutter Open, Close 
Shutter Open/Close define the interval [open, close] 
over which those samples are taken. The valid range 
is -1 to 1, where -1 indicates the previous frame, O 
indicates the current frame, and 1 indicates the next 
frame. 


For example, if information for detailed mesh motion 
blur is desired, some subframes around the current 
frame can be written to Alembic by using a sample 
count of 5, Shutter Open at -0.25 and Shutter Close at 
0.25. This mimics a “180 degree” shutter, opening 90 
degrees before the frame and closing 90 degrees after 
the frame. 


Flatten Hierarchy 
When disabled, parent/child relations between objects 
are exported too. Any parent object that is not exported 
itself, but with children that are exported, is replaced by 


an 


empty. When enabled, parent/child relations are not 


exported, and transformations are all written in world 
coordinates. 


Use Instancing 
Exports data of duplicated or instanced objects as 
Alembic instances; speeds up the export and can be 
disabled for compatibility with other software. 


Custom Properties 
When enabled (which it is by default), custom properties 
are exported to Alembic as well. The following custom 
property types are supported: 


Only 


Numbers (int, float) and strings. These are exported 
as arrays of a single element, so 47 will be exported 
as [47] to Alembic, and "Agent" to ["Agent"]. This 
Lists of numbers and strings. These are exported as- 
IS, SO [327, 47] is exported as [327, 47]. 

Matrices and nested arrays of numbers. These are 
flattened into one long list, soa 3X2 matrix of 
numbers will become a list of 6 numbers. Similarly, 
nested lists [[1, 2, 3], [4, 5], [6]] will be exported 
as [1, 2, 3, 4, 5, 6]. 

Numbers can be animated as well. 


Selected Objects 


When enabled, exports only the selected objects. 
When disabled, all objects are exported. 


Visible Objects 
Limits the export to scene collections that are 
currently visible. 


Use Settings For 
Determines visibility of objects, modifier settings, and 
other areas where there are different settings for 
viewport and rendering. 


Render: Use Render settings for object visibility, 
modifier settings, etc. 
Viewport: Use Viewport settings for object 


visibility, modifier settings, etc. 
Object Options 


UVs @' Object Options 
When enabled, UV maps are 
exported. Although the 
Alembic standard only 


¥ UVs 


¥ Pack UV Islands 


Supports a single UV map, ¥ Normals 
Blender exports all UV maps in Vertex Colors 
a way that should be readable Face Sets 

by other software. Curves as Mesh 


Pack UV Islands Subdivisions Apply 
Generates an optimized UV atatatt erg 
layout with non-overlapping 
islands that tries to efficiently 
fill the Texture Space. See the 
Pack Islands operator that 
works with the same principle 
for more information. Object options. 


Triangulate 


Normals 


When enabled, an object’s Normals are exported. See 
Custom Split Normals of Meshes below for more 
information. 


Color Attributes 
When enabled, exports Color Attributes. 


Face Sets 
Exports the material names per face. The material data is 
not exported but only material names. 


Subdivisions 
Apply 
Applies any Subdivision Surface modifiers before 
writing to Alembic. 


Use Schema 
Writes polygonal meshes using the “SubD” Alembic 
schema, rather than the “PolyMesh” schema. This sets 
an import option for the program, with which the file is 
opened, to apply its form of a non-destructive 
Subdivision. 


Triangulate 
Triangulates the mesh before writing to Alembic. For 
more detail on the specific option see the Triangulate 
modifier. 


Particle Systems 


Alembic has no support for Particle Systems 
Particle Systems, in the same 
way that it does not support 
armatures. Hair is exported as 
animated zero-width curves. 


¥ Export Hair 


¥Y Export Particles 


Particle Systems options. 


Particles are exported as 
animated points. 


Importing Alembic Files 


When importing an Alembic file, Mesh Sequence Cache 
modifiers are automatically added to time-varying meshes. 
For time-varying object transforms (so animation of rotation, 
location, or scale) the Transform Cache Constraint is used. 


Custom Split Normals of Meshes 


Blender supports the import and export of custom normals 
to Alembic files. As a basic rule of thumb, a completely 
Smooth mesh will be exported without normals and thus 
produce the smallest Alembic file. This is reflected in the 
importer; an Alembic mesh without normals is loaded as a 
smooth mesh. 


On export, for every mesh: 


e If it has Custom Loop Normals then the loop normals are 
exported. 

e If one or more polygons are marked flat then loop 
normals are also exported. 

e Otherwise, no normals are exported. 


On import, when the Alembic mesh contains: 


e Loop normals (kFacevaryingScope) are used as custom 
loop normals, and enable Auto Smooth to have Blender 
actually use them. 

e Vertex normals (kVertexScope Or kVaryingScope) are convert 
to loop normals, and handle as above. 


e If there are no normals then the mesh is marked as 
smooth. 

e Unsupported normal types (kConstantScope, kUniformScope, 
kUnknownScope) are handled as no normals. 


When an imported mesh does not contain normals, the final 
look can be controlled by enabling the Auto Smooth 
checkbox and altering the threshold angle. 


Handling Time 


Unlike Blender and many other applications and file formats, 
Alembic files don’t have any concept of frames. Alembic 
works purely with time, and values that are sampled over 
time. For example, there is no way to distinguish 30 FPS 
with 2 samples per frame, and 60 FPS with 1 sample per 
frame. This has caused many developers to just hard-coded 
24 FPS when reading Alembic files. 


Blender uses the current scene frame rate to convert a 
frame number (in Blender) to a time in seconds (in Alembic). 
As a result, you can import an Alembic file that was 
produced at 120 FPS into a Blender scene that is 30 FPS and 
still not see any time stretching. 


Collada 


The COLLADA™ module has been implemented as a flexible 
tool for exporting and importing .dae files. A design goal is to 
provide a set of parameters which should make it possible 
to export/import Collada files from/to a variety of tools. But 
please be aware that the Collada module is still a work in 
progress. So it may be possible that your particular usage 
scenario is not yet supported. 


Collada Exporter 


Operator Presets 


There are two operator presets (See top of the Sidebar) for 
Second Life (SL) users: 


e Second Life Static - is good for exporting static meshes. 
e Second Life Rigged - is good for exporting the SL default 
character. 


Note 
Special Notes for Second Life users: 


e Please use the Operator presets. All other export 
settings will not work for Second Life. 

e The character orientation needs to be such that the 
character looks towards positive X. 

e Scale and Rotation must be applied before the export! 


Operator Presets 


"Tri angulate 


" Use Object Instances 


" Use Blender Profile 


Main 


Selection Only 


When Selection Only is enabled, then only the selected 
objects will be exported. Otherwise the entire scene is 


exported with all visible and all invisible objects. 


Include Children 
When this option is enabled then all children of the 
selected objects will also be exported regardless of their 
selection state. 


Hint 

You can select only an armature, then using this option, 
all rigged meshes attached to the armature will also be 
exported. 


Include Armatures 
When this option is enabled, then all armatures related to 
the selected objects will also be exported regardless of 
their selection state. 


Hint 


You can select only the objects, then in the exporter 
enable this option to export the armature data also. 


Include Shape Keys 
Includes the application of shape keys by exporting 
meshes with the current shape key configuration baked 
in. 

Global Orientation 

Todo. 


Texture Options 


Only Selected UV Map 


When your mesh contains multiple UV layers, then 
Blender exports all layers by default. This option allows 
you to only export the active (selected) UV layer. 


Copy 
When you export images either material based image 
textures, then the exporter creates absolute file 
references in the export file. 


But if the Copy option is enabled, the exporter will create 
copies of the images instead and place the copies 
besides the export file. In that case the file references 
are made relative. 


Geometry 
Export Data Options 


Triangulate 


The mesh can be triangulated on-the-fly. The 
triangulation is based on the same function which is used 
in the Triangulate Faces tool for triangulating the current 
selection of faces. For full control over the triangulation 
you can do this manually before exporting. However, this 
option allows to apply the triangulation only on the 
exported data; the mesh itself is not affected. 


Apply Modifiers 
Export objects using the evaluated mesh, meaning the 
resulting mesh after all Modifiers have been calculated. 


Resolution 
Controls whether to apply the 3D Viewport resolution 
or the render resolution for modifiers that provide a 
preview mode and a render mode. 


Transform 
Collada supports two types of transformation matrix 
specifications. Either as <Matrix> or aS a set of 
transformation decompositions (for move, rotate and 
scale). Note that the exporter will not strictly follow this 
option setting, but will rather take it as a hint to use the 
option if ever possible. This is so because some of the 
exported data types have specific rules about how the 
transformation matrix has to be exported. This is ongoing 
development and a less ambiguous method may be 
provided in the future. 


Armature 
Armature Options 


Deform Bones Only 
When this option is enabled, then the exporter strips all 
non-deforming bones from the exported armatures. This 
option is useful when your armatures contain control 
bones which are not actually part of the character 
skeleton. For example you can export the Avastar rig with 
this option enabled. The resulting exported rig is 
compatible with Second Life. But please note the 
restrictions further below. 


Export to SL/OpenSim 
When this option is enabled, some issues with bone 
orientation are calculated differently and is designed to 
be used to export to Second Life or OpenSim. 


This is only relevant for rigged meshes, for static meshes 
it just does nothing at all. 


Animation 


Extra 
Collada Options 


Use Object Instances 
In Blender you can reuse the same mesh for multiple 
objects. This is named “object instantiation”. When you 
enable this option, then Blender will propagate object 
instantiation to the Collada file. 


Use Blender Profile 
Collada can be extended with tool specific data (profiles). 
Blender has its own (unofficial) profile that allows to 
export rig information into the Collada file. Later It can be 
used to reconstruct the rig when it should ever be 
necessary to import a dae file back into Blender. 


Sort by Object Name 
The export order of data is bound to internal object order 
and it can not be influenced in a reliable way. This option 
ensures that the Geometry nodes and the Object nodes 
are both exported in alphabetical order. 


Keep Bind Info 
When a rig is imported to Blender, the rig’s bind pose will 
be used as Blender’s rest pose. So all Matrix information 
of the original rest pose is lost. But in some cases you 
may want to preserve the original rig information. This 
option checks each bone for having two arrays: 


e rest mat - an array of 16 floats which represent the 
bone’s original rest-pose matrix. 

e bind mat - an array of 16 floats which represent the 
bone’s original bind-pose matrix. 


If the arrays are present, then those arrays will be used 
instead of the current rest pose/bind pose. Those two 
arrays are either created by a previous Collada import 
(see Collada Importer below), or they can be created 
manually, or by an add-on (script based). 


Collada Importer 


The Collada importer is mostly 
driven by the imported data. 
There is one option for controlling 
the import units: 


Import Data Options 


Custom Normals 
Use the mesh normals defined in the collada file, if they 
are defined, otherwise Blender will recompute them 
during the import process. 


Import Units 
If not enabled the imported data will be rescaled 
according to the currently used unit system. If this option 
is enabled, then Blender will adjust itself to the unit 
system as provided by the Collada file. 


Armature Options 


Fix Leaf Bones 
Collada only records “joints” which is mostly similar to 
Blender’s bone heads. But when you import a Collada file 
then the bone head/tail are not defined. This does not 
matter for connected bones where the bone parent only 
has one child. In that case the parent bone’s end location 
is adjusted to the child’s joint position. But especially for 
unconnected bones and for bones with more than one 
child a problem arises. 


When the Fix Leaf Bones option is enabled then Blender 
tries to guess where the bone head/tail of unconnected 
bones would best be placed. If the option is disabled, 
then the bone head/tail are placed at an offset along the 
Y axis. That is why bones often point towards the Y axis. 


Find Bone Chains 
When a bone has multiple children, then it is not defined 
which (if any) of the children should be connected to the 
bone. When the Find Bone Chains option is enabled, then 
Blender determines the longest bone chain (of children) 
for each bone. All bones along this chain will then be 
auto connected. 


If the option is disabled, then children will only be 
connected to parents, if the parent has only one child. 
But see the Auto Connect option below. 


Auto Connect 
When this option is enabled, then children will 
automatically be connected to their parents, if the parent 
has only one child. 


Keep Bind Info 


When this option is enabled, then the importer creates 
two custom properties for each bone: 


e rest mat - an array of 16 floats which represent the 
bone’s original rest-pose matrix. 

e bind mat - an array of 16 floats which represent the 
bone’s original bind-pose matrix. 


Those two arrays can later be used when you want to 
export the rig again and be sure the original rest 
pose/bind pose combination must be used. 


Technical Details 


Mesh 


Import 


Supported geometry types are: 


Tris (not tested) 
Polylist 

Polygons 

N-gons 

Tri-fans (not tested) 
Lines 


Export 
Mesh data is exported as <polylist>, <lines> and <vertices>. 


Light 


Import 


Blender does a best effort on importing lights from a dae- 
file. If a Blender profile is detected for lights, all values from 
these will be used instead. This ensures full re-import from a 
Blender exported dae-file. <extra> Support has been added in 
Blender 2.57. 


Export 


A Blender profile for lights has been added through the 
<extra> tag. The entire Light struct from Blender will be 
exported through this profile, with the exception of light 
curve falloff. 


Animation 
Export & Import 


e Support for object (mesh, camera, light) transform 
animations. Only Euler rotations, which is the default 
option for Objects, can be exported. For armature bone 
animations, Euler and quaternion rotation types are 
Supported. 

e Import and export of animations for the following 

parameters are supported: 
o Light 
o Camera 
o Material effects 

Non-skin controlling armature bone animation. 

Animations of armatures with skin deforming bones. 

Animations of armatures in Object Mode. 

Fully rigified armature animations (referring to the Rigify 

add-on). For export of rigified armature animations: 
o Run the Bake Action operator. 


10) 


10) 


{e) 


1e) 


If you have only the deform bones selected check 
Only Selected. This will give smaller dae. Otherwise 
uncheck Only Selected. 

Check Clear Constraints. 

Bake Action. 

Select the mesh and the deform bones. Then export 
to Collada while checking only selected option. 
(Selecting only the Mesh and bones is not strictly 
necessary. Selecting and export only selected will 
give smaller dae.) 

Demonstration video 


For bone nodes which are leaf nodes in the armature tree, or 
if a bone has more than one child, a Blender profile for tip 
with an <extra> tag, is added for those joint nodes. To 
correctly derive the bone-to-tail location on re-import. 


Note 


Important Things to Remember 


Object and data-block names are constrained to 21 
characters (bytes). 

UV layer names are constrained to 32 characters 
(bytes). 

Only armature animation on mesh, single skin 
controller. 

No support for modifiers yet. 


When importing a dae-file that has <instance node> on 
exporting this information is essentially lost and these 
nodes will be <node>s. 


Universal Scene 
Description 


Exporting to USD Files 


Universal Scene Description (USD) files can contain complex 
layering, overriding, and references to other files. Blender’s 
USD Exporter takes a much simpler approach. When 
exporting, all visible, supported objects in the scene are 
exported, optionally limited by their selection state. Blender 
does not (yet) support exporting invisible objects, USD 
layers, variants, skeletal animation, etc. 


The following objects can be exported to USD: 


e Meshes (of different kinds, see below). 

« Cameras (perspective cameras only at the moment, not 
orthogonal ones). 

e Light (all types except area lights). 

e Hair (exported as curves, and limited to parent strands). 

e Volume (both static and animated volumes). 


When exporting an animation, the final, evaluated mesh is 
written to USD. This means that the following meshes can 
be exported: 


e Static meshes. 

e Deforming meshes; here the topology of the mesh does 
not change, but the locations of the vertices change 
over time. Examples are animated characters or 
bouncing (but not cracking) objects. 


e Arbitrarily animated meshes; here the topology does 
change. An example is the result of a fluid simulation, 
where splashes of fluid can break off the main body. 

e Metaballs are exported as animated meshes. 
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Shot from Spring exported to USD and opened in 
USDView. 


Export Options 


The following options are available when exporting to USD: 


Selection Only 


When checked, only selected objects are exported. 
Instanced objects, for example collections that are 
instanced in the scene, are considered ‘selected’ when 
their instancer is selected. 


Visible Only 
Only exports objects that are not hidden. Invisible 
parents of exported objects are exported as empty 
transforms. 


Animation 
When checked, the entire scene frame range is exported. 
When unchecked, only the current scene frame is 
exported. 


Hair 
When checked, parent hair strands are exported as a 
curve system. Hair strand colors are not exported. 


UV Maps 
When checked, includes UV coordinates for exported 
meshes. The name of the UV map in USD is the same as 
the name in Blender. In USD the default name is st 
whereas in Blender the default name is UvMap. To export to 
the standard UV map name st, rename the UV map in 
Blender to st. 


Normals 
When checked, includes normals for exported meshes. 
This includes custom loop normals. 


Materials 
Exports material information of the object. By default the 
exporter approximates the Principled BSDF node tree by 
converting it to USD’s Preview Surface format. If To USD 
Preview Surface is disabled, the material is set to the 
viewport materials of meshes. 


Additional material properties are set in the Material 
grouping of options. 


When a mesh has multiple materials assigned, a 
geometry subset is created for each material. The first 
material (if any) is always applied to the mesh itself as 
well (regardless of the existence of geometry subsets), 
because the Hydra viewport does not support materials 
on subsets. See USD issue #542 for more information. 


Use Settings for 


Determines the whether to use Viewport or Render 
visibility of collection, modifiers, or any other property 
that can be set for both the Viewport and Render. 


Materials 


Additional options when Materials are enabled for export. 


To USD Preview Surface 
When exporting materials, approximate a Principled 
BSDF node tree to by converting it to USD’s Preview 
Surface format. If disabled, the material is set to the 
viewport materials of meshes. 


Warning 


Not all nodes are supported; currently only Diffuse, 
Principle, Image Textures, and UVMap nodes are 
support. 


Export Textures 


Export textures referenced by shader nodes to a 
“textures” folder which in the same directory as the USD 
file. 


Overwrite Textures 


Allow overwriting existing texture files when exporting 
textures. 


File References 


Relative Paths 
Use relative paths to reference external files (i.e. 
textures, volumes) in the exported USD file, otherwise 
use absolute paths. 


Experimental 


Instancing 
As this is an experimental option. When unchecked, 
duplicated objects are exported as real objects, so a 
particle system with 100 particles that is displayed with 
100 meshes will have 100 individual meshes in the 
exported file. When checked, duplicated objects are 
exported as a reference to the original object. If the 


Original object is not part of the export, the first duplicate 


is exported as real object and used as reference. 


Exporter Limitations 


Single-sided and Double-sided Meshes 
USD seems to support neither per-material nor per-face- 
group double-sidedness, so Blender uses the flag from 
the first material to mark the entire mesh as 
single/double-sided. If there is no material it defaults to 
double-sided. 


Mesh Normals 
The mesh subdivision scheme in USD is ‘Catmull-Clark’ 
by default, but Blender uses ‘None’ instead, indicating 


that a polygonal mesh is exported. This is necessary for 
USD to understand the custom normals; otherwise the 
mesh is always rendered smooth. 


Vertex Velocities 
Currently only fluid simulations (not meshes in general) 
have explicit vertex velocities. This is the most important 
case for exporting velocities, though, as the baked mesh 
changes topology all the time, and thus computing the 
velocities at import time in a post-processing step is 
hard. 


Coordinate System Orientation 


Blender uses the Z axis as up axis. Since USD supports 
both Y up and Z up, the USD files written by Blender 
always use Z up. 


Materials 


Very simple versions of the materials are exported, using 
only the Viewport Display color, metallic, and roughness. 


When there are multiple materials, the mesh faces are 
stored as geometry subset and each material is assigned 
to the appropriate subset. If there is only one material 
this is skipped. Note that the geometry subsets are not 
time-sampled, so it may break when an animated mesh 
changes topology. 


Hair 
Only the parent strands are exported, and only with a 
constant color. No UV coordinates, and no information 
about the normals. 


Camera 
Only perspective cameras are exported. 


Lights 
USD does not directly support spot lights, so those are 
not exported. 


Particles 
Particles are only written when they are alive, which 
means that they are always visible. There is currently no 
code that deals with marking them as invisible outside 
their lifespan. 


Objects instanced by particle system are exported by 
suffixing the object name with the particle’s persistent 
ID, giving each particle transform a unique name. 


Instancing/Referencing 
This is still an experimental feature that can be enabled 
when exporting to USD. When enabled, instanced object 
meshes are written to USD as references to the original 
mesh. The first copy of the mesh is written for real, and 
the following copies are referencing the first. Which mesh 
is considered ‘the first’ is chosen more or less arbitrarily. 


Importing USD Files 


USD files typically represent the scene as a hierarchy of 
primitives, or prims. Individual prims contain data to 
describe scene entities, such as geometry, lights, cameras 
and transform hierarchies. Blender’s USD importer converts 
USD prims to a hierarchy of Blender objects. Like the USD 
exporter, the importer does not yet handle more advanced 
USD concepts, such as layers and references. 


The following USD data types can be imported as Blender 
objects: 


e Cameras 

e Curves 

e Lights 

e Materials 

e Meshes 

e Volume 

For more information on how the various data types are 
handled, see the following descriptions of the Import 
Options. 


Xform and Scope Primitives 


USD provides an Xform prim type, containing transform data, 
which can be used to represent transform hierarchies and to 
organize the scene. Such xXform prims are imported as 
Blender empty objects. 


USD also supports Scope primitives, which are entities that 
do not contain transform data, but which serve to group 
other element of the scene. Blender doesn’t have an exact 
counterpart to the concept of a scope, so such primitives 
are imported as Blender empties located at the origin. This 
is an imperfect representation, because empty objects have 
a transform and Scopes do not, but this approach 
nonetheless helps preserve the structure of the scene 
hierarchy. 


Animations 


The importer supports two types of animation: 


e Animating transforms: If a USD primitive has time- 
varying transform data, a Transform Cache constraint 
will be added to the imported Blender object. 


e Animating geometry: Animating mesh and curve 
geometry is supported by adding a Mesh Sequence 
Cache modifier to the imported data. Geometry 
attribute (USD Primvar) animation is currently supported 
only for Color Attributes and UVs. Note that USD file 
sequences (i.e. a unique file per frame) are not yet 
Supported. 


Materials 


If a USD mesh or geometry subset has a bound material, the 
importer will assign to the Blender object a material with the 
Same name as the USD material. If a Blender material with 
the same name already exists in the scene, the existing 
material will be assigned. Otherwise, a new material will be 
created. 


If the USD material has a USD Preview Surface shader 
source, the Viewport Display color, metallic, and roughness 
are set to the corresponding USD Preview Surface input 
values. 


There is also an experimental /mport USD Preview option to 
convert USD Preview Surface shaders to Blender Principled 
BSDF shader nodes. This option can be lossy, as it does not 
yet handle converting all shader settings and types, but it 
can generate approximate visualizations of the materials. 


Coordinate System Orientation 
If the imported USD is Y up, a rotation will be automatically 


applied to root objects to convert to Blender’s Z up 
orientation. 


Import Options 


The following options are available when importing from 
USD: 


Cameras 
Import cameras (perspective and orthographic). 


Curves 
Import curve primitives, including USD basis and NURBS 
curves. (Note that support for Bézier basis is not yet fully 
implemented.) 


Lights 
Import lights. Does not currently include USD dome, 
cylinder or geometry lights. 


Materials 
Import materials. See also the experimental /mport USD 
Preview option. 


Meshes 
Import meshes. 


Volumes 
Import USD OpenVDB field assets. 


Path Mask 
Import only the subset of the USD scene rooted at the 
given primitive. 


Scale 
Value by which to scale the imported objects in relation 
to the world’s origin. 


UV Coordinates 


Read mesh UV coordinates. 


Color Attributes 
Convert the USD mesh displayColor values to Blender’s 
Color Attributes. 


Subdivision 
Create Subdivision Surface modifiers based on the USD 
SubdivisionScheme attribute. 


Import Instance Proxies 
Create unique Blender objects for USD instances. 


Visible Primitives Only 
Do not import invisible USD primitives. Only applies to 
primitives with a non-animated visibility attribute. 
Primitives with animated visibility will always be 
imported. 


Guide 
Include primitives with purpose guide. 


Proxy 
Include primitives with purpose proxy. 


Render 
Include primitives with purpose render. 


Set Frame Range 
Update the scene’s start and end frame to match those 
of the USD stage. 


Relative Path 
Select the file relative to the blend-file. 


Create Collection 
Add all imported objects to a new collection. 


Light Intensity Scale 
Scale for the intensity of imported lights. 


Material Name Collision 
Behavior when the name of an imported material 
conflicts with an existing material. 


Make Unique: Import each USD material as a unique 
Blender material. 

Reference Existing: 
If a material with the same name 
already exists, reference that instead of 
importing. 


Experimental 


Import USD Preview 
Convert USD Preview Surface shaders to Principled BSDF 
shader networks. 


Set Material Blend 
If the Import USD Preview option is enabled, the material 
blend method will automatically be set based on the 
opacity and opacityThreshold shader inputs, allowing for 
visualization of transparent objects. 


Wavefront OB] 


Reference 


Menu: File > Import/Export » Wavefront (.obj) 


OB) format is a popular plain text format, however, it has 
only basic geometry and material support. 


Note 


There is no support for armatures, lights, cameras, empty 
objects, parenting, or transformations. See Compatibility 
for more information. 


Exporting 
Export geometry and curves to the OB] format. 


Properties 
Object Properties 


Limit to: Selected Only 
Only export the selected objects. Otherwise export all 
objects in the scene. 


Scale 
Global scale to use on export. 


Forward Axis, Up Axis 


Since many applications use a different axis for ‘Up’, 
there are axiS conversion settings, Forward and Up axis - 
By mapping these to different axis you can convert 
rotations between applications default up and forward 
axis. 


Blender uses Y Forward, Z Up (since the front view looks 
along the +Y direction). For example, its common for 
applications to use Y as the up axis, in that case -Z 
Forward, Y Up is needed. 


Objects: Apply Modifiers 
Export objects using the evaluated mesh, meaning the 
resulting mesh after all Modifiers have been calculated. 


Properties 
For properties that have different settings for the 
viewport/final render pick which is used for output. One 
example where this is important is the Subdivision 
Surface Modifier. 


Viewport: Use viewport properties. 
Render: Use final render properties. 


Geometry Properties 


UV Coordinates 
Write out the active UV layers coordinates from Blender. 


Normals 


Write out Blender’s face and vertex normals (depending 
on the faces smooth setting). 


Mostly this isn’t needed since most applications will 
calculate their own normals but to match Blender’s 
normal map textures you will need to write these too. 


Colors 


Write out the active vertex colors attribute layer, if 
present. Colors are exported in “xyzrgb” OBJ extension 
format. 


Triangulated Mesh 


Write out quads as two triangles. Some programs only 
have very basic OB] support and only support triangles. 


Curves as NURBS 


Write out NURBS curves as OBJ NURBS rather than 
converting to geometry. 


Material Properties 


Export 
Write out the MTL-file along with the OBJ. Most importers 
that support OB} will also read the MTL-file. 


PBR Extensions 
Export MTL library using PBR extensions (roughness, 
metallic, sheen, clearcoat, anisotropy, transmission). 


Path Mode 
When referencing paths in exported files you may want 
some control as to the method used since absolute paths 
may only be correct on your own system. Relative paths, 
on the other hand, are more portable but mean that you 
have to keep your files grouped when moving about on 
your local file system. In some cases, the path doesn’t 
matter since the target application will search a set of 
predefined paths anyway so you have the option to strip 
the path too. 


Auto: Uses relative paths for files which are 
in a subdirectory of the exported 
location, absolute for any directories 
outside that. 


Absolute: Uses full paths. 

Relative: Uses relative paths in every case 
(except when on a different drive on 
Windows). 

Match: Uses relative / absolute paths based on 
the paths used in Blender. 

Strip Path: Only write the filename and omit the 
path component. 

Copy: Copy the file on exporting and 


reference it with a relative path. 
Grouping Properties 


Object Groups 
Write out each Blender object as an OB} object. 


Note 

Note that as far as Blender is concerned there is no 
difference between OB] Groups and Objects, this option 
is only included for applications that treat them 
differently. 


Material Groups 
Generate an OB) group for each part of a geometry using 
a different material. 


Vertex Groups 
Export the name of the vertex group of a face. It is 
approximated by choosing the vertex group with the 
most members among the vertices of a face. 


Smooth Groups 
Write Blender’s sharp edges as smooth groups. 


Smooth Group Bitflags 
Generate Bitflags for smooth Groups. 


Animation 
Animation 
Exports a numbered OB] for each frame from the start to 


the end frame. Please be aware that this can take quite a 
long time. 


Frame Start, End 
The first and last frame to export, used to determine the 
range of exported frames. 


Compatibility 


NURBS surfaces, text3D and metaballs are converted to 
meshes at export time. 


Importing 
Import geometry and curves to the OB) format. 


If there is a matching .MTL for the OB} then its materials will 
be imported too. 


Properties 


Transform 


Scale 


Value by which to scale the imported objects in relation 
to the world’s origin. 


Clamp Bounding Box 


OBJ-files often vary greatly in scale, this setting clamps 
the imported file to a fixed size. 


Forward Axis, Up Axis 
Since many applications use a different axis for ‘Up’, 
these are axis conversion for these settings, Forward and 
Up axes - By mapping these to different axes you can 
convert rotations between applications default up and 
forward axes. 


Blender uses Y Forward, Z Up (since the front view looks 
along the +Y direction). For example, it’s common for 
applications to use Y as the up axis, in that case -Z 
Forward, Y Up is needed. 


Options 


Vertex Groups 
Import OB] groups as vertex groups. 


Validate Meshes 
Checks the imported mesh data for errors and corrects 
them if needed. This slows down the importing process 
but can fix glitches in the imported mesh. 


STL 


Reference 

Category: Import-Export 

Menu: File > Import/Export > Stl (.stl) 
(experimental) 

Note 


This is the experimental STL importer designed to replace 
the much slower STL Importer Add-on 


The STL-file format is useful if you intend to import/export 
the files for CAD software. It is also commonly used for 
loading into 3D printing software. 


Importing 


Properties 


Scale 


Value by which to scale the imported objects in relation 
to the world’s origin. 


Scene Unit 


Apply current scene’s unit (as defined by unit scale) to 
imported data. 


Facet Normals 


Use (import) facet normals (note that this will still give 
flat shading). 


Forward / Up Axis 
Since many applications use a different axis for pointing 
upwards, these are axis conversion for these settings, 
Forward and up axes - By mapping these to different 
axes you Can convert rotations between applications 
default up and forward axes. 


Blender uses Y forward, Z up (since the front view looks 
along the +Y direction). For example, it is common for 
applications to use Y as the up axis, in that case -Z 
forward, Y up is needed. 


Validate Mesh 
Check the imported mesh for corrupt data and fix it if 
necessary. This option will make the importing slower but 
is often not necessary. 


Exporting 


In order to export STL-files you must currently use the STL 
Add-on. 


Scalable Vector Graphics 
(SVG) as Grease Pencil 


This format is use for interchanging vector based 
illustrations between applications and is supported by 
vector graphics editors such as Inkscape, and modern 
browsers among others. 


Warning 


The exporter only works in Object Mode. 


Import 


Options 


Resolution 
Resolution for generated strokes. 


Scale 
Generated strokes scale. 


Export 


Options 


Object 
Determine which objects include in the export. 


Active: Export only the active Grease Pencil 


object. 

Selected: Export all selected Grease Pencil 
objects. 

Visible: Export all visible Grease Pencil object in 
the scene. 


Sampling 
Precision for the stroke sampling. Low values mean a 
more accurate result. 


Fill 
When enabled, Export the Grease Pencil strokes fill. 


Normalize 
When enabled, Export strokes with constant thickness. 


Clip Camera 
When enabled, and camera view is active export only the 
strokes clipped from camera view. 


Portable Document Format 
(PDF) as Grease Pencil 


This format is use for interchanging PDFs between 
applications, it support the export of Grease Pencil 
animation creating one page in the PDF document for each 
keyframe selected. 


Warning 


The exporter only works in Object Mode. 


Export Options 


The following options are available when exporting to PDF: 


Object 
Determine which objects will be included in the export. 
Active: Export only the active Grease Pencil 
object. 
Selected: Export all selected Grease Pencil 
objects. 
Visible: Export all visible Grease Pencil object in 
the scene. 
Frame 


Determine which frames will be included in the export. 


Active: Export only the active keyframe. 
Selected: 


Export all selected keyframes as 
different PDF pages. 

Scene: Export all frames as different PDF 
pages. 


Note 


To enable multi-keyframe selection you must enable 
Multiframe Edition. See Multiframe Edition for more 
information. 


Sampling 
Precision for the stroke sampling. Low values mean a 
more accurate result. 


Fill 
When enabled, Export the Grease Pencil strokes fill. 


Normalize 
When enabled, Export strokes with constant thickness. 


Note 


The export of the Grease Pencil strokes is doing always 
from camera view. 


Add-ons 


Important 
This is work in progress. 


Documentation might be outdated and on some pages 
images, videos, and links aren’t added yet. 


Add-ons Category Listings 


3D View 

Add Curve 
Add Mesh 
Animation 
Camera 
Development 
Import-Export 
Interface 
Lighting 
Materials 
Mesh 


Video Tools 


3D View 


These add-ons relate to drawing or manipulating the 3D 
Viewport. 


3D Navigation 

Math Vis Console 

Measurelt 

Precision Drawing Tools (PDT) 
Stored Views 

VR Scene Inspection 


3D Navigation 


This custom menu is in part a virtual numpad emulator and 
a user perspective navigation tool. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click 3D View then 3D Navigation to enable the script. 


Interface 


Located in the 3D Viewport > Sidebar >» View. This add-on is 
split over two panels. 


3D Navigation 


This panel provides some common navigation tools and 
emulates the numpad shortcuts. 


View Global/Local 
Switch Global/Local view. 


View Perspective/Orthographic 
Switch perspective/orthographic view mode. 


View Camera 
View from active camera. 


Align View from 
Front/Back 


Align view to front/back. > View 


» 3D Cursor 
Left/Rig ht > Collections 
Align view to left/right. » Annotations 


y 3D Nav 


Top/Bottom , 
: . View Global / Local 
Align view to top/bottom. ilar Remarioths 
2 View Camera 
Lock View to Object Bad Align view from 
Select an object to align view, Front Back 
from the list. Left Right 
Top Bottom 
View to Select fa Lock View to Object 
Align view on selected object. os 
View to Selected 
Cu rsor Ye) Cursor | | 
World Origin World Origin View 
Cursor to Selected 
Snap cursor to center (scene 


0 , 0 , 0) : >» Pan Orbit Zoom Roll 


View 
Align view to center (scene 0,0,0). 


Cursor to Selected 
Snap cursor to object center (selected). 


Pan Orbit Zoom Roll 


This panel provides incremental “User Screen View 
Perspective” navigation in the Sidebar. 


Up 
Move towards the top of your screen. 


Down 
Move towards the bottom of your screen. 


Item 


View Too 


Left ¥ Pan Orbit Zoom Roll 
Move to the users left or left of Scyaer view Portpaciive 
screen as you view it. 


Right 
Move to the users right or right 
of screen as you view it. 


Zoom In/Out 
Zoom the view in/out. 


Roll Left/Right 
Roll the view left/right. 


Reference 

Category: 3D View 

Description: Navigate the 3D Viewport and camera 
from the Sidebar. 

Location: 3D Viewport > Sidebar > View tab 

File: Space view3d_ 3d_navigation.py 

Author: Demohero, uriel, meta-androcto 

Maintainer: Brendon Murphy (meta-androcto) 

License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


Math Vis Console 


Sometimes when writing Python scripts you stumble on 
complicated matrix transformations, ray intersections, 
rotation conversions, mesh modifications, etc. where its 
useful to view lines, points and matrices in the viewport to 
better understand the problem. 


Creating mesh data for this purpose isn’t difficult but is 
cumbersome. The purpose of this add-on is to make it as 
quick and easy as possible. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click 3D View then Math Vis (Console) to enable the 
Script. 


Instructions 


Math Vis works by displaying Python Console defined 
mathutils typed variables in the 3D Viewport. 


The following types are supported: 


Point: Vector(...) 

Line: [Vector(...), Vector(...), ...] 

Transformation: Matrix(...) 

Transformations (without translation): Quaternion(...)/ 
Euler(...) 


ew Select Add Object 


User Perspective 


(1) Collection | Cube 


ehello_world 


, Ctrl-Whee 


y, bpy.data, bpy.ops, bpy.props, bpy.types, 


from mathutils import *; from math import * 


context, D = bpy.data 


>>> hello world = Vector((1, 2, 3)) 


Create a Python Console editor. In the Python Console 
define a mathutils variable: 


hello world = Vector((1, 2, 3)) 


You should now be able to see this point in the 3D Viewport! 


Reference 


Category: 
Description: 


Location: 


File: 


3D View 

Display console defined mathutils 
variables in the 3D Viewport. 
Properties » Scene » Python Console 
Menu 

Space _view3d_math_vis.py 


Author: Campbell Barton 

Maintainer: Campbell Barton 

License: GPL 

Support Level: Official 

Note: This add-on is bundled with Blender. 


Measurelt 


Measurelt is an add-on designed for displaying measures in 
the viewport, making the process of design objects with 
exact measures, easier. These tools are extremely useful for 
any job that requires exact measurements, including 
architectural projects, technical design and 3D printing. 


Activation 


e Open Blender and go to Preferences then the Add-ons 


tab. 
e Click 3D View then Measurelt to enable the script. 


Interface 


¥ Measurelt Tools 


Hide 


Annotation 


Origin 


Bb Mesh Debug 
¥ Items 
Cube.001 


~ 


Preci 2 Units 


Override 
@® Expanda Se) apse a 
) Expandall {> Collapse all 


on 

orm 

on 

orm 

our 

On 
x Delete all 
> Configuration 


>» Render 


Overview 


Located in the 3D Viewport >» Sidebar >» View tab. The 
Measurelt Tools panel is described below. 


To view the measures you need to press the Show button. 
Many measure styles appear grayed out in the menu, these 
are active in Edit Mode. 


The Mesh Debug sub panel has extra display options. 
The Items sub panel appears after adding a measure. 
This contains the color settings for each measure. 

The Configuration sub panel contains the font settings. 
The Render sub panel contains the render settings. 


Usage 


Mesh vertex to vertex measure: Length between 
vertices in the same mesh. 

Mesh vertex labeling: Add a label to any mesh vertex. 
This allows identify easily different areas or objects in 
the scene. 

Object to object: Distance between object origins, 
vertex to origin or vertex to vertex. 

Object to origin: Distance between object origin to 
scene origin or vertex to scene origin. 

Allows work with different scales. 

The measures can be used with meshes, empties, lights, 
and cameras. 


As all measure definitions are saved in the blend-file, you 
can save the file and the next time you use it, the measures 
will be ready. 


Reference 
Category: 3D View 
Description: Tools for measuring objects in the 3D 


Viewport. 


Location: 3D Viewport > Sidebar > View tab 


File: 

Author: 
Maintainer: 
License: 
Support Level: 
Note: 


measureit folder 

Antonio Vazquez (antonioya) 
Antonio Vazquez (antonioya) 

GPL 

Community 

This add-on is bundled with Blender. 


Precision Drawing Tools 
(PDT) 


Introduction 
Download & Install 

Before You Begin 
Operations 

Design Tools 

Holes in Faces 

View Control 

Command Line 

Pivot Point 

PDT Parts Library 

PDT Trigonometrical Waves 
PDT Examples 

Worked Example - Building A Book Scanner 


Introduction 


Objects drawn with PDT and Dimensioned with Measurelt 


PDT is designed to work with Blender 2.8, and all 
subsequent builds. There are no versions for earlier versions 
of Blender. 


The key objective is to make precision modelling easier and 
more capable in Blender in order to allow Designers of all 
genres to model accurately. 


Interestingly 


There is definitely a difference in the way that “CAD 
Designers” and “Polygon Modellers” work. Polygon 
Modellers, the traditional Blender users, tend to start off 
with a basic primitive 3D mesh, like a Cube, or a Cylinder, 


then start to add Edge Loops to cut it up, to extrude 
sections to make it more complex, to add “holes” and then 
work these. They will often use Sub-Division modifiers to 
make the model more detailed, whereas CAD Designers 
consider these to largely be unsuitable and reduce accuracy. 
This means more vertices in the mesh from CAD modeller, 
but probably about the same after all has been taken into 
account. 


CAD modellers would virtually never trace off a previous 
drawing, or photograph to model something, they will 
always work from quoted dimensions only. To this end think 
about a drawing at a scale of 50:1 - a line of width 0.5mm is 
effectively 25mm thick in the real world. Many drawings 
carry the mantra “Do Not Scale” - this is for a reason, old 
tradition hand-drawn drawings are not necessarily 
accurately drawn in the first place! 


Traditional CAD Designers (I am using the term “CAD” for 
what is considered to be Computer Aided Design, products 
like SolidWorks, AutoCAD, MicroStation, etc.) tend to make 
an accurate flat loop, like the front of a bracket, or wall of a 
building , then extrude, or “loft” this into a 3D mesh. It has 
long been considered that this approach leads to more 
accurate models that could, for example, be used in 3D 
printing. 


PDT aims to introduce this method of working into Blender, 
for the benefit and inclusion of all genres of CAD Designers 
and to augment the tools for the Polygon Modeller. It has 
been developed by a former Mechanical Design Engineer 
with many years experience in drawing offices, using hand 
drawing and CAD techniques. 


Nomenclature 


There is also the situation where CAD Designers and 
Polygon Modellers use different terms, like Absolute versus 
World coordinates, Delta versus Incremental, Directional 
versus Polar. Primitives themselves are also named 
differently, Vertices, Edges & Faces versus Points, Lines & 
Polygons - PDT takes care of this by providing a file that 
users Can edit to input their own terms, including their own 
languages. 


Download & Install 


Precision Drawing Tools (PDT) now ships with Blender. In this 
case you need only enable the Add-on in User Preferences. 


However, the latest releases can be found on our GitHub. 


Downloads should only be taken the from the official 
releases page: 


https://github.com/Clockmender/Precision-Drawing- 
Tools/releases 


Patches and Commits, that may add new features and/or 
bug fixes may be downloaded from the Commits to the 
Master branch, no development code should be used in any 
Production Environment, unless you accept that it is at your 
own risk. 


Installation 


Installation should only be carried out in accordance with 
standard Blender Add-on procedure. 


@0e Blender Preferences 
Community Testing VL Install 


D pdt 


Editing 
plication Suppor. .cripts/addons/clockworxpdt/__ init__.py 
Animation 
Alan Odom (Clockmer 


Add-ons 


Internet Documentation [x] Remove 


Input 


Sav 


File Paths 


Add-on will be displayed in the “N” (Ui) Panel of the 3D view 
under its own Tab as shown below: 


¥ PDT Design 


Plane: Top(X-Y 


Tool item 


Operati.. Cursor 


View 


J+ Absolute 7 Delta Direction 


Percent Normal Arc Centre 


Intersect Order: 1,4,2,3 


PDT Create 


FlipA.. Flip % All/Act.. 


Coordinates/Delta Offsets & Other Variables 
2m Dist: 3.6056m 
An: 123.69007 


6: 25.00000 


Set AYD 2D Set A/D 3D 


Origin To Cursor 


Seg: 4 _ ae 


Radius: 1.00 Profile: 0.50 


>» PDT View Control 

» PDT Command Line 
» PDT Pivot Point 

» PDT Parts Library 


Only one PDT menu (Design) is shown as expanded, by 
default all menus are expanded when the add-on is loaded. 


Optional Button Labels, 
Messages, Descriptions, etc. 


All Button labels, Input Descriptions & Messages in PDT are 
stored in the file: pdt_msg strings.py You may edit this file to 
reflect any changes you want in button names, etc. but only 
edit the portion in quotes, do not add any new lines, or 
delete any lines and do not change any of the PDT_ 


assignments at the start of each line, for some options, 
alternatives have been suggested as shown below: 


PDT_LAB_ABS 
PDT_LAB_DEL 
PDT_LAB_DIR 
PDT_LAB_NOR 
PDT_LAB_ARCCENTRE 
PDT_LAB_PLANE 
PDT_LAB_MODE 
PDT_LAB_OPERATION 
PDT_LAB_PERCENT 
PDT_LAB_ INTERSECT 


It is recommended that you save a backup of this file ina 
safe location on your computer before performing any edits. 


You might also like to translate these into your own 
language, again only edit the message section in quotes, 
not the PDT assignments. 


Issues 


Please report any issues, or feature request, etc. using the 
Issues section of the PDT Repository 
(https://github.com/Clockmender/Precision-Drawing- 
Tools/issues), that way they can be properly tracked, 
actioned and incorporated into the add-on. 


Before You Begin 


There are a number of principles to be aware of before you 
begin working with PDT: 


Be sure to check out Latest Release Menus to see current 
layouts. 


1. 


2. 


PDT is split into several sections and this list will grow as 
the add-on develops. 

PDT has a concept of a Working Plane that applies in all 
Operations, i.e. those defined in the Design section and 
some in the Pivot Point section. 


. PDT has been designed to work as far as possible in Edit 


and Object modes with many commands equally 
applicable to both. 


. Certain Operations relating to Cursor Placement and Pivot 


Point Placement have been set to work in either Selected, 
or Relative Modes, these will be explained later. 


. PDT can be driven from its own Command Line input for 


most operations. 


The first thing to establish is the Working Plane, here a 
number of choices are available: 


1. Front (X-Z) - Uses Global X and Z axes, if you want to 


work from the Back view, the working plane is also this 
as the axes remain the same. 


. Top(X-Y) - USes Global X and Y axes, if you want to work 


from the Bottom view, the working plane is also this as 
the axes remain the same. 


. Right(Y-Z) - Uses Global Y and Z axes, if you want to 


work from the Left view, the working plane is also this 
as the axes remain the same. 


4. View - This uses axes relative to your screen, no matter 
how the 3D View is rotated, X is always view-horizontal, 
Y is always view-vertical and Z is always view-depth. 


¥ PDT Design 


Item 


Plane: Top(X-Y) v Mode: Selected 


Tool 


Front(X-Z) 
Oper 


Top(X-Y) 


hb Direction 


View 


Right(Y-Z) 
Arc Centre 


1,4,2,3 


PDT Create 


Flip Angle All/Active 


Setting the Working Plane. 


Whatever your View is set to other than View, it does not 
matter how the view is oriented, inputs are always along 
global axes. 


The second thing is whether you want Cursor, or Pivot Point 
locations to be based upon Selected, Or Current values. Set 
Selected if you want the Cursor to be placed relative to 
selected geometry, or Current if you want it to be placed 
relative to its current location. For example, moving the 
Cursor in Current mode by a Delta input of 1,3,2 will move the 
cursor relative to itself, so it moves this amount every time 
you activate the command. 


¥ PDT Design 


Plane: Top(X-Y) . Mode: Selected v 
Curre 
Operation: Cursor Omit! 


Selected 


J+ Absolute + Delta 


Percent Normal 


Intersect Order: 1,4,2,3 


PDT Creat 


Flip Angle Flip % All/Active 


Setting the Cursor/Pivot Point 
Movement Mode. 


Then you can set the type of Operation you want to 
undertake, these will be discussed on another page. There 
are a number of Operations, shown below: 


. Cursor. 

. Pivot Point. 

Move. 

. New Vertex. 

. Extrude Vertices. 

. Split Edges. 

. Duplicate Geometry. 
. Extrude Geometry. 


ONDUABRWNE 


¥ PDT Design 

Plane: Top(X-Y) . Mode: Selected 
Operation: | Move 

J Absolut Cursor 


Percent 


Interse 


Flip Ang 


Coordinates 


25.00000 


Setting the Operation Mode. 


Setting the Operation mode determines what the buttons 
below this command actually do, so for example to move 
the Cursor to Absolute location, you would select Cursor 
operation, set the input values for X, Y & Z then click the 
Absolute button. 


Below is a table showing which options are available in 
which Modes, including Edit, or Object Modes in Blender: 


Precision Drawing Tools - Available Options 


Note! Only Edit and Object Modes are supported by PDT at 
present, Further, only Mesh Objects are supported, not 
Curves for now. 


Note! From Version 1.1.8, Menu widths will affect how the 
menus are arranged, with less items per row as the width 
decreases below a threshold set in the PDT Add-on’s 
Preferences. Here are two sample Images: 


vy PDT Design 


Working Plane: View 
Move Mode: Selected E.. v 
¥ All Selected E..f: Active Only) 


(1) Select O.. Move Curs.. v 
(a) Either Set ..es + [Place »] 


Coordi.. X 3.28 
Y -7.93 
Z -0.95 


++ Absolut.. + Delta » 


Dis 5m -16.068 


++ Directio.. Flip An.. 


(b) Or Select |..es + [Place »] 


|3| Normal » |3] Arc Centr.. 


|4| Intersect » 


Order 1,2,3,4 


Do (1) at % ..elected point 
|2| %» 34.0000 


Flip % 


vy PDT Design 


Working Plane: View v 
Move Mode: Selected Entiti.. v 


¥Y All Selected Entities (Off: Active .. 


(1) Select Oper.. Move Cursor v 
(a) Either Set Coordinates + [Plac.. 


Coordina.. xX 3.28 
-7.93 
Z -0.95 


+ Absolute» + Delta» 


Distan 5m -16.06883 


++ Direction » Flip Angle 


(b) Or Select |n| Entities + [Place »] 


3] Normal » |3| Arc Centre » 


|4| Intersect.. Orde 1,2,3,4 v 


Do (1) at % between selected p.. 


|2| % » 34.0 Flip % 


Note! PDT Add-on Preferences now also sets the Parts 
Library location and Debug mode. 


Official Community Testing v, Install... Refresh 


nee 


Enabled Add-ons Only All v £9 pdt 


v 3D View: Precision Drawing Tools (PDT) 

Descriptio.. Precision Drawing Tools for Acccurate Modelling 

Location: View3D > UI > PDT 

File: /Users/apple/Library/Application Su..ion-Drawing-Tools-master/_ init__.py 
Author: Alan Odom (Clockmender), Rune Morling (ermo) 


Version: Oo 


Internet: 2 Documentation (x) Remove 


Preferences: 


Enable console d..t from PDT scripts UI Width Cut-off 350 


Parts Library: /Users/apple/Documents/blender/projects/scanner-nocam.. jam 


Operations 


This section will deal with explaining what the various 
Operations do. You can see a full list of available options in 
the table on the previous page (Before You Begin) for both 
Edit and Object modes. 


Cursor: 


This operation is concerned with placing the Cursor 
according to the various operators. it can place the Cursor 
by Absolute coordinates, Delta Coordinates, Directional 
Coordinates and either relative to its current position or an 
Active vertex, or Object. 


Pivot Point: 


This operation is concerned with placing the Pivot Point 
according to the various operators. it can place the Cursor 
by Absolute coordinates, Delta Coordinates, Directional 
Coordinates and either relative to its current position or an 
Active vertex, or Object. 


Move: 


This operation is concerned with Moving Geometry, or 
Objects according to the various operators. geometry can 
be moved by Absolute coordinates, Delta Coordinates, 
Directional Coordinates. in Edit mode, selected geometry is 
moved, in Object Mode selected Objects are moved. 


Example 1: Move selected geometry 0.8 units at 34 
degrees in front view, Set Operation to Move, set Working 
Plane to Front(x-Z), set Distance to 0.8, set angle to 34, 
select geometry, click Direction button. 


You can see the geometry Before and After the move. 


New Vertex: 


This operation is concerned with placing a New Vertex 
according to the various operators, the new vertex is set 
selected so it can then be manipulated. 


Example 1: Place a New Vertex and the intersection of two 
edges, set Operation to New Vertex, set Working Plane to 
Front(X-Z), select two edges, click Intersect button. 


A new Vertex has been placed at the intersection of the two 
Edges. 


Extrude Vertices: 


This operation only Extrudes the vertices from selected 
geometry, so if you select a Face, and use this operation, 
only the vertices of the face will be extruded. this can also 
be used to “chase” a single vertex around a path, for 
example the edge of a complex bracket. 


Example 1: Extrude the vertices of a face, set operation to 


Extrude Vertices, select the face, set some delta offsets, click 
Delta button. 


Tools 


Set A/D 2D 


Only the Vertices from the Face have been extruded as 
edges. 


Split Edges: 


This operation will Split edges according to the operator 
you use. It will result in the face having one more vertex per 
operation, so a quad becomes a 5 sided Ngon. This initial 
split point is halfway along the chosen edge(s). If the system 
detects that you are going to split connecting edges of a 
face, which would ruin the topology, an error is given and 
the operation does not complete. 


Example 1: Split the edge of a face at 25% of the way 
along it, set Operation to Split, set Percent to 25, select one 
edge, click Percent button. 


Example 2: Split two edges of an extruded prism and move 
the split 0.8 in X, 0.4 in Z, set Operation to Split, set 
Working Plane to Front(X-Z), set X to 0.8 & Z to 0.4, select 
two edges, click Delta button. 


You can see Before and after of the two examples described 
above. 


Duplicate Geometry: 


This operation will duplicate geometry according to which 
operator is chosen. 


Example 1: Duplicate selected geometry 3 units at 78 
degrees in front view, set Operation to Duplicate Geometry, set 
working plane to Front(X-Z), set Distance to 3 & Angle to 78, 
click Direction button. 


You can see Before and After states of a Duplication. 


Extrude Geometry: 


This operation will Extrude geometry, not just the vertices 
as with Extrude Vertex, but faces and edges as well. 


Example 1: Extrude selected face 1 in X, 0.5 in Y and 0.6 in 
Z, set Operation to Extrude Geometry, set Working Plane to 
Front(X-Z), set X, Y & Z to 1,0.5,0.6 respectively, click Delta 
button. 


You can see the Top Face has been Extruded in all three axes 
as one operation. 


Design Tools 


The Menu for PDT Tools: 


Tools 


set A/D 2D set A/D 3D 


Join 2 Verts Ongin To Cursor 


Rotx-Movy 


Intersect All 


Fillet 


Radius: 1.00 


This section of the menu deals with the Tools, which work 
with their own variables, in some cases, they also use the 
Working Plane. 


Set A/D 2D: 


This button is used to measure the angle relative to 
horizontal in the Working Plane subtended by two vertices, 
or two objects. You can see a full list of available options in 
the table on the previous page (Before You Begin) for both 
Edit and Object modes.. Here the working Plane setting is 
important, because, if set to View, the output will be 
calculated relative to the views local axes, however the view 


is oriented, otherwise it works with the global axes for the 
view. 


Output: Sets the Distance, Angle, X, Y & Z input variables. 


Selection: in Edit Mode select two vertices with your mouse, 
the Active vertex is considered to be the centre of rotation, 
or fulcrum point. In Object Mode the Active object is 
similarly considered. 


Example 1: Set the Input variables to two vertices in Edit 
Mode in Front view, set Working Plane to Front, select the 
rotational vertex, select the centre vertex. The Distance 
variable is set to the apparent separation fo the two vertices 
in the front view, the Angle is set to the apparent angle 
relative to horizontal in the front view, the X, Y & Z inputs 
are set to the delta offset between the two vertices in the 
view axes. 


Example 2: Set the Input variables to two objects in Object 
Mode in Top view, set Working Plane to Top(X-Y), select the 
rotational object, select the centre object. The Distance 
variable is set to the apparent separation of the two objects 
in the top view, the Angle is set to the apparent angle 
relative to horizontal in the top view, the X, Y & Z inputs are 
set to the delta offset between the two vertices in the view 
axes. 


Dis: 2.3324m 


A: 30.96375 
1.2m %: 25.00000 
Tools 
Set A/D 2D Set A/D 3D 
Join 2 Verts Origin To Cursor 
RotX-MovY Taper 


Intersect All Bisect Edge-Face 


Parameters set from two Vertices in Front Working Plane. 


Set A/D 3D: 


This button is used to measure the angle subtended by 
three vertices, or three objects. You can see a full list of 
available options in the table on the previous page (Before 
You Begin) for both Edit and Object modes. Here the working 
Plane setting is irrelevant because the angle is calculated in 
3D space. 


Output: Sets the Distance, Angle, X, Y & Z input variables. 


Selection: in Edit Mode select three vertices with your 
mouse, the Active vertex is considered to be the centre of 
rotation, or fulcrum point. In Object Mode the Active object 
is similarly considered. 


Example 1: Set the Input variables to three vertices in Edit 
Mode, select the two rotational vertices, select the centre 
vertex. The Distance variable is set to the real separation of 
the first vertex and centre vertex in the front view, the 
Angle is set to the real angle between the three vertices, X, 
Y & Z inputs are set to the delta offset between the first and 
centre vertices. 


Example 2: Set the Input variables to three objects in 
Object Mode, select the two rotational objects, select the 
centre object. The Distance variable is set to the real 
separation of the first vertex and centre vertex in the front 
view, the Angle is set to the real angle between the three 
vertices, X, Y & Z inputs are set to the delta offset between 
the first and centre objects. 


Join 2 Vertices: 


This button is used to join two disconnected vertices that do 
not form part of the same face. You can see a full list of 
available options in the table on the previous page (Before 
You Begin) for both Edit and Object modes. Here the working 
Plane setting is irrelevant. This Tool works only in Edit Mode. 


Selection: Select two vertices by any method. 


Example 1: Join two vertices, select two vertices that do 
not form part of the same face. If the vertices do form part 
of the same face you should use the standard Blender Join 
command (hotkey j). 


The two Vertices have been joined to form, in this case, a 
Closed Loop, Before on the Left, After on the Right. 


Origin To Cursor: 


This button is used to set the Object Origin to the current 
Cursor location. You can see a full list of available options in 
the table on the previous page (Before You Begin) for both 
Edit and Object modes. Here the working Plane setting Is 
irrelevant. This Tool works in Edit & Object Modes. 


Selection: None required in Edit Mode, select one object in 
Object Mode. 


Example 1: Set Object Origin to 1,3,2 in Edit Mode, set X, Y 
& Z inputs to 1,3,2 respectively, set Operation to Cursor, click 
Absolute button to move cursor. Click Origin To Cursor Tool, 
Origin is moved, but geometry is not moved from its 
absolute position in World Space. 


Taper: 


This button is used to set the Object Origin to the current 
Cursor location. You can see a full list of available options in 
the table on the previous page (Before You Begin) for both 
Edit and Object modes. Here the working Plane setting is 
irrelevant. This Tool works only in Edit Mode. 


Uses: Move/Rot Axis Selector. 


Selection: Select vertices to be moved, then select fulcrum 
vertex with SHIFT+Mouse, active vertex is considered the 
rotational centre. 


Example 1: Taper the end of a cube in front view - 25 
degrees, set Angle to -25 degrees (25 degrees clockwise), 
select all vertices to be tapered, SHIFT+Mouse select centre 
of rotation point vertex, set Move/Rot selector to RotY,Movx, 
set Working Plane to Front(X-Z), click Taper. 


The significance of RotY,Movx is that the Y axis is used as the 
rotation axis and vertices will be moved along the X axis, in 
View Working Plane Mode, remember these are then Local 
axes, not Global ones. 


After the face is now at 65 degrees to horizontal. 


Intersect All: 


This button is used to cut edges at any point they intersect 
with other selected edges. You can see a full list of available 
options in the table on the previous page (Before You Begin) 
for both Edit and Object modes. Here the Working Plane 
setting is irrelevant. This Tool works only in Edit Mode. 


Selection: Select a set of Edges by any method. 


Example 1: Cut a set of edges at every point where they 
overlap, or intersect, select required edges, click Intersect 
ALL button. 


Selected Edges Before. 


Selected Edges After, some have been removed. 


Selected Edges After Extrusion. 


Bisect: 


This button is used to form a Bisecting Edge between two 
other co-planar edges. You can see a full list of available 
options in the table on the previous page (Before You Begin) 
for both Edit and Object modes. Here the Working Plane 
setting is irrelevant. This Tool works only in Edit Mode. 


Selection: Select two Edges by any method. 


Example 1: Bisect two edges, select 2 co-planar edges, 
click Bisector button. 


Bisected Edges, Before on Left, After on Right, you can see 
both Bisectors have been drawn. 


Edge To Face: 


This button is used to project an edge to its intersection with 
a disconnected face. You can see a full list of available 
options in the table on the previous page (Before You Begin) 
for both Edit and Object modes. Here the Working Plane 
setting is irrelevant. This Tool works only in Edit Mode. 


Selection: Select only one edge and one disconnected face. 
The intersection point need to lie within the area of the face. 


Example 1: Extend one edge to a disconnected face, select 
one edge and one face, click Edge To Face. 


Edge Extended, Before on Left, After on Right. 


Fillet: 


This button is used to fillet the corners of geometry, either 
closed edge loops, or edges. You can see a full list of 
available options in the table on the previous page (Before 
You Begin) for both Edit and Object modes. Here the working 
Plane setting is irrelevant. This Tool works only in Edit Mode. 


Uses: Radius, Segments & Profile inputs & Use Vertices 
checkbox. 


Selection: Any number of vertices, or edges by any method. 


The Profile settings is the same as for Blender Bevel 
command, i.e. ranges from O to 1, 0.05 is a convex fillet, 0.5 
is a concave fillet. 


Example 1: Fillet a closed loop of edges at each corner 
radius 0.5, 6 segments, profile 0.5, select corner vertices to 
be filleted, set Radius to 0.5, set Segments to 6, set Profile to 
0.5, check Use Vertices. 


The image shows two Before and Afters, in the bottom set 
Use Vertices was checked, in the top set it was not, this is 
how to fillet edges. 


Another Before and After, you can see the settings used to 
produce this. 


Tip! Using an even number of segments will result in better 
topology (no tris) where three bevels meet at 90 degree 
offsets, for example. 


Note! From version 1.1.8 the Fillet Tool now has an 
Intersect checkbox. When this is activated the toll will 
accept only two non-connected edges, or four vertices 
representing two non-connected edges. These two edges 
and first intersected, then the intersection vertex is filleted. 
The Use Verts checkbox is ignored in this mode of operation. 
Should these two edges not intersect in the Working Plane, an 
error is returned. 


Two examples of Before on the Left and After on the Right. 


Holes in Faces 


This section will look at some alternative ways of dealing 
with holes in surface. In Blender, holes are generally dealt 
with by using boolean modifiers, or boolean operations in 
Edit mode. These result in many quad, or tri faces on what 
is essentially a flat surface. CAD Designers would 
traditionally want a flat complex face to be an Ngon, since 
Sub-Division modifiers would not be used for this type of 
modelling. 


Alternative methods include using 2D curve surface, where 
any internal faces are treated as holes. The disadvantage of 
this system is that to include these in a vertex mesh they 
must first be converted to meshes, resulting in many tris on 
the flat face, again causing problems because these cannot 
be bevelled. 


PDT Approach to Holes: 


In PDT, we have adopted a new approach of cutting the 
front face into as few Ngons as possible to accommodate 
holes. This is still not ideal and two other options are being 
advocated: 


e Allow holes in faces as they are in 2D curve surfaces 
and CAD software packages. 

e Introduce “Hybrid” objects that can accommodate 2D 
curve surfaces and vertex meshes. 


Allowing holes would mean that certain functions, like 
sculpting would not be possible, so this type of face would 
be excluded from such functions. 


You can see the front face is in fact two faces split across 
the hole. 


The process was to remove the existing front face, draw the 
hole as a cylinder, then use PDT Join 2 Vertices to make the 
joining edges between the outer edge and the hole, then 
making two faces, by selecting edges and using the Blender 
Face (Hotkey F) command. 


Below is an example of a 2D curve surface, with the settings 
Shown to make it a filled surface: 


These curve surface can then be placed in front of a mesh 
object to make a face, but this will require Align tools in 
awkward rotational angles, something we have not released 


yet. The proviso on this is that you can never Apply the 
rotations used, but that is no hardship. 


Below is what this looks like if converted to a mesh, 
producing totally unsuitable topology for precision 
modelling, or even bevelling: 


This object has 146 faces, versus only 3 curves for the 
donor 2D curve surface. 


Here is another example of a holed surface using PDT 
techniques: 


Count the Faces! - 49 holes, 3 faces on the front and 3 on 
the back. 


View Control 


The Menu for View Control. 


¥ PDT View Control 


View Rotation Rotate Abs 


Isometric View 


This section deals with the View Control section of PDT, this 
menu uses its own variables. 


Rotate Absolute: 


This button will rotate the view using absolute rotational 
values as set in the three inputs underneath. These are X, Y 
& Z rotations and should be entered as degrees, not 
radians. A rotation of 0,0,0 is the same as Blender Top view. 


Uses: X Rot, Y Rot & Z Rot. 


Example 1: Rotate view 25 in X, 17 in Y and 90 in Z, set X 
Rot, Y Rot & Z Rot to 25, 17 & 90 respectively, click Rotate 
Abs button. 


The next row of icons Orbit the view about its horizontal & 
vertical screen axes, or Roll the view about its normal axis 
to your screen. All of these 5 options use the Angle input 
from this menu. 


Orbit Left: 


Set Angle, click Orbit Left icon (Left Arrow), view rotates 
about its vertical axis. 


Orbit Right: 


Set Angle, click Orbit Right icon (Right Arrow), view rotates 
about its vertical axis. 


Orbit Up: 


Set Angle, click Orbit Up icon (Up Arrow), view rotates about 
its horizontal axis. 


Orbit Down: 


Set Angle, click Orbit Down icon (Down Arrow), view rotates 
about its horizontal axis. 


Roll View: 


Set angle, click Roll View icon (Roll), view rotates about its 
normal axis to your screen. 


Isometric View: 


This button sets the view orientation to what a 
Draughtsman understands as a true Isometric view. This is 
achieved by rotating a Front view 45 degrees about its 


vertical axis, then 35.2644 degrees about its horizontal axis. 


In the system this is achieved using an Absolute View 
Rotation of: 


Quaternion(0.8205, 0.4247, -0.1759, -0.3399) 


The Top Plane Axes Appear to be at 30 degrees to the View’s 
Horizontal Axis. 


Command Line 


This section deals with the PDT Command Line, a system 
whereby PDT Operations & Tools can be entered as keyed 
text rather than using the buttons and input boxes. 


The Menu For Command Line 


Here the Cursor has been set with the command cd-1.5,, 
placing the cursor negative 1.5 in X from the selected 
vertex. 


PDT has a Command Input, which activates when you 
press Return. this takes two letters, followed by numbers 
separated by commas “,”. Valid Primary letters are, can be 
Capitals, or lower case: 


e C = Cursor commands. 

e D = Duplicate commands 

e E = Extrude Geometry commands 
e F = Fillet Commands 

e G = Grab, or move commands. 

e N = New Vertex commands. 

e P = Pivot commands. 

e S = Split Edges. 


e V = Extrude Vertices only, not their edges, or faces. 
Valid Secondary letters are, can be capitals, or lower case: 


e A = Absolute, or World coordinates and requires 3 
numbers separated by 2 commas, zeros may be 
omitted, so *cd2,,1* is valid. 

e D = Delta, or incremental coordinates and has the same 
requirements as A. 

e | = Direction and requires a distance and an angle, 
separated by a comma, from View Horizontal, so 
ei2,135.6 means extrude geometry 2 units at 135.6 
degrees from positive view X axis. Valid Angle range is 
+-180. 

e P = Use a percentage value to, for example, split an 
edge, so sp30 means split edge at 30% of the way 
along it. 


Principles: 


To operate the Command Line, first you must RMB-click in 
the input box, then type, or amend the command there, 
then press Return to activate the command. | will explore 
ways of capturing commands directly from the keyboard, 
maybe by using a “trigger” input first. 


For example, key ALT+P first then the command, with a 
“watcher” routine to send subsequent inputs to the 
command line, | do not Know if this is possible yet. 


Operations (First Letter): 


Cursor Commands will use the Plane setting for commands 
related to distance and angle and also will use the Mode 


setting of either Current, or Selected. This setting related to 
whether incremental cursor changes are relative to the 
current position of the cursor, or the Active vertex. 


A command of cp30 will place the cursor 30% of the way 
between two selected vertices for example. Error messages 
will tell you if your command is not a valid option, or if you 
do not have sufficient vertices/objects selected, or if you do 
not have sufficient values in your command. For example, d 
options (delta) require three values separated by two 
commas, p options require only one value. Mathematical 
Expressions are not evaluated in this way. In other cases, all 
missing values, or invalid values are converted to O. 


Pivot Point Commands, like cursor commands, will use the 
Plane setting for commands related to distance and angle 
and also will use the Mode setting of either Current, or 
Selected. This setting related to whether incremental cursor 
changes are relative to the current position of the cursor, or 
the Active vertex. 


A command of pi1,135 will place the Pivot Point 1m at 135 
degrees from the Active vertex. 


» PDT Parts Library 


Grab commands will move selected objects, or vertices by 
the values input, so if Plane is set to View and the command 
iS gil.5,38.75 the selection will be moved a distance of 1.5 
at 38.75 degrees to the view’s horizontal axis and in line 
with the views orientation to your screen. 


New Vertex commands will place a new vertex as 
described by the values, so nal.5,,1.2 will place a new 
vertex at Absolute (Global if you prefer) X =1.5,Y=0,Z= 
12: 


Extrude Vertices commands will only extrude the selected 
vertices, not their associated edges, or faces. A command of 
vd,3, will extrude the selected vertices 0 in X, 3 in Y and 0 
in Z. 


Duplicate Geometry commands will duplicate the selected 
geometry. A command of dd,5, will duplicate the selected 
geometry 0 in X, 5 in Y and O in Z. 


Extrude Geometry commands will extrude the selected 
geometry, edges and faces included. A command of 
ed1,3,2 will extrude the selected geometry 1 in X, 3 in Y 
and 2 in Z. 


Split commands can be operated in a number of geometry 
situations, so for example, if you want to split a Face like 
this: 


» PDT Design 
Y PDT View Control 


YR: 0° TA he 


10.00 i G8 8 8. 


sp25 
> PDT Pivot Point 
» PDT Parts Library 


Image showing the new vertex inserted 25% of the way 
along the edge using the command sp25. 


In this next scenario, we have split an extruded Face, 
producing an Ngon: 


» PDT Design 


» PDT Pivot Point 


» PDT Parts Library 


Command was sdO.2,, a new edge has been created and 
topological integrity preserved. 


In all cases the edges are split in two and then new 
vertex/vertices from these operations are then moved 
according to the command parameters. If you select such a 
combination of edges as to make a face, an error message 
is returned and the operation cancelled as this will, in all 
likelihood, result in bad topology. 


Fillet commands will Fillet, or Bevel a corner, for single 
vertex corners, as in an edge loops, use the v_ second 
letter, for edges, use _e second letter. this command 
requires 3 values; radius, number of segments and profile. 
Profile should be in range 0 to 1, 0.005 is a_convex_ fillet, 
0.5 is a_concave_ fillet. So a command of fv1.5,6,0.5 will 
fillet vertices to radius 1.5, 6 segments, concave fillet. 


Note! 


Obviously unworkable commands like da1,3,4 (duplicate 
geometry to an absolute location, resulting in all duplicate 
vertices having the same location) will quite reasonably 
result in an error message. 


Maths Mode: 


Maths function (“M” primary letter) enable maths 
calculations to be input into other input boxes in PDT 
Design, so for example if you want to set the X input to 1.2 
* Sine(54), that can be done. Additional Second Letters are 
introduced for this function, namely: 


e X - send output to X Coord. 
e Y - send output to Y Coord. 

e Z-send output to Z Coord. 

e D - send output to Distance. 

e A- send output to Angle. 

e P - send output to Percent. 

e O - Send Output to Maths Out Field. 

So, in the option quoted above, a command of 
mx(1.2*sin(radians(54))) results in the X coord being set 
to 0.97082: 


Coordinates/Delta Offsets & Other Vari.. 
X: 0.97082m Distance: 3m 
A: 78.00000 


Ssss5 


Tools 


Set A/D 2D Set A/D 3D 


Join 2 Verts Origin To Cursor 


RotY-Movx . Taper 
Intersect All Bisect Edge-Face 
Fillet Seg: 6 Use.. 


Radius: 0.30 Profile: 0.05 


» PDT View Control 

¥ PDT Command Line 
Plane: Front(X.. Mode: Selected » 

Comiand Line, uses Plane & Mode Options 


mx(1.2*sin(radians(54))) 


Alternatively a command of md4*sqrt(2) results in the 
Distance input being set to 5.65685: 


Coordinates/Delta Offsets & Other Vari.. 


X: 0.970682m Dis: 5.6569m 


‘fy 10m A: 


Zz: Om %6: 


Tools 


Set A/D 2D Set A/D 3D 


Join 2 Verts Origin To Cursor 


Roty-Movx Taper 
Intersect All Bisect Edge-Face 
Fillet Seg: 6 Use .. 


Radius: 0.30 Profile: 0.05 


» PDT View Control 
¥ PDT Command Line 
Plane: Front(X.. » Mode 
Comand Line, uses Plane & Mode Options 


md4*saqrt(2) 


From Version 1.1.8, Maths Function now can output to the 
Maths Output field: 


vy PDT Command Line (? for help) 


Plane View v Mode Selecte.. v 


Comand Line, uses Plane & Mode Op.. 


mosqrt(34)*(2.3**3) 2) 


Maths Output 


Here the command mosqrt(34)*(2.3**3) was used, 
meaning; Maths, Output, Square Root of 34 times 2.3 cubed. 


This value can be copied by floating your mouse over the 
field and keying CTRL+C, it can then be pasted anywhere. 


There is also a Re-Run Last Command button to submit 
the last command line input, as shown in the image above. 


Command Line Additions for 
v1.2.0 & above. 


With the introduction of v1.2.0, more commands have been 
introduced to the Command Line module, they are: 


ad2 Does what Set A/D 2D button does, ie. measure 
distance & angle from 2 points. 


ad3 Does what Set A/D 3D button does, ie. measure 
distance & angle from 3 points. 


j2V Does what Join 2 Verts button does, i.e. join 2 vertices 
into an edge. 


bis Does what Bisect button does, i.e. bisect two 
intersecting edges. 


etf Does what Edge To Face button does, i.e. extrude edge 
to intersecting face. 


intall Does what /ntersect Al! button does, i.e. break a set of 
edges where they intersect. 


tap Does what Taper button does, i.e. taper geometry ata 
user defined angle and axis set. 


otc Does what Origin To Cursor button does, i.e. set the 
object origin to the cursor location. 


Then there are the three special cases of nml, cen & int. 
These should be preceded by the Operation letter, see Valid 
First Letters above, so putting the cursor at the intersection 
of two edges would be done with the command cint, 
creating a new vertex at the normal intersection would be 
done with the command vnml. 


Clicking on any of the buttons in PDT Design Operations, Or PDT 
Design Tools will write the equivalent command line 
expression into the command line input. So for example, 
filleting edges at 0.5 radius, 6 segments and 0.05 profile, as 
set in the inputs & using the Fi//et button will write 
fe0.5,5,0.05 into the command line input. 


Entering a blank expression into the command line will 
result in No Action, i.e. it will be ignored. 


Pivot Point 


The PDT Pivot Point, hereafter PP, is intended to provide a 
location for rotating and scaling geometry in Edit Mode Only. 
It works as an independent location to the 3D Cursor. It can, 
however, be placed relative to Object Geometry. 


The Menu For Pivot Point 


xX 1 Y¥: 1.00 Zz 


(BPP Write ral 


» PDT Parts Library 


Here the pivot point has been placed relative to the selected 
vertex. 


Operations: 


Most operations only work in Edit Mode, so these are 
greyed out if you are in any other mode. 


Starting from the top, the first row is the Show Pivot button 
with three inputs alongside. 


To show the PP, click the Show button, to remove it press Hide 
button, Show will change to Hide when PP is displayed. 


You can still use the PP location, whether you can see it, or 
not. 


The three inputs are; Size Factor ranging from 0.2 to 2 and 
will adjust the relative size of the PP, the PP is drawn 
relative to the 3D View scale. The next is the width and this 
determines how bold the PP arms are ranging from 1 to 5. 
The last is the Alpha and determines the translucency 
(Colour Alpha) of the PP, values range from 0.2 to 1. 


The next row shows the Pivot Location, values can be 
entered here, or the boxes may be “scrubbed” and the PP 
will move as you do So. 


On the next row iS To Selected, which locates the PP ona 
selected set of geometry. The middle button is To Cursor, 
which locates the PP at the 3D Cursor location. The right 
button is To Origin, which locates the PP on the selected 
Object’s Origin, you must have a selected Object. 


» PDT Parts Library 


Here the PP has been located on the weighted centre of the 
selected face. 


The next row has Rotate and Angle, To rotate selected 
geometry about the PP, first set the Angle and click Rotate. 
Geometry is rotated about the View Plane (an axis normal to 
your screen). 


Here the selected geometry has been rotated 30 degrees 
about the PP. 


The next row has Scale on the left, this button is used to 
scale the selected geometry about the PP. this uses factors 
as set in the last row showing X, Y and Z values. the scaling 
is performed about the Global Axes. There are many ways in 
Blender to Scale about different axes, so it was decided not 
to replicate all this, this is the function | use the most for 
scaling. 


The button on the right is Cursor To Pivot, it will locate the 
3D Cursor to the PP, this is useful if you want to use other 
Blender techniques for rotating, scaling, etc. but want to use 
the PP location. 


The PP cannot be used to move geometry, it was decided 
that there are already sufficient methods of doing this in 


Blender. 


Setting Scales by Two 
Measures: 


Underneath you will see the Scale Distance & System Distance 
Inputs, System Distance is merely a copy of Distance from the 
PDT Design Section. This can be set by a variety of methods, 
one of which is to select two vertices and then use the Set 
A/D 2D Tool, found in PDT Design, or you can just type a 
value in. 


There are circumstances where you know that a dimension 
in the model, lets say two vertices measure 14.3 units and 
that is wrong. You know that either a section, or the whole 
mesh needs scaling so this dimension becomes 16.2. 
Instead of you having to work out the scale factor yourself, 
you can merely type 16.2 into Scale Distance, having set 
System Distance to 14.3 and the system will calculate the 
scales for you, in this case; 1.14085. Should you only want 
to scale in one axis, set the other two to 1. 


You would then select the required geometry, set the 
position of the PP and use the PP Scale button. 


Read & Write PP to Object: 


You can write the PP location to the Object using the PP 
Write button, these are stored in the form a Custom Property, 
you will be required to confirm this, clicking OK on the 
popup accepts this operation, moving your cursor off the 
confirm dialogue cancels the operation. This facility allows 
you to store a PP location, easily readable, against each 


object, this could be, for example, the rotational centre of a 
hydraulic cylinder for example, where you do not want this 
location to also be the object origin point. 


You can then read back this information to place the PP 
using the PP Read button. If the custom property are not 
there, either because it hasn’t been written, or because you 
have deleted it, an error is displayed. 


Confirmation is Required for the Write Operation. 


Location X 


1.000 
1.000 
1.000 


RotationMode XYZ Euler 
>» Delta Transform 


Relations 


Motion Paths 
Visibility 


> Viewport Display 


¥ Custom Properties 


Add 


PDT_PP_LOC [4 924346924, -1.0, 


This is the custom property stored against the Object. 


PDT Parts Library 


The Menu For Parts library 


Y PDT Parts Library 
Append Link Objects 
Objects Searc 
Torus 
Collections 
Material Holder 
Materials 


Yellow 


Pe) Show Library File 


This module is in its infancy for releases up to and including 
1.1.5 and is an attempt to organise a collection of parts, as 
objects, in a central repository. This library will consist of 
Objects, Collections and Materials. For now, these are 
placed in a holding blend file in Blender’s: 


— /Scripts/Addons/clockworxpdt” folder (the location of 
the PDT Add-on). 


Principles: 


The concept is to store parts as either individual objects, or 
in the case of more complex parts, like an engine assembly 
for example, as collections. The way Blender handles 

materials for append, or linked, objects is that if you load an 


object using Append, it will bring the materials of the object 
with it. lf you append the part many times, you get many 
copies of the same material - not a situation that is efficient. 
So the recommendation for this trial system is to leave the 
materials off the objects and store them either against a 
“holder” object, or set a ffake user* so the material is 
always held in the library blend file. Then you can append, 
or link the material once and assign it to many copies of the 
appended, or linked object. 


The plan is to expand the system so users can send objects, 
or collections, or material from their current open blend file 
to the Library blend file. This will be a further development 
in a later release, if this is possible. Parts Libraries have 
been in existence in CAD systems since the 1980’s where 
they were called “Cells” and had one, or many “Cell 
Libraries” to store them in, each cell had a user defined 
origin point that was used to place the part. The process 
was to put the cursor where you wanted the part, then call it 
by name and it would be placed with its origin at the cursor 
location. 


PDT Parts Library uses the same method to store, recall and 
place parts at the cursor location: 


This shows the Parts Library Menu and some sample parts 
brought in by either Appending, Or Linking. 


Parts Library File: 


The Parts Libraries can be located wherever you want them 
on your system. The location of your file, a normal Blender 
blend file, is set in the PDT Add-on Preference (User 
Preferences => Add-ons Tab): 


Interface Officia Testing ab, Install... | 
Themes je) 

Viewport 

Lights de 1 cccurate Modelling 

Editing 


yn Suppor. .cripts/ lockworxpdt/__ init__.py 
Animation 


Documentation [x] Remove 
Input 


Navigation Preferences 


Keymap Parts Library. /Users/mac/Documents/blender libs/engines. blend 


You can either type in the location and name of the file, or 
click the Folder icon and use Blender file select tools to 


navigate to your file. The Selectors in PDT are then 
automatically updated with your file’s objects, collections 
and materials, subject to any search criteria. this can be 
changed at any time in your session to access data from 
another library file. 


The Options are: 


Append - this will append the chosen Object, Collection, or 
Material from the library into your current blend file. 


Link - this will link the chosen Object, Collection, or Material 
from the library into your current blend file. 


Whether you are going to work with objects, collections, or 
materials depends on the setting of the Selector next to 
the Link button. 


The next three Selectors will show the Objects, Collections 
and Materials in the Library blend file, either all of them, or 
filtered by the Search input next to each Selector. 


The Search strings consist of any characters that appear 
anywhere in the Object’s, Collection’s, or Material’s Name. 
So searching with gear in the search box will find, for 
example, objects named 25T 20mm gear, Or gears — 20mm 
25teeth, etc. 


The principle of operation is therefore: 


e Place the 3D cursor where you want the objects to be 
located. 

e Enter any required search criteria, to narrow the list 
shown in the selector. 

e Select the type to work with; Objects, Collections, or 
Materials. 


e Select the required object, collection, or material. 
e Click either Append, Or Link. 


At the moment, if you bring in a collection, ALL objects in 
that collection are placed at the cursor location. The 
purpose of this is to bring in complex models and assume 
that they will be placed “as one” at the cursor location, this 
also assumes that they were built as a number of objects 
with a shared origin in the library. 


The suggestion at this stage that materials can be imported 
and used on each object to which they are appropriate, it 
may be that many parts share a common material, in which 
case, using this approach does not result in many duplicate 
materials in the blend file. 


The Show Library File button will show the user in a popup 
the location of the parts library file, this is also printed to 
the console, if you are running Blender from a Terminal. This 
purpose of this is to make it easier to locate the parts library 
for editing. 


The library file can be opened in Blender and edited like any 
blend file to add your own objects, collections and materials. 


Here is an example of a series of engines that are used in 
many different bikes, trikes and three-wheelers, these have 
been Appended from the library file to a working blend file, 
then the materials assigned: 


Each engine is modelled as a set of individual objects, 
organised as collections in the library blend file. All 
individual objects in each collection share a common origin 
point so they can be placed in the correct relative location. 


An alternative under consideration at this stage would be to 
store in the parts library, only the unique components of 
these engines, they share cylinder barrels for example, then 
append, or link these into a project file and build whichever 
engine is required. 


The system has been left deliberately fluid at this stage in 
development, so ideas can be explored and the system 
refined. it may be obviated by developments in Blender 
towards better and more capable Asset Management 
Systems. 


PDT Trigonometrical 
Waves 


The Menu for Trigonometrical Waves 


Y PDT Trigonometrical Waves 


Working Plane: Front(X-Z) 

Wave... Cosine ~v Cycles # 2 
Amplitud 1.00 Cycle Le 2.00 

m@ Cube <x @ Empty Object 
Resolution 18 Tangent 10.00 


Start Loc... 0.00 0.00 0.00 


“Generate Wav... Absolute 


This section of PDT is used to generate Trigonometrical 
Waves in a selected Object. In order to enable the Generate 
button, the use must first select an object using the Object 
Selector Dox. 


There are then a number of parameters that need to be set: 


The Working Plane - this is just a duplicate display of the 
main PDT Working Plane. 

The wave Form - Sine Cosine, or Tangent. 

The number of cycles - each cycle is 180 degrees, NOT a 
full circle, so a value of 1 will result in one peak with a 
sine wave for example. 

The Cycle Length - the length in blend file units of one 
cycle. 

The Amplitude - the height of the wave. 


e Whether to Empty the target object, set to true this will 
delete all vertices in the target object. 

e The Resolution - the number of vertices on one cycle. 

e If you are generating a Tangent wave, the maximum 
amplitude of the wave. Tangent functions range from O 
to infinity over a 90 degree wave, so this limits the 
extent to which the tangent wave will extend. 

e The Start Location - the point at which the first vertex 
will appear in Global Coordinates. 

e Whether Absolute values are required. In this context 
Absolute means greater than 0, so all peaks will be 
positive. 


Here is a “Before” image: 


> PDT Parts Library 


¥Y PDT Trigonometrical Waves 


Working Plane: Front(X-Z) v 
Wave... Cosine + Cycles # 2 
Amplitud 1.50 Cycle Le 2.00 
@ Cube x ¥ Empty Object 
Resolution 18 Tangent 10.00 


Start Loc... 0.00 0.00 0.00 


“Generate Wav... Absolute 


And here is an “After” image: 


> PDT Parts Library 


Y PDT Trigonometrical Waves 


Working Plane: Front(X-Z) 


Wave... Cosine ~ Cycles # 2 


Amplitud 1.50 Cycle Le 2.00 


@ Cube <x 4 Empty Object 
Resolution 18 Tangent 10.00 
Start Loc... 0.00 0.00 0.00 


“Generate Wav... Absolute 


Here is an example of “Absolute” values using a Sine Wave: 


Y PDT Trigonometrical Waves 


Working Plane: Front(X-Z) 

Wave... Sine v Cycles # 2 
Amplitud 1.50 Cycle Le 2.00 

m, Cube x Empty Object 
Resolution 18 Tangent 10.00 


Start Loc... 0.00 0.00 0.00 


“Generate Wav... Y Absolute 


And finally an example of a Tangent Wave limited to a 
maximum value of 5: 


> PDT Command Line (? for help) 

> PDT View Control 

> PDT Pivot Point 

> PDT Parts Library 

Y PDT Trigonometrical Waves 

Working Plane: Front(X-Z) 

Wave... Tangent » Cycles # 2 
Amplitud 1.50 Cycle Le 2.00 

@ Cube ¥ Empty Object 

Resolution 18 Tangent 5.00 


Start Loc... 0.00 0.00 0.00 


“Generate Wav... Absolute 


PDT Examples 


Example Models will be shown here, built Exclusively with 
PDT, Offset Edges and Measurelt Add-ons. 


This first one may not look too remarkable, except that it is 
totally accurate to dimensions, not approximately, taken 
from tracing a reference image. 


The draught angles on this half-casting are exactly 5 
degrees, the length of sides between the radii are exactly to 
a dimension. All intersect points of faces have been placed 
accurately using PDT, not guessed from a zoomed in view. 
All fillets are exactly to a dimension and exactly in the right 
place. 


Most of the accuracy of this model would be either 
impossible, or so very complicated, to achieve with Blender 
on its own. With PDT and Offset Edges, it was quick and 
easy to achieve this kind of topology, suitable for 
mechanical models, at a very high level of precision 


(constrained only by the storage of coordinates in Blender). 
You can also see the Pivot Point of this model, stored in its 
Custom Property. 


Example 1 Construct a Casting: 


Stage 1: 


This example has been executed from the PDT Command 
Line section. 


Set Move Mode to Selected Entities. 

Place Vertex at 0,0,0 - Command na,, 

Extrude 20 at 0 degrees - Command ei20, Working 
Plane set to Front (X-Z) 

Place Cursor at fillet radius centre. - Command 
ci22.5,90 

Spin 85 Degrees - Blender Spin -85 degrees 
Extrude 50 at 85 degrees - Command ei50,85 


Stage 2: 


Duplicate first Vertex 150 in X 100 in Z - Command 
dd150,,100 

Extrude 100 at 180 degrees - Command ei100,180 
Intersect Corner - Operation = Move, All/Active Selected, 
click Intersect 

Extrude 100 in Y - Command - ei1100,90 Working Plane 
set to Top(X-Y) 

Bevel Corner - Blender Command Bevel, 25mm 

Offset Edges 2.5 - Offset Edges Extrude Command. 


Stage 3: 


Spin in Top View - Blender Spin Command, 62.5 degrees 
Extrude 47.5 at 27.5 degrees - Command ei47.5,27.5 
Spin in Top View - Blender Spin Command, 27.5 degrees 
Extrude 30 at 0 degrees - Command e130, 

Complete highlighted faces using standard Blender 
techniques to get this: 


Then simply extrude the two front face corners level with 
the cursor in X and then selected vertices to make the faces 
with F key. 


This model is accurate to dimensions, draught angles and 
corner radii. All the command line inputs could be replaced 
by using the Operation options and Command buttons instead. 


Optionally, to improve topology, one could rationalise the 
top faces to this: 


It would depend on what we wanted to do ultimately with 
the top faces, like maybe cut holes in them. 


Example 2 - Modify a Hydraulic 
Cylinder: 


Take this mesh, we have no idea at what angle the mesh 
lies, Since it was drawn to a delta measurement not a 


directional measurement: 


We now want to make it longer along the angle at which it 
lies, by a known amount, so we first use the Set A/S 2D tool 
to set the angle: 


You can see the angle was 9.9935 degrees, we then input 
the distance we require in the Distance input box, set 
Operation to Move and click the Direction command to get this: 


You can see the selected vertices have been moved exactly 
3000mm at exactly 9.9935 degrees. This is one of the main 


reasons why PDT exists, to do just this type of precise 
alteration of geometry. 


Worked Example - Building 
A Book Scanner 


In this page we will show how to make complex parts of this 
book scanner using PDT. 


This is considered a typical CAD design and consists of 
many parts that can be made by extruding a profile to make 
the 3D mesh. It should be noted that this is a preferred 
manner to work in the CAD environment, rather than 
starting with a 3D mesh and carving bits out of it. We will 
start with a component that has a hole in it so that process 
is explained properly. 


Making the End Panels. 


The End Panel in Edit Mode. 


For this we will start with a single vertex object at 0,0,0 (You 
will need to load the “Extra Objects” Add-on). 


| placed all objects, apart from the wheels at the World 
Centre for ease, so the start point for this component is 
0.39,-0.32,-0.3. The first thing to do therefore is move this 
single vertex in Edit mode to that location. For this there are 
two choices: 


e Set Cartesian Coordinates to 0.39,-0.32,-0.3 
respectively, set operation to Move and click Delta. 
e OR Key gd0.39,-0.32,-0.3 into Command Line. 


Now we need to extrude this vertex 0.64 in Y: 


e Set Cartesian Coordinates to 0,0.64,0 respectively, set 
operation to Extrude Vertices and click Delta. 
e OR Key vd,0.64, into Command Line. 


Select both vertices and extrude 0.7 in Z: 


e Set Cartesian Coordinates to 0,0,0.7 respectively, set 
operation to Extrude Vertices and click Delta. 
e OR Key vd,,0.7 into Command Line. 


Copy leftmost of the new vertices 0,0.065,0.14: 


e Set Cartesian Coordinates to 0,0.065,0.14 respectively, 
set operation to Duplicate Geometry and click Delta. 
e OR Key dd,0.065,0.14 into Command Line. 


Extrude new vertex -0.04 in Z: 


e Set Cartesian Coordinates to 0,0,-0.04 respectively, set 
operation to Extrude Vertices and click Delta. 
e OR Key vd,,-0.04 into Command Line. 


You should now have this: 


| have selected two vertices, join these two together with 
Join 2 Verts Tool. 


Select Top Left vertex and extrude it 0.02 in Y: 


e Set Cartesian Coordinates to 0,0.02,0 respectively, set 
operation to Extrude Vertices and click Delta. 
e OR Key vd,0.02, into Command Line. 


Extrude 0.16 in Z: 


e Set Cartesian Coordinates to 0,0,0.16 respectively, set 
operation to Extrude Vertices and click Delta. 
e OR Key vd,,0.16 into Command Line. 


You should now have this: 


Duplicate the selected vertices to the other side: 


Set 3D Cursor, SHIFT+D, CTRL+M Y - standard Blender 
commands. 


Join the gaps using Join 2 Verts and you get this: 


Select the vertices shown, they need filleting: 


e Set Radius to 0.03, Profile to 0.5 and Segments to 6, click 
Fillet. 
e OR Key fv0.03,6,0.5 into Command Line. 


This is the result: 


Copy bottom left vertex 0.12 in Y & 0.1 in Z: 


e Set Cartesian Coordinates to 0,0.12,0.1 respectively, set 
operation to Duplicate Geometry and click Delta. 
e OR Key dd,0.12,0.1 into Command Line. 


Extrude 0.45 in Z: 


e Set Cartesian Coordinates to 0,0,0.45 respectively, set 
operation to Extrude Geometry and click Delta. 
e OR Key vd,,0.45 into Command Line. 


Extrude 0.15 in Y, 0.31 in Z: 


e Set Cartesian Coordinates to 0,015,0.31 respectively, 
set operation to Extrude Geometry and click Delta. 
e OR Key vd,0.15,0.31 into Command Line. 


Duplicate these new vertices to the other side: 


Set 3D Cursor, SHIFT+D, CTRL+M Y - standard Blender 
commands. 


Join the gaps using Join 2 Verts and you get this: 


Select the vertices shown, they need filleting: 


e Set Radius to 0.03, Profile to 0.5 and Segments to 6, click 
Fillet. 
e OR Key fv0.03,6,0.5 into Command Line. 


You should now have this: 


Join these two vertices each side using Join 2 Verts Tool 
giving this: 


Select these vertices and key F - (Blender Face command) to 
give this: 


Switch selection (CTRL+1), select four vertices across joins 
and make Face again giving this: 


Duplicate entire geometry -0.02 in X: 


e Set Cartesian Coordinates to -0.02,0,0 respectively, set 
operation to Duplicate Geometry and click Delta. 
e OR Key dd-0.02,, into Command Line. 


You should now have this: 


Select both outer edge rings and choose Edge => Bridge Edge 
Loops, repeat for inner edge loops to get all the faces: 


Shown in Face Mode 


Exit Edit Mode, name object “End-R” and duplicate Object 
(SHIFT+D), rename this new object “End-L’. 


Edit new “End-L’ Object and mirror all faces about X Axis. 


Set 3D Cursor. 

Select All Geometry. 

Key CTRL+M. 

Key SHIFT+N to normalise faces. 


You should now have two ends like this: 


You should be able to see the advantages of making end 
profiles, then bridging the edge loops to make an extruded 
Shape. This avoids duplicated geometry and also allows for 
holes in the object by making faces that split across the 
hole. | would then add an Edge Modifier to the objects to 
clean up the shading and of course make a Suitable 
material. 


You can also see that we can either use PDT Design Functions 
& Tools, Of USE PDT Command Line to just type in the commands. 


We can use the same principles to make all the other 
components. 


_To Be Continued... _ 


Stored Views 


Stored Views has three modes of operation, depending on 
which the following are saved or restored. Save stored views 
to your blend-file to easily have access to saved views later. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click 3D View then Stored Views to enable the script. 


Interface 


Located in the 3D Viewport >» Sidebar > View tab. 


View 
Save multiple view locations for easy navigation between 
views. 


POV 
Save Point of View -> Perspective and Local modes. 


Camera to View 
Move the selected camera to current view. 


New Camera to View 
Create a new camera to current view. 


Save Current 
Save the View or POV. 


Camera Selector View 


Preview Camera 


Add Camera Marker 


Tools for camera selection and 3D Cursor 
management. Collections 
Stored Views 
Camera — 
Make the camera active. BOY 


Camera To view New Camera To.. 


Save Current 


Make the camera active, 
selected and Camera to View in ae 
one button. GD Zoom Back Right 
Camera Selector 
Camera 


(ot) 
Add a camera marker to help cue errant 
r A 


animating between cameras. 


nnotations 


Instructions 


First activate the user interface and storage by pressing 
Initialize. 

With the View button active, Zoom, move or rotate the 
camera into a position you like. (Useful setting up 
camera locations and modeling specific areas of a 
mesh.) 

Or with the POV button active, change the user 
perspective or local views. 

Press Save Current to create a list of each stored view or 
point of view. 

You can move selected camera or create a new camera 
to the stored view. (Useful for setting up camera shots 
to different views.) 

The camera selector works in a similar way. Each 
camera is listed and you can make a camera active by 
pressing the camera icon. 


e You can view each camera pressing the screen icon and 
also add camera markers using the arrow icon. (Useful 
for setting up camera switching during animations.) 


As all stored definitions are saved in the blend-file, you can 
save the file and the next time you use it, the stored views 
or point of view will be ready. 


Reference 


Category: 
Description: 


Location: 
File: 

Author: 
Maintainer: 
Contributors: 
License: 


Support Level: 


Note: 


3D View 
Save and restore user defined views, 
POV and camera locations. 


3D Viewport > Sidebar > View tab 
Space _view3d stored views.py 
nfloyd, Francesco Siddi 

Brendon Murphy (meta-androcto) 
ramboblender 

GPL 

Community 

This add-on is bundled with Blender. 


VR Scene Inspection 


native virtual reality features of Blender in the user 
interface. The feature set is limited to scene inspection use 
cases. More advanced use cases may be enabled through 
further development inside of Blender. 


VR support in Blender is based on the OpenXR specification 


and requires some set up steps. These are explained in the 
Head-Mounted Displays (HMD) section. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click 3D View then VR Scene Inspection to enable the 
Script. 


Interface 


Located in the 3D Viewport > Sidebar » VR tab. 


~v VR Session 


> Start VR Session 


Tracking ¥ Positional 


Absolute 


Actions Y Use Controller Actions 


¥ Floor 

¥Y Annotations 

¥ Selection 

¥ Controllers 

¥ Custom Overlays 
Object Extras 


Controller Style 
Clip Start 
End 

> Landmarks 


> Action Maps 


> Viewport Feedback 


VR Session 


Start VR Session \ VR Session 
Try to set up a connection to the » Start VR Session 
OpenXR platform to share the ier Wer eet 
viewport with an HMD. Absolute 
Actions WW Use Controller Actions 
Tracking 
Positional 


Only track rotational changes of the head, do not 
allow the HMD to affect the location of the viewer in 
virtual space. 


Absolute 
Skip eye offsets that are normally added for placing 
the viewer exactly at landmarks. This allows the 
tracking origin to be defined independently of the 
HMD position. 


Use Controller Actions 
Enable default controller actions for viewport navigation, 
controller tracking, and haptics. 


View 
Show 
Floor Show '¥ Floor 
Set visibility of the ground aren 
plane in the VR view. Y Controllers 
¥ Custom Overlays 
An notations Object Extras 
Set visibility of annotation ec 
strokes in the VR view. acne 
End 
Selection 


Set visibility of selection 
outlines in the VR view. 


Controllers 
Set visibility of VR motion controllers. Requires 
enabling the Use Controller Actions option. 


Custom Overlays 
Set visibility of custom operator drawing (e.g. default 
teleport beam). 


Object Extras 
Set visibility of object extras, including empties, lights, 
and cameras. 


Object Type Visibility © 
Set visibility of objects by type. 


Controller Style 
Preferred visualization of VR motion controllers. 


Clip Start/End 
Clipping values of the VR view, as in the 3D Viewport. 


Landmarks 


Landmarks are used to store reusable base poses (position 
and rotation) for the viewer in the virtual space. In addition, 
a base viewer reference scale can be set for landmarks of 
types Custom Object and Custom Pose. 


Land mark vy Landmarks 
A list view. Landmark 


Selected Landmark vs 
Defines which landmark’s Type Custom Object 
settings are shown below the eee Cube 
list. Changing the selected wae 
landmark does not have an 
influence on the VR view. 


1.00 


Activate O 
Activates a landmark, making it change the base pose 
of the VR view. 


Add + 
Create a landmark. 


Remove - 
Delete the selected landmark. 


Add from Session e 
Create a landmark from the viewer pose of the 
running VR session. 


Landmark Controls v 
Add Camera and VR Landmark from Session 


Create a new camera and landmark from the 
viewer pose of the running VR session. 


Add Landmark from Camera 
Add a new landmark from the active camera 
object. 


Update Custom Landmark 
Update the selected landmark from the current VR 
viewer pose. 


Cursor to Landmark 
Move the 3D Cursor to the selected landmark. 


Scene Camera to Landmark 
Position the scene camera at the selected 
landmark. 


Camera from Landmark 
Create a new camera from the selected landmark. 


Type 
Scene Camera 
Follow the scene’s active camera to define the base 
pose of the viewer. 


Custom Object 
Set an arbitrary object to define the base pose of the 
viewer. 


Custom Pose 
Manually define a position and rotation to use as the 
base pose of the viewer. 


Action Maps 


Gamepad vy Action Maps 


Use input from a gamepad Gamepad 
(Microsoft Xbox Controller) pith Meir 
instead of motion controllers for peeene 
VR actions such as viewport Huawel 
navigation. 


Extensions 


Enable additional controller bindings to ensure correct 
input-to-action mappings. Note that a given extension 
may not be supported by all VR platforms. 


HP Reverb G2 
Enable bindings for the HP Reverb G2 controllers. 


HTC Vive Cosmos 
Enable bindings for the HTC Vive Cosmos controllers. 


HTC Vive Focus 
Enable bindings for the HTC Vive Focus 3 controllers. 


Huawei 
Enable bindings for the Huawei controllers. 


Viewport Feedback 


Show VR Camera Y Viewport Feedback 
Draw an indicator of the current A Note: _ 
VR viewer pose (location and ses roe aaa 
rotation in the virtual space) in 


the current 3D Viewport. Show VR Camera 


Show VR Controllers 


Show VR Controllers me mela 
Draw indicators of tracked VR 
motion controllers in the current 


3D viewport. Requires enabling the Use Controller 
Actions option. 


Show Landmarks 
Draw landmark indicators in the current 3D Viewport. 


Mirror VR Session 
Make the current 3D Viewport follow the perspective of 
the VR view. 


Reference 

Category: 3D View 

Description: View the viewport with virtual reality 
glasses (head-mounted displays). 

Location: 3D Viewport >» Sidebar » VR tab 

File: viewport_vr_preview folder 

Author: Julian Eisel, Sebastian Koenig, Peter Kim 

Maintainer: Julian Eisel, Peter Kim 

License: GPL 


Support Level: Official 
Note: This add-on is bundled with Blender. 


Add Curve 


These add-ons relate to curve object creation and curve 
based tools. 


Assign Shape Keys 
Blracer 

Curve Tools 

Add Curve Extra Objects 
lvy_Gen 

Sapling Tree Gen 
Simplify Curves 


Assign Shape Keys 


This add-on lets you assign one or more Bézier curve(s) as 
Shape keys to other curve. Useful for morphing curves and 
curve based text objects. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Add Curve then Assign Shape Keys to enable the 
Script. 


Interface 


Located in the 3D Viewport » Sidebar » Edit tab. 


Y Curve Shape Keys 


Item 


Morph Curves 
¥ Remove Shape Key Objects 


Space: World Space 


8 
ne 
4 
vu 
S 


Verte... Manual Alignment 
Match.. Default 


Assign Shape Keys 


Edit Create 


>» Curve Tools 


Usage 


1. Select the target and shape key Bézier curve objects. 


2. Make sure the target is the active object; you can do 
this by Shift-RMB-clicking the target curve after the other 
selections are made. 

3. Go to the Curve Shape Keys tab and click Assign Shape 
Keys button. 

4. Now a copy of the active object curve will be created, 
which will have the other selected curves as its target. 


If the Remove Shape Key Objects option is checked, the 
selected curve objects will be deleted and only the target is 
kept. 


There are some options to align the closed (cyclic spline) 
target and the shape-key curves. Also it’s possible to match 
individual parts from a multipart (multiple splines) of target 
and shape key curves (e.g. a text object converted into a 
curve) based on various criteria. 


For smoother transition, you can subdivide the segments of 
one of the curves in the selection group. 


Manual Alignment of Starting Vertices 


In Edit Mode the Assign Shape Keys panel shows a single 
button - Mark Starting Vertices. When clicked, all the 
starting vertices of the closed splines (disconnected parts) 
of the selected curves are indicated by a marking point. 
Now if you select any vertex, the marker moves to this 
selected vertex, indicating the new starting vertex. You need 
to confirm the new positions by pressing Return. Pressing Esc, 
reverts the positions to the earlier order. 


Tutorial 


See this tutorial video on how to activate the add-on along 
with basic usage. 


Reference 

Category: Add Curve 

Description: Assigns one or more Bézier curves as a 
shape key for another Bézier curve. 

Location: Sidebar > Edit tab 

File: Ccurve_assign_shapekey.py 

Author: Shrinivas Kulkarni 

Maintainer: Shrinivas Kulkarni 

License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


BTtracer 


The purpose of this script is to add tools that are similar to 
C4D Tracer. Btrace provides several ways to trace objects 
and particles and animate the resulting curve. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Add Curve then BTracer to enable the script. 


Interface 


Located in the 3D Viewport >» Sidebar » Edit tab. 


The default setting in the interface is Choose Tool, here you 
pick what trace methods and functions. 


¥ Blracer 
= Available Tools 
<4 Object Trace 
» Trace Tool 
<>} Object Tra.. 
¥ Settings Selected 0 
_[ Edge Type for Curves 
Continuous 
Apply to Copy 


Add Distortion 


“Y Curve Setti.. @ Material Se. 
Be. Material Settings 

Random Color 
‘Y” New Curve Settings 
Spline: Bezier 
Handl.. Vector 
Bevel Options 


Dept 0.10 Resolutio 4 
Resolution U 12 


Animate Final Curve 


© Add Grow Curve Animation 


Information 


The five main tools (Object Trace, Object Connect, Mesh 
Follow, Particle Trace, Particle Connect) all share common 
settings for the most part. Each tool creates a curve as the 
end result. The settings for the curve created can be setup 
under the Curves Settings button. 


The tools have access to a few other features. All of them 
have access to the grow curve animation tool which 
animates the curve radius. As well as the Color Blender tool. 


Object Trace 
Creates a curve by joining points of amesh ina 
continuous manner or by all edges. Options to modulate 
the curves radius or add distortion to mesh before 
converting. 


Objects Connect 
Join selected objects with a curve and add hooks to each 
node. 


Particle Trace 
Creates a curve from each particle of a system. Keeping 
particle amount under 250 will make this run faster. 


Particle Connect 
Connects each particle of a system with a continuous 
curve. 


Mesh Follow 
Creates curve from animated mesh object. Following the 
path of either the vertices, edges or faces, and also the 
option to follow the object’s origin. 


Grow Curve Animation 
Animate the radius of a curve over time. Can be run 
alone on a curve object, or run with the tools above. 


F-Curve Noise 
Quick link to add an F-Curve modifier to an object. 


Color Blender 
Assign colors, create color palettes and randomize colors. 


Each script has a number of different options which can be 


used to create some very interesting effects. 


Reference 


Category: 
Description: 


Location: 
File: 

Author: 
Contributors: 
Maintainer: 
License: 


Support Level: 


Note: 


Add Curve 

Tools for converting/animating 
objects/particles into curves. 
Sidebar > Create tab 

btrace folder 

liero, crazycourier 

Atom, MacKracken, meta-androcto 
Brendon Murphy (meta-androcto) 
GPL 

Community 

This add-on is bundled with Blender. 


Curve Tools 


This add-on provides an extensive set of tools for the 


tools are included. 


Activation 


e Open Blender and go to Preferences then the Add-ons 


tab. 
e Click Add Curve then Curve Tools to enable the script. 


Interface 


This add-on is split into sub panels with each panel having 
it’s own specific set of tools. 


Curve Info 

Reference 

Mode: All Modes 

Tool: Sidebar > Edit > Curve Info 
Curve 


Print splines, segments and empty splines information to 
the Info header and Info editor. 


Spline 
Print splines information to the Info header and Info 
editor. 


Segment 
Print segments information to the Info header and Info 


editor. 


Length 
Calculate the length of the curve and show in the add- 


on’s panel. 


Curve Edit 

Reference 

Mode: All Modes 

Tool: Sidebar > Edit >» Curve Edit 


Fillet/Chamfer 
Round or chamfer Bézier point fillets. 


Outline 
Create an outline around a selected curve object. 


Recursive Offset 
Create an offsetted array. 


Separate Offset/Selected 
Separate the outline mesh from the original. 


Subdivide 
Subdivide selection or filleted corners. 


Multi Subdivide 
Subdivide with level of details. 


Split at Vertex 
Cuts the selected points creating openings. 


Discretize Curve 
Disconnect the selected points. 


Array Splines 
Create an array of the selected curves in Edit Mode. 


Intersect 

Reference 

Mode: All Modes 

Tool: Sidebar > Edit > Intersect 


2D Curve Boolean 
Boolean selected curves on a 2D plane. 


Intersect Curves 
Create an intersection between flat curves on the same 


plane. 


Surfaces 

Reference 

Mode: All Modes 

Tool: Sidebar >» Edit >» Surfaces 
Birall 


It creates a surface from a profile and two paths. The 
order in which you select the curves and its direction is 
important to make this function properly. 


Convert Bézier to Surface 
Convert the selected curve to a NURBS surface. 


Convert Faces to Bézier 
Select faces and convert them to Bézier curves. 


Loft 

Reference 

Mode: All Modes 

Tool: Sidebar >» Edit > Surfaces >» Loft 
Loft 


Loft a mesh object between two Bézier curves. 


Auto Loft 
Turn on to store the loft data if you move or edit the 


curves. 


Update Auto Loft 
Press this button to update the new loft mesh position 
after moving or editing parent curves. 


Sanitize 

Reference 

Mode: All Modes 

Tool: Sidebar > Edit > Sanitize 


Set Origin to Spline Start 
Move the origin of the curve to the first point. 


Reset Scale 
Reset the objects scale to (1, 1, 1). 


Cleanup: 


Remove Doubles 
Remove doubled points. 


Short Splines 
Remove selected splines based on a threshold. 


Join Splines: 


Join Neighboring Splines 
Join selected splines based on a threshold. 


Utilities 

Reference 

Mode: All Modes 

Tool: Sidebar > Edit > Utilities 


Curve Resolution: 


Show [ESC] 
Display the resolution in the interface with a colored 


overlay. 


Spline Order: 


Show [ESC] 
Display and arrange the sequence. 


Path Finder 


Reference 


Mode: All Modes 


Tool: 
Tools for paths. 


Reference 


Category: 
Description: 


Location: 
File: 

Authors: 
Contributors: 


Maintainer: 
License: 


Support Level: 


Note: 


Sidebar >» Edit > Utilities » Path Finder 


Add Curve 

Adds functionality for Bézier/NURBS 
curve/surface modeling. 

Sidebar » Edit tab 

curve tools folder 

MacKracken, cwolf3d, Alexander Meifner 
(Lichtso) 

guy lateur, Alexander Meisner (Lichtso), 
Dealga McArdle (zeffii), Marvin K. Breuer 
(MKB) 

Vladimir Spivak (cwolf3d) 

GPL 

Community 

This add-on is bundled with Blender. 


Add Curve Extra Objects 


This add-on groups many curve object creation add-ons into 
a single one. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 


e Click Add Curve then Extra Objects to enable the script. 


Interface 


Located in the 3D Viewport > Add > Curve. 


Information 


Included curve object add-ons: 


Curve Profiles (Curveaceous Galore) by Jimmy Hazevoet, 
testscreenings 
Arc, Arrow, Cogwheel, Cycloid, Flower, Helix, Noise, N- 
sided, Profile, Rectangle, Splat and Star types. 


Braid by Jared Forsyth 
Adds a Braided Knot type curve. 


Celtic Knot by Adam Newgas 
Wrap a mesh object in a knotted curve. 


Curly Curve by Cmomoney 
Adds a “Flourish” type curve. 


Simple Curve by Vladimir Spivak (cwolf3d) 
Point, Line, Distance, Angle, Ellipse, Arc, Sector, 
Segment, Rectangle, Rhombus, Polygon, Polygon ab, 
Trapezoid curve types. 


Spirals by Alejandro Omar Chocano Vasquez 
Archimedean, Logarithmic, Spherical, Torus curve types. 


SpiroFit, BounceSpline and Catenary by Antonio Osprite, 
Liero, Atom, Jimmy Hazevoet 
Spiral fit curve to mesh, Bounce Spline inside a mesh, 
Catenary curve between two mesh objects. 


Torus Knots, by Marius Giurgi (DolphinDream), 
testscreenings 
Adds many types of (torus) knots including ten presets. 


Bevel/Taper Curve, by Cmomoney 
Adds bevel and/or taper curve to active curve. 


Surface Objects, by Folkert de Vries 


Adds a NURBS surface Plane, Cone, Star, Wedge. 


Reference 


Category: 
Description: 
Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Add Curve 

Add multiple extra curve object types. 
3D Viewport » Add >» Curve 

add _ curve extra objects folder 
Multiple Authors 

Vladimir Spivak (cwolf3d) 

GPL 

Community 

This add-on is bundled with Blender. 


Ivy Gen 


Based on the wonderful code by Thomas Luft and his 
original lvyGen program. 


Original Blender port by testscreenings, further advances by 
PKHG and TrumanBlending. 


Activation 


e Open Blender and go to Preferences then the Add-ons 


tab. 
e Click Add Curve then Ivy Gen to enable the script. 


Interface 


Located in the 3D Viewport » 
Sidebar > Create tab. 


Located in the 3D Viewport > 
Operator. 


The Update Ivy operator is separate 
from the main menu and appears in 
the 3D Viewport. You can adjust 
settings in the panel and press the 
Update button to update 
parameters. 


Instructions 


¥ Ivy Generator 


Generation Settings 
Random Seed 


Maximum Time 


Size Settings 
Max Ivy Length 
Ivy Size 
Max Float Length 


Max Adhesion Length 


Weight Settings 
Primary Weight 
Random Weight 
Gravity Weight 
Adhesion Weight 

Branch Settings 
Branching Probability 
Ivy Branch Size 

¥ Grow Leaves 

Leaf Settings 
Ivy Leaf Size 
Leaf Probability 


1. Select the object you want to grow ivy on. 


2. Enter Edit Mode and select a vertex that you want the 


ivy to spawn from. 


3. Snap the cursor to the selected vertex. 


4. Enter Object Mode and with the object selected: Sidebar 
>» Create >» Ivy Generator panel adjust settings and 
choose Add New Ivy. 


The Add Default Ivy operator will use the default parameters 
during creation. This will generate your initial lvy Curve and 
Leaves. From here you can access the Ivy menu in the 
Sidebar. | suggest to make small changes and then press 
Update Ivy in the 3D Viewport operator. 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Add Curve 

Adds generated ivy to a mesh object 
starting at the 3D Cursor. 

Sidebar > Create tab 

add _ curve _ivygen.py 

testscreenings, PKHG, TrumanBlending 
Vladimir Spivak (cwolf3d) 

GPL 

Community 

This add-on is bundled with Blender. 


Sapling Tree Gen 


This add-on creates trees. There are many preset tree types 
to choose from or create your own. The method is presented 
by Jason Weber & Joseph Penn in their paper “Creation and 
Rendering of Realistic Trees”. 


Activation 


e Open Blender and go to Preferences then the Add-ons 


tab. 
e Click Add Curve then Sapling Tree Gen to enable the 


Script. 


Interface 


Bevel Resolutio 1 Curve Resolutio 4 


Handle T.. Auto 


Scale Variat 2.00 


Export Preset 


Limit Import 


Located in the 3D Viewport >» Add >» Curve menu. 


Instructions 


Once the tree is created there are eight settings to build 
your tree. When creating your tree it’s often best to use the 
settings in order until your familiar with them. 


Geometry 


Bevel 
This determines whether the curve should be shown with 
its full thickness or only the underlying curve. Disabled 
by default to permit rapid feedback on parameter 
changes. 


Bevel Resolution 


Determines how smooth the outline of the bevelled curve 
is. The lower this value, the smaller the number of 
vertices but the resulting geometry will be coarser. 


Curve Resolution 


Changes the smoothness of the curve along its length. 
This is only relevant if Handle Type is set to Auto. 


Handle Type 
Determines the method of interpolation of the curve 
between Bézier points. Vector type results in fewer 
vertices but straight segments. Auto type smooths the 
segments but requires more expensive geometry. 


Shape 
Governs the distribution of branches in order to effect the 
overall shape of the tree. 


Custom Shape 
Customize the branch shape along the branch length. 


Secondary Splits 
Change the style of secondary branches. 


Branch Distribution 


Adjust branch distribution towards the top or bottom of 
the tree. 


Branch Rings 
Grow the Branches in Rings. 


Random Seed 
Sets the basis on which all random values for the tree are 
generated. This can be changed to allow different trees 
with the same basic parameters to be generated. 


Tree Scale: 
Scale 
The underlying size of the tree in Blender units. 


Scale Variation 
The maximum amount that the scale of the tree can 
vary (up or down) from the value of Scale. 


Radius Scale 
The scale of the radius at the base of the tree. 


Radius Variation 
The maximum amount that the radius scale of the 
tree can vary (up or down) from the value of Radius 
Scale. 


Preset: 
Preset Name 
The name of the preset to be exported. This will 
export all current properties of the tree to the Sapling 
preset folder as a py-file. 


Export Preset 
Export all current properties. 


Load Preset 
Any presets found in the Sapling preset directory may 
be imported when selected here. 


Limit Import 
This can be used to restrict what geometry is created 
when a preset is imported. If selected, only two levels 
of branches and no leaves will be generated. 


Branch Radius 


This sub menu contains the settings for the branch radius. 
You can adjust the bevel and taper of the branches here. 


Branch Splitting 


This sub menu contains the settings for branch splitting. You 
can adjust how the branches form and split here. Settings 
include levels, height and angle of the split. 


Branch Growth 


This sub menu contains the settings for branch growth. You 
can adjust how the branches grow here. Settings include 
length, angle and curvature. 


Pruning 


This sub menu contains the settings for pruning the 
branches. 


1. Press the Prune checkbox and you will see the prune 
object next to the tree. 

2. Change the settings to adjust the prune objects shape 
to form your tree. 


Leaves 


This sub menu contains the settings for leaves. 


1. Press the Show Leaves checkbox and you will see leaves 
on the tree. 

2. Press the Make mesh checkbox if you want to convert 
the curve to a mesh. 


Settings include shape, object type, rotations and scale. 
Armature 


This sub menu contains the settings to add an armature to 
your tree. It’s not recommended to use this function on 
highly complex trees as it may take time to compute. 


1. Turn off leaves and prune if you have them on. 

2. Press the Use Armature checkbox to add the armature 
to the tree. 

3. Adjust the armature levels and bone length to your 
liking. 

4. Do not pose the bones until you have finished the tree. 

5. you are now ready to use the next sub menu Animation. 


Animation 


This sub menu contains the settings to animate your tree. 
It’s recommended to finalize all your settings now. 


1. You will need to have an armature already created 
above. 

2. Press the Armature Animation checkbox to add the 
animation to the tree. 

3. Press the Leaf Animation checkbox to add the animation 
to the leaves if you have them. 

4. Press the Fast Preview checkbox to hide the leaves and 
bevel for fast animation playback in the viewport. 


Settings include speed, wind strength and leaf animation. 
Reference 


Category: Add Curve 


Description: 
Location: 


File: 
Author: 


Maintainer: 
License: 


Support Level: 


Note: 


Adds a parametric tree. 

3D Viewport >» Add » Curve » Sapling 
Tree Gen 

add curve sapling folder 

Andrew Hale (TrumanBlending), Aaron 
Butcher, CansecoGPC 

To Do 

GPL 

Community 

This add-on is bundled with Blender. 


Simplify Curves 


The Simplify Curves tool works on a single selected curve 
object. It generates a new curve based on the original one. 
The higher the Distance Error threshold is set the more 
control points are removed. 


The Simplify F-Curves tool works the same way, but on 
selected F-Curves. 


Merge by Distance tool glues nearby points on a single 
Bézier curve. In fact it is an analog of the usual Merge by 
Distance on a mesh, but for curves. Unlike the mesh one, it 
does not connect the points from different parts of the 
curves, even if they are on the ends of the two curves. To 
glue such points, you must first connect them with Make 
Segment. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Add Curve then Simplify Curves to enable the 
Script. 


Interface 


The Merge By Distance and Curve Simplify buttons are 
located in the 3D Viewport >» Curve Context Menu in curve 
Edit Mode. 


The Simplify F-Curves tool can be accessed by enabling 
Developer Extras and using the Menu Search to search for 
“Simplify F-Curves” in the Dope Sheet or Graph Editor. 


Reference 


Category: 
Description: 


Location: 


File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Add Curve 

Simplify curves in the 3D Viewport, and 
Dope Sheet, merge by distance in 3D 
Viewport. 

3D Viewport » Add » Curve » Curve 
Simplify, Dope Sheet and Graph editors » 
Channel > Simplify F-Curves 
curve_simplify.py 

testscreenings, Michael Soluyanov 

To Do 

GPL 

Community 

This add-on is bundled with Blender. 


Add Mesh 


These add-ons relate to Mesh object creation. 


e ANT Landscape 

e Archimesh 

e Bolt Factory 

e Discombobulator 

e Geodesic Domes 

e Add Mesh Extra Objects 


ANT Landscape 


This add-on creates landscapes and planets using various 
noise types. A.N.T. stands for Another Noise Tool. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Add Mesh then A.N.T. Landscape to enable the 
Script. 


Interface 


Located in the 3D Viewport » Add » Mesh menu. 


Located in the 3D Viewport >» Sidebar » Create tab. 


Operator Presets 


Main Settings 


Triar 


Noise Settings 
Hetero Terrain 
Noise Ba Blender 
Random Seed 


Offset X 
Offset Y 
Size X 


Size Y 


Noise Size 


Depth 


Dimension 
Lacunarity 
Offset 
Effect Typ.. None 
Displace Settings 


Height 
Offset 
Maximum 


Minimum 


Falloff 


Instructions 


After creating your landscape mesh there are three main 
areas in the Adjust Last Operation panel to design your 
mesh. 


0 


0.00 
0.00 
1.00 
1.00 


1.00 


e Main Settings: Object and mesh related settings like size 
and subdivisions. 

e Noise Settings: Noise related settings that give shape to 
your terrain. 

e Displace Settings: Settings for terrain height and edge 
falloff. 


Landscape Panel 


Landscape 
Landscape will create the mesh and add several panels 
and tools to the Sidebar. 


Landscape Tools 


Mesh Displace 
Displace selected mesh vertices along normal or X, Y, Z 
direction. 


Weight from Slope 
Generates a weighted vertex group slope map based on 
the Z normal value. 


Landscape Eroder 
Apply various kinds of erosion to an A.N.T. Landscape 
grid, also available in the Weights menu in Weight Paint 
Mode. 


Landscape Main 


Here we can adjust the main settings and regenerate the 
mesh. 


Smooth the mesh, Triangulate the mesh, Rename and add 
materials that you have in your blend-file. 


Landscape Noise 


Here we can adjust the noise settings and refresh only those 
settings. 


There are many settings and noise types that allow you to 
customize your landscape. 


Landscape Displace 


Here we can adjust the displacement settings and refresh 
only those settings. 


Adjust Height, Falloff and Strata in this section. 


Usage 
To Do 
Reference 
Category: Add Mesh 
Description: Another Noise Tool: Landscape, erosion 
and displace. 
Location: Sidebar > Create tab 
File: ant_landscape folder 
Author: Jimmy Hazevoet 
Maintainer: To Do 
License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


Archimesh 


This tool is specially designed to generate architecture 
elements, like: 


e Rooms 

e Doors 

e Windows 
e Kitchen cabinets 
e Shelves 
e Columns stairs 
e Tile roofs 
e Books 

e Lamps 

e Venetian blinds 

e Roller curtain 

e Japanese curtains 


The original video documentation can be found here: Video 
Playlist. Note that the videos were created for Blender 2.7 
series but are still a valid resource. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Add Mesh then Archimesh to enable the script. 


Interface 


Located in the 3D Viewport >» Sidebar » Create tab. 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Add Mesh 

Generate rooms, doors, windows and 
architecture objects. 

Sidebar > Create tab 

archimesh folder 

Antonio Vazquez (antonioya) 

Antonio Vazquez (antonioya) 

GPL 

Community 

This add-on is bundled with Blender. 


Bolt Factory 


This add-on creates bolts and nuts with options for bolt/nut, 
bit type and head type. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 


e Click Add Mesh then BoltFactory to enable the script. 


Interface 


Located in the 3D Viewport » Add » Mesh menu. 


Usage 


To Do 


Reference 


Category: 
Description: 
Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Add Mesh 

Add a bolt or nut. 

3D Viewport >» Add » Bolt 

add _ mesh _BoltFactory folder 

Aaron Keith 

To Do 

GPL 

Community 

This add-on is bundled with Blender. 


Discombobulator 


This add-on creates a greeble object based on selected 
faces. It quickly creates science fiction style panels across 
your mesh. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Add Mesh then Discombobulator to enable the 
Script. 


Interface 


Located in the 3D Viewport » Add » Mesh menu. 


Discombobulator works in mesh Object Mode and mesh Edit 
Mode. 


| I bul 
i | Usage Information 
Protusions settings 
¥ Make protusions 
Min height 
Max height 
Min taper 
Max taper 
¥ 1 vy 2 


Repeat protusions 


Doodads settings 

¥ Make doodads 
Minimum doodads number 
Maximum doodads number 


Pick doodad 


Remove active doodad Remove all doodads 


Materials settings 
Prot's top mat 


Side's prot mat 


Instructions 


. Select the quad faces you want to add greebles to. 

. 3D Viewport » Add » Mesh >» Discombobulator. 

. Now you will see the interface but nothing happens to 
the mesh. 

4. It’s useful at this point to read the Usage Information at 

the top of the panel. 


WNrF 


5. With the default settings press OK and you will see a 
new mesh object created that has raised areas. 
6. Let’s look at the settings below. 


Protrusions Settings 


Make Protrusions 
This checkbox turns on the functions for protrusions. If 
you turn it off, nothing will happen when you run the 
script. You may want to turn Protrusions off if you are 
using only the Doodads function described further below. 


Min/Max Height 
Adjust the height of the protrusions, you can use 
negative and positive values. The negative values will 
create the protrusions on the opposite side of the 
selected face(s). 


Min/Max Taper 
Adjust the taper of the protrusions. This will affect the 
pointiness of the protrusions. 


1,2,3,4 
These checkboxes provide options for the subdivision of 
the faces or the amount of protrusions per face. Based on 
random, if you have all selected, each face will have 
either 1, 2, 3 or 4 protrusions. Use only one or any 
combination and the faces will only have your selected 
value(s). 


Repeat Protrusions 
This button creates extra levels of protrusions built on 
top of the first set of protrusions. It’s important not to set 
this too high as it may take time to compute. Note also 
that repeating protrusions is based on face normals and 


will create protrusions on all faces created in the previous 
iteration. 


Doodads Settings 


This checkbox allows you to use your own mesh object and 
have it applied on top of the protrusions. 


Doodads can be a little tricky to set up: 


1. Select the object(s) you want to use as a doodad. 

2. Run Discombobulator and press Pick Doodad. 

3. Select your mesh to scatter doodads on and run 
Discombobulator. 


Materials Settings 


These settings allow you to add materials to the sides and 
tops of the protrusions. 


1. It’s best to set up your materials first. Add two different 
materials to your mesh (two materials slots). 

2. Number 0 will be the first slot in your materials, number 
1 will be the second slot. 

3. Run Discombobulator and you can pick the material for 
the top or sides. 


Reference 

Category: Add Mesh 

Description: Add Greeble type effect to a mesh. 
Location: 3D Viewport » Add » Mesh 

File: add _mesh_discombobulator folder 
Author: Evan J. Rosky (syrux) 


Maintainer: To Do 


License: GPL 
Support Level: Community 
Note: This add-on is bundled with Blender. 


Geodesic Domes 


Original introduction from Andy Houston (Blender 2.4 series) 


e Geodesic spheres based on icosahedrons, octahedrons 

and tetrahedrons. 

Triangular, hexagonal and hex/tri combo face options. 

e A function that turns the current shape into its 
geometric dual (sort of). 

e Grid, Cylinder, Parabola, Torus and Ball primitives. 

e Hubs and Struts. Fill out those edges and vertices with 
your custom, decorative meshes. 

e Superformula deforming. Create rounded triangles, 
wobbly shapes, etc. 


Introduction by Brendon Murphy (Blender 2.6/7 series) 


e This script can be used to create geodesic objects, not 
limited to domes or spheres. 

e Each mesh type created has it’s own set of editable 

parameters. 

By editing the parameters, you can create many simple 

or complex mesh shapes. 

e Create an equal-sided pyramid, a soccer ball, a wine 

glass and more. 

Limited only by your imagination (and some cool math 

limitations). 

e Create complex mesh deformations with the 
superformula parameters. 

e In the next section we will cover the menu types and 
how to use the parameters to “design” your mesh. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Add Mesh then Geodesic Domes to enable the 
Script. 


Instructions 


Main 

The Main menu is where you will do most of your work. 
The geodesic default triangle will be shown in the 3D 
Viewport and the Object Creation parameters can be 
accessed here. Please note: | find it’s easier to use the 
Object Creation parameters first before moving on to 
Faces, Struts and Hubs, these will be explained in the 
sections below. 


For now, let’s look at the Object Types and their parameters: 


Objects 
There are six Object types you can create by default. 
Using the parameters you can build upon these objects 
to create more object types. Object Types have unique 
parameter sets and share the Superformula parameters 
(described below). 


Geodesic Object Class Types 


Geodesic 
Please note, the Frequency parameters have a high 
impact on object creation. To create a Geodesic Dome 
you must increase the Frequency or the default Triangle. 


Subdivide Basic/Triacon 
Class 1 is the “equilateral triangle”. Class 2 is the “cube”. 


Hedron 
Choose between Tetrahedron, Octahedron, Icosahedron. 


Point 
Point (vertex), edge or face pointing upwards. 


Shape 
Choose between tri, hex or star face types. 


Round 
Choose between spherical or flat. (May not work for all 
object types.) 


Geodesic Object Parameters 


Frequency 
Subdivide base triangles. 


Radius 
Overall radius. 


Eccentricity 
Scaling on the X/Y axis. 


Squish 
Scaling on the Z axis. 


Square (X/Y) 
Superellipse action in X/Y. 


Square (Z) 
Superellipse action in Z. 


Rotate (X/Y) 
Rotate superellipse action in X/Y. 


Rotate (Z) 


Rotate superellipse action in Z. 


Dual 
Faces become vertices, vertices become faces, edges 
flip. 


Geodesic Object Types 


There are six Object types you can create. Each type has it’s 
own set of parameters. As you can see most menu items are 
self explanatory. The tooltips will give you further 
information on individual parameters. 


Gap 
Shrink faces in direction. Add or remove rows of faces 
based on height (Z) or (X/Y). 


Phase 


Rotate around a pivot. Useful for rotating deformation or 
use with Gap. 


Import Your Mesh 


You can import your own mesh into Geodesic Domes for use 
within the script. This is limited to the Faces, Struts and 
Hubs menus. 


Faces 


This Section adds extrusions and edits face structures ona 
mesh. 


Struts 


This section allows you to extrude an object along the edges 
of a mesh. 


Hubs 


This section allows you to place an object at the vertex ona 
mesh. 


Superformula Menu 


The superformula settings add a variety of settings such as 
pinching, twisting, inflate and more complex edit types. 


Reference 

Category: Add Mesh 

Description: Create Geodesic object types. 
Location: 3D Viewport » Add » Mesh 

File: add mesh_geodesic_ domes folder 
Author: Andy Housten 

Maintainer: To Do 

License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


Add Mesh Extra Objects 


This add-on groups many mesh object creation add-ons into 
a single one. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Add Mesh then Extra Objects to enable the script. 


Interface 


Located in the 3D Viewport » Add » Mesh menu. 


Information 


Included mesh object add-ons: 


Parent to Empty by Liero 
Parent the selected mesh to an empty object type. 


3D Function Surface by Buerbaum Martin (Pontiac), Elod 
Csirmaz 
Create objects with XYZ math functions. Includes several 
presets by elfnor. 


Beam Builder by revolt_randy, Jambay 
Create five types of beams. 


Gears by Michel J. Anders (varkenvarken) 


Create gear and worm type mesh. 


Gemstones by Pontiac, Fourmadmen, Dreampainter, 
Dominic Kroper, (dommetysk) 
Create three types of diamond shapes. 


Honeycomb by Kayo Phoenix 
Create a honeycomb patterned mesh. 


Menger Sponge by sugiany 
Create iterated Menger sponges. 


Pipe Joints by Buerbaum Martin (Pontiac) 
Create angled and crossed pipes. 


Step Pyramid by Phil Cote (cotejrp1) 
Create a step pyramid with variable settings. 


Round Cube by Alain Ducharme (phymec) 
Create a quad mesh sphere with several presets. 


Regular Solid by DreamPainter 
Create polyhedron based objects. 


Star by Fourmadmen 
Create a simple star shape. 


Supertoroid by DreamPainter 
Create a torus object with new parameters for boxed 
Shape and more. 


Teapot by Anthony D’Agostino 
Traditional style mesh teapot and a secondary spoon 
object. 


Torus Knot by Anthony D’Agostino 
A simple mesh torus knot with three types. 


Triangles by Sjaak-de-Draak 
Create math based triangles. 


Twisted Torus by Paulo Gomes 
Standard torus object with a variable twisted mesh. 


Add Vertex by meta-androcto, Pablo Vazquez, Liero, Richard 
Wilks 
Add a single vertex object or object origin as a fast start 
to mesh editing. 


Wall Factory by dudecon, jambay 
Add castle type walls with settings for openings. 


Reference 

Category: Add Mesh 

Description: Create many extra object types. 
Location: 3D Viewport >» Add > Mesh 

File: add _ mesh_extra_objects folder 
Author: Multiple Authors 

Maintainer: Viadimir Spivak (cwolf3d) 
License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


Animation 


These add-ons relate to helper tools for the animation 
process and animation. 


e Animall 

e Bone Selection Sets 

e Corrective Shape Keys 
e Turnaround Camera 


Animall 


Allows animation of mesh, lattice, curve and surface data. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Animation then AnimAll to enable the script. 


Interface 


Located in the 3D Viewport >» Sidebar » Animate tab. 


Tutorial 


See this tutorial video on how to activate the add-on along 
with basic usage. 


Reference 

Category: Animation 

Description: Allows animation of mesh, lattice, curve 
and surface data. 

Location: Sidebar >» Animation tab 

File: animation_animall.py 

Author: Daniel Salazar (zanqdo) 

Maintainer: Damien Picard (pioverfour) 

License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


Bone Selection Sets 


This add-on allows the creation, deletion and editing of 
selection sets. 


Selection Sets are a feature that allows the definition of sets 
of bones for easy selection while animating. The sets can be 
created in local and linked armature overrides. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Animation then Bone Selection Sets to enable the 
Script. 


Interface 


Located in the Properties >» Armature > Selection Sets. 


Description 


The Select and Deselect buttons are used to manipulate the 
current selection of bones, while the Assign and Remove 
buttons serve to add or remove the currently selected bones 
to the currently selected set. A bone can belong to more 
than one selection set. 


See also 


Bone Groups for a way to visually distinguish groups of 


bones. 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 


Maintainer: 
License: 


Support Level: 


Note: 


Animation 

List of Bone sets for easy selection while 
animating. 

Properties » Armature > Selection Sets 
bone_ selection sets.py 

Inés Almeida, Sybren A. Stuvel, Antony 
Riakiotakis, Dan Eicher 

to do 

GPL 2+ 

Community 

This add-on is bundled with Blender. 


Corrective Shape Keys 


From the Author(s): 


| merged and converted two old scripts, to let you make 
corrective shape keys. The first script was created by Tal 
Trachtman in 2007 and the second one | believe was done 
by Brecht. That one works with any combination of 
modifiers, but it is very slow (like three minutes for a mesh 
with 4,000 points). The other one works only with objects 
that have no more than one armature. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Animation then Corrective Shape Keys to enable 
the script. 


Interface 


Located in the Properties » Object Data >» Shape Keys 
Specials. 


Usage 


1. Select a posed character object and click on Create 
duplicate for editing in the shape keys panel. This will 
create a copy of the mesh that you can edit/sculpt. 

2. Select your sculpted copy and then the character object. 
Click on the little black arrow in the shape keys panel 


and choose one of the options shown in the image. If 
your object has only Armature modifiers, choose the 
faster method. If other (more complex?) modifiers are 
involved, or you want to incorporate dual quaternion 
Skinning (now called Preserve Volume in the UI) you will 
have to use the slower method. 


If all went right, your character or object should have the 
new shape key for your pose. If not, double check that your 
mesh and armature object have no translation or rotation 
and try again. 


Known Limitations 


e Target mesh may not have any transformation at object 
level, it will be set to zero. 

e Fast/Armature method does not work with Bone 
envelopes or dual quaternions, both settings will be 
disabled in the modifier. 


Reference 


Category: Animation 
Description: Creates a corrective shape key for the 
current pose. 


Location: Properties » Object Data >» Shape Keys 
Specials 

File: animation corrective shape key.py 

Author: Ivo Grigull (loolarge), Tal Trachtman, 
Tokikake 

Maintainer: to do 

License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


Turnaround Camera 


This add-on creates an animated camera turn around an 
object, suitable for product visualizations and character 
turnarounds. Executing the script creates an empty object 
linked to the camera at the selected object position or 
cursor position if chosen. The rotation can be defined by 
revolutions in X, Y, or Z axis. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Animation then Turnaround Camera to enable the 
Script. 


Interface 


Located in the 3D Viewport > Sidebar > View tab. 


Tutorial 


See this tutorial video on how to activate the add-on along 
with basic usage. 


Reference 
Category: Animation 
Description: Add a camera rotation around selected 


object. 
Location: Sidebar > View tab > Turnaround Camera 


File: 

Author: 
Maintainer: 
License: 
Support Level: 
Note: 


camera_turnaround.py 

Antonio Vazquez (antonioya) 

to do 

GPL 2+ 

Community 

This add-on is bundled with Blender. 


Camera 


These add-ons relate to camera objects and tools. 


e Add Camera Rigs 


Add Camera Rigs 
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Tracking: 


This add-on extends the functionality of a camera by 
creating control rigs with widgets and adds a panel to 
quickly access the camera’s settings from the 3D Viewport. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Camera then Add Camera Rigs to enable the 
Script. 


Description 


After activating the add-on, it will place three menu items in 
the Add >» Camera menu. They are Dolly Rig, Crane Rig and 
2D Camera Rig. 


The first two rigs are very similar except the “Crane Rig” has 
two extra adjustable bones (Arm Height and Arm Length) to 
make it easier to achieve a cinematic crane shot. 


The 2D Camera Rig is mostly useful for 2D shots, when the 
camera is static and the action happens in front of it (like a 
theater stage). 


Usage 


Add a Add > Camera » Dolly Camera Rig, Crane Camera Rig 
or 2D Camera Rig. This will build the rig at the cursor 
location, add a new camera, making it the new active scene 
camera. 


When the Rig is selected, the camera properties will be 
displayed in the Sidebar. 


3D Rigs (Dolly & Crane) 


Root Bone 
This is the parent of the entire rig. 


Control Bone 
This is the bone (named Camera) that will translate the 
camera around. By default it will track to the aim bone. 


Aim Bone 


The camera will point at this bone (named Aim). You can 
also tilt the camera by rotating the aim on the Y axis. 


2D Rig 


This rig is designed to provide fine controls over the framing 
while aiming at one direction. With it, you can frame the 
action by moving two of the corners of the camera, instead 
of moving and rotating it. It produces smooth movements 
that would be hard to achieve without it, by using complex 
drivers to calculate the appropriate camera settings. 


See also 


This video shows a comparison of an animated camera 
movement without (top) and with (bottom) the help of the 
rig. AS you can see in the lower left corner, you can 
achieve a smoother camera movement, without the frame 
moving around. 


Root Bone 
This is the parent of the entire rig. It is the only bone that 
you should rotate to aim approximately at the action. 


Left_corner and Right_corner Bones 
These are the most important bones in this rig. You can 
move them to quickly set and animate a framing. The 
camera will adjust its parameters to adapt to this framing 
(focal length, rotation / shift). They should always be at 
the same height (Y axis in the camera’s coordinate 
system). 


Camera Bone 


You can move the camera around, and it will compensate 
its settings to frame the two corners. For instance, if you 
leave the corners fixed on both sides of the subject and 
move the camera forward, you will achieve an efficient 
dolly zoom effect. 


Modes 


There are two modes of operation for the 2D rig: Rotation 
and Shift. You can switch between the two modes in the 
add-on’s Interface. 


Rotation is the default mode, and will rotate the camera to 
aim at and keep the corners in its frame. Shift mode, on the 
other hand, uses the Shift properties on the Camera to 
achieve a cropping effect instead of a pan. 


Limitations 


e When moving the corners too far to the side in rotation 
mode, perspective makes the rig much less accurate. 
e Rotation mode is unsupported for orthographic cameras. 


Interface 


Widgets 


When a rig is built, the add-on will create a collection for all 
the custom bone shapes (named widgets). When the custom 
shapes (widgets) are built they will use the prefix wcT-. If you 
have more than one rig in the scene, it will use the same 
widgets in the same collection rather than duplicating them. 
The default collection name and the widget prefix can be set 
in the preferences of the add-on. (This will not change the 


name of any existing widgets or collection, only ones that 
are created after you change the setting.) 


v Camera: Add Camera Rigs 

Description: Adds a Camera Rig with UI 

Location: View3D > Add > Camera > Dolly or Crane Rig 

File: /Users/waylow/blender-build/build_d..s/addons/add_camera_rigs/_ init__.py 
Author: Wayne Dixon, Brian Raschko, Kris Wittig 


Version: 1.4.1 


Internet: fl Documentation cia) Report a Bug 


Preferences: 


Widget Prefix: WDGT_ 


Collection name: WDGTS camera 


Panel 

Reference 

Mode: All Modes 

Panel: 3D Viewport > Sidebar > Item » Camera 


Rig 


The panel will display the most used camera settings. Only 
the added features will be explain here, for more 
information refer to the Cameras section. 


Set DOF Bone 
The Set DOF Bone button will automatically set up the 
camera so that it uses the camera rig’s Aim bone as a 
target for the depth of field (DOF). 


Focal Distance/F-Stop/Focal Length 
These are custom properties on the camera bone that 
drive the equivalent setting on the actual camera. This 


makes it animatable inside the armature object rather 
than having to animate the armature and the camera. 


Show in Front 
Will make the rig object visible through all other 
geometry. (Useful if you have a fly through scene or if 
other meshes are in the way.) 


Lock Camera Select 
The Lock Camera Select is a toggle button to make the 
camera unselectable (so you can’t accidentally delete it). 


Tracking (Aim Lock) 
This slider controls the Track To constraint on the control 
bone. Turn it off and the bone will not point to the aim 
bone anymore. 


Focal Length (mm) 50.000 


Crane Arm: 


Arm Height 


Arm Length 


Tracking: 


Aim Lock 


Crane Rig Height, Arm Length 
The Arm Height and Arm Length sliders at the bottom of 
the UI show the Y axis scale of the relevant bone. By 
default, both the height and the arm length are at 1 unit 
in size. These values only show in the interface when a 
crane rig is selected, they are also animatable. 


Rotation/Shift 
The Rotation/Shift slider lets you switch between Rotation 
and Shift Modes for the 2D Camera rig. You can also 
choose an intermediate value to have a bit of both. 


Multiple Cameras 


It is possible to add as many rigs as your scene needs. The 
Make Camera Active will appear if the camera attached to 
the selected rig is not the active camera. By pressing this, it 
will make this camera the active one. 


Camera Switching 


If you wish to switch cameras during an animation, you can 
do this with the Add Marker and Bind button. This uses 
Blender’s built-in camera binding tool to a Timeline marker. 
When pressed, it will add a marker to the Timeline and bind 
it to the camera controlled by the selected rig. Go to 
another frame, select a different camera rig and press it 
again. Now you have two markers and when you scrub the 
Timeline you will see the active camera switch accordingly. 
(Repeat this process as many times as needed). These 
markers can then also be dragged around in the Timeline to 
change the frame at which they will switch. 


Troubleshooting 


If the Aim tracking or 2D rig are not functioning, check that 
you have “Auto Run Python Scripts” enabled in the 
Preferences Preferences » Save & Load » Auto Run Python 
Scripts. 


See also 


e The author's Github repository. 
e A blog post explaining the 2D rig by its authors. 


Reference 


Category: 
Description: 
Location: 
File: 
Author: 


Maintainer: 
License: 


Support Level: 


Note: 


Camera 

Adds a camera rig with a UI. 

3D Viewport >» Add » Camera 

add _camera_rigs folder 

Wayne Dixon, Brian Raschko, Kris Wittig, 
Damien Picard, Flavio Perez 

to do 

GPL 

Community 

This add-on is bundled with Blender. 


Development 


These add-ons relate to Development tools. 


Dependency Graph Debug 
Edit Operator Source 
Icon Viewer 


Is Key Free 


Dependency Graph Debug 


Reference 

Category: Development 

Description: Various dependency graph debugging 
tools. 

Location: Properties >» View Layers 

File: depsgraph_debug.py 

Author: Sergey Sharybin 

Installation 


e This add-on is bundled with Blender. 

e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Development then Dependency Graph Debug to 
enable the script. 


Description 


e To Do 


Edit Operator Source 


This add-on allows searching for operator names (bl_idname) 
and opens source files containing them. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Development then Edit Operator Source to enable 
the script. 


Description 


In the Text Editor >» Sidebar on the left find the Edit Operator 
panel and press the Edit Operator button. A searchable 
menu will show up. Scroll down until the operator is found. 
Enter the keywords in the search field to narrow down the 
available options. The source file containing the operator 
will open pointing to it’s line. 


To access the previously opened text files, select them from 
the header data-block menu. 


Note 


Similar to the Operator Cheat Sheet, the script will produce 
a small memory leak (~0.03mb) when enabled by 
accessing the Operator attributes from Python. It is a 
conscious trade-off made by Blender developers, as the 
needed setting/call in the source C code for this purpose, 
would increase the size of every Python instance by 4 


bytes. In case of complex scenes, the increased memory 
footprint would be nontrivial compared to the few usage 
cases where it is currently needed. 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Development 

Opens source file of chosen operator or 
call locations, if source not available. 
Text Editor >» Sidebar >» Edit Operator 
development_edit_operator.py 
scorpion81 

scorpion81 

GPL 

Community 

This add-on is bundled with Blender. 


Icon Viewer 


An add-on that will help you to find an icon for your script 
and copy its name to the clipboard. 
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Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Development then Icon Viewer to enable the 
Script. 


Interface 


Located in the Text Editor >» Sidebar > Icon Viewer. 


Located in the Python Console » Header > Icon Viewer. 


Instructions 


1. Use the search field to filter the icons displayed by 
name. 

2. Click on an icon in the display and it’s name will be 
copied to the clipboard. 

3. Paste the name into the text editor of choice to use it in 
your add-on. 


Reference 

Category: Development 

Description: Click an icon to copy its name to the 
clipboard. 

Location: Text Editor » Dev Tab >» Icon Viewer 

File: development_icon_get.py 

Author: roaoao 

Maintainer: Blender Foundation 

License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


Is Key Free 


Primarily used to check the availability of shortcuts and the 
editor types they are associated with. 


Activation 


e Open Blender and go to Preferences then the Add-ons 


tab. 
e Click Development then Is key Free to enable the script. 


Instructions 


Search 
All the registered keys associated with the pattern 
entered in the Key field and selected modifier shortcuts 
will be displayed. Click the Search icon to list the 
associated keys. 


Quick Type 
Alternatively, a list with free shortcuts is available for 
quick access of keys from the Quick Type selector. 


List All Shortcuts 
Print a list of all used shortcuts to the Text editor. 


Reference 
Category: Development 
Description: Find free shortcuts, inform about used 


and print a key list. 
Location: Text Editor >» Sidebar >» Dev tab 


File: development_iskeyfree.py 


Author: Antonio Vazquez (antonioya) 
Maintainer: Blender Foundation 
License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


Import-Export 


Import & Export of Node Shaders 


3D-Coat Applink 

Atomic Blender (PDB/XYZ) 
BioVision Motion Capture (BVH) 
AutoCAD DXF 

Camera Animation 

Paper Model 

Pointcache (pc2) 

FBX 

Images as Planes 

Import Palettes 

NewTek MDD 

Nuke Animation (chan) 

STL 

Scalable Vector Graphics (SVG) 
Stanford PLY 

UV Layout 

Wavefront OBJ 


Web3D X3D/VRML2 
gITF 2.0 


Import & Export of Node 
Shaders 


While Blender now only supports the advanced node-based 


Support a basic shading model, similar to the legacy fixed 
pipeline of old GPUs. 


Blender features a way to convert between those, which any 
add-on can use, but it is currently pretty basic still. 
Especially for exporting from Blender materials, the node 
system must follow some strict requirements. 


Note 


Currently, only the OB) and FBX IO add-ons uses that 
method. 


Tip 


The gITF format uses a more detailed conversion to and 
from shader nodes. 


Note 


The wrapper is designed to be as symmetrical as possible 
(i.e. it is expected to give reproducible results across 
several import/export cycles). 


A typical setup of shader nodes that is can be 
exported. 


Supported Node Setup 


This is especially important for exporting, importing will 
simply re-generate a similar setup. 


Note that the features listed below are those supported by 
the wrapper. Each add-on may have its own way to adapt 
them to its material system, some may not be handled by it, 
etc. 


Principled BSDF 
The main shader must be a Principled BSDF. Only 
parameters defined there, and textures linked to it, will 
be exported. 


Currently handled parameters: 


e Base color 
e Specular intensity 
e Specular tint (no texture support) 


Roughness 
Metallic 

IOR 
Transmission 
e Alpha 


Normal Map 
If linked to the Normal input of the Principled BSDF node, 
the Normal Map node is also supported (including its 
texture obviously). 


Textures 
Only Image textures using a UV mapping are supported. 
You may also use a Mapping node to move/rotate/scale it. 


3D-Coat Applink 


Reference 
Category: Import-Export 
Panel: Properties » Scene > 3D-Coat Settings 


3D-Coat is a sculpting/painting program. With this 3D- 
Coat/Blender applink add-on you can exchange objects and 
textures between these two programs. 


Atomic Blender (PDB/XYZ) 


The Atomic Blender (PDB/XYZ) add-on imports atomic 
structures (molecules, crystals, clusters, particles, surfaces, 
etc.), which are described in PDB (.pdb) and XYZ files (.xyz) 
(Import PDB/XYZ). The add-on reads the coordinates of all 
atoms in the PDB/XYZ file and represents the atoms as balls 
in the Blender world. Also the sticks, which are described in 
PDB files only, are shown if the sticks are explicitly listed in 
the PDB file. The Principled BSDF shader is used to describe 
the material properties of the atoms. 


For the import, many options can be chosen, which allow 
representing the atoms and sticks in different ways. With 
help of several tools in the Atomic Blender Utilities panel, 
the atomic structures can be modified after the import. 


Note that the coordinates of selected atomic structures in 
the Blender 3D world can also be exported into PDB/XYZ 
files. 


General motivation: Atomic Blender (PDB/XYZ) is 
interesting for scientists, who want to visualize with Blender 
their atomic structures described in PDB or XYZ files. Thanks 
to Blender, fancy graphics of molecules, crystal structures, 
surfaces, nanoparticles, clusters and complex atomic 
arrangements can be obtained. Such graphics meet the 
standards of top-level journals, which have a high impact 
factor. See Examples at the end of this page. 


See also 


Info about PDB and XYZ 


e Description of the PDB file format: Wikipedia and 
RCSB. 

e Description of the XYZ file format: Wiki 
Babel. 

e Some notes about PDB and XYZ files can also be found 
here and here. 

e Many molecules can be downloaded from the RCSB 
site (go to ‘Download’). 

e A list of software that deals with PDB in different ways 
can be found on the RCSB site. There also is Vesta, ASE 
and all the quantum chemical calculators used in 
research, which can create or even calculate atomic 
structures and store them in PDB/XYZ files. 


pedia and Open 


See also 
Forum 


e Please, use the Blender Artists forum for comments 
and questions or directly the Blender chat. 

There also is the possibility to ask questions on Stack 
Exchange. However, note that some of the developers 
like Blendphys don’t have enough credits, which are, 
however, needed to have the permission for giving 
answers on Stack Exchange. 


Hint 
Defects in an Atomic Structure 


If you want to show defects like vacancies in an atomic 
structure, use an ‘X’ for the element name in the PDB or 
XYZ file (See here). A defect is shown in the form of a cube. 


Import PDB/XYZ 


Operator Presets 
Camera 
¥ Object to origin 
Balls / atoms 


Type of... NURBS 


Scaling factors Balls 1.00 
Distanc 1.00 


Type Pre-defined 


Sticks / bonds 
¥ Usesticks 
Type Dupliverts 


Sector 20 ¥ Color 


Radius 0.20 ¥ Smooth 


Unit 0.05 Bonds 


The panel with the options for PDB import. 


Camera & Lamp 


A camera and/or a light source are placed into the 3D world. 
Both are placed such that the entire atomic structure can be 
well seen by the camera with enough light from the light 
source. 


Object to Origin (PDB) 


The atomic structure is placed into the origin (0.0, 0.0, 0.0) 
of the 3D world. 


Object to Origin (XYZ) 


Either in only the first or in all frames, the atomic structure 
is put into the origin (0.0, 0.0, 0.0) of the 3D world. 


Balls/Atoms 


Type Of 
Choose either NURBS, Mesh or Metaballs for the atoms. 
For option Mesh, the Azimuth and Zenith values can be 
chosen. Metaballs can lead to some fancy effects: for 
instance, if enough large, their shapes melt together 
showing some kind of surface effect. 


Scaling Factors Operator Presets 
The atom Camera 
radii as well 
as the 
distances 
between the 
atoms can Type of .. NURBS 
be scaled by 
a simple 


factor. Scaling factors Balls 1.00 
Distanc 1.00 


Lamp 


Object to origin (first frames) 


¥ Object to origin (all frames) 


Balls / atoms 


Type Type of... Pre-defined 
The type of 
atom radius 
(atomic, van Load all frames? 
der Waals or 
as 
predefined) 


Frames 


can be The panel with the options for XYZ import. 
chosen. 


Sticks/Bonds (only PDB) 


Use Sticks 
Use sticks or not. Note that the sticks must be listed in 
the PDB file. The add-on does not ‘calculate’ possible 
bonds between atoms, which are then shown as sticks! 


Type 
In general, the options Sector and Radius determine the 
precision and dimension of the sticks, respectively. 
Option Smooth always means that a Smooth operator is 
applied on the sticks. Option Color means that the stick is 
divided into two parts, showing the colors of the 
respective two atoms which it connects. 


Instancing Vertices 
The sticks of one element are put into one instancing 
vertex structure and the sticks appear as cylinders. 
The instancing vertex structure makes the displaying 
and loading of many sticks relatively fast (see Section 
The instancing_ vertex structure for more info). Options 
Unit is the length of a unit (a small cylinder): several 
of such units are put together forming actually the 
stick (cylinder). The longer the unit length is the less 
is the number of such units and thus the faster is the 
displaying. However, if the unit length is too long the 
stick becomes eventually longer than the bond length 
(distance between atoms). This can then lead to a 
‘overlapping effect’ where a stick intersects the 
atoms. Option Bonds displays apart from single also 
double, triple, etc. bonds whereas option Distance is 


the distance between the bonds measured in stick 
diameter. 


Skin 
The skin and subdivision modifiers are used to build 
the sticks. This gives a nice network of sticks, which 
can be used to show, e.g. only the bonds of the 
structure (delete the atoms before!). Options SubDivV 
and SubDivR are parameters of the subdivision 
operator. If option Smooth is activated, the initial 
squarish profile of the sticks changes to a more 
circular one. Note that if this option is chosen, there is 
only one object representing all sticks. 


Normal 
Normal cylinders are used. For each bond, one 
individual cylinder is used. If option One Object is 
activated, about No sticks are joined into one mesh 
object. This makes displaying the sticks very fast. 
However, individual sticks do not exist anymore. 


Frames (only XYZ) 


Load All Frames 
Load only the first or all frames. 


Skip Frames 
Skip and load only each n-th frame. This is quite useful 
for large data where it might be sufficient to show only 
each 4th frame. 


Frames/Key 
Show a specific number of frames per key. Many frames 
in a key lead to a more fluid presentation. 


Important 


Please, keep in mind: the number of atoms in a frame 
has to be the same for all frames! 


The instancing vertex structure 


It is essential to 
understand, how the 
atoms (and sticks) of an 
atomic structure are 
organized inside 
Blender. This is why we 
focus a little bit onto 
this in the following: 


When atomic structures 
are imported via the 
PDB or XYZ importer, 
the atoms are put into a 
so-called instancing 
vertex structures, The NaCl structure in the outliner. 
somewhat into ‘groups’ 

of elements. For 

instance, all sodium atoms of a NaCl structure form one 
instancing vertex structure, and the same applies for the 
chlorine atoms (see figure). In the case of the sodium 
atoms, there is a collection Sodium that includes the 
collection Sodium_atom. Within the latter, the Sodium_mesh 
is composed of the mesh itself (Mesh Sodium) and a ball 
called Sodium_ball. The mesh only contains vertices (no 
objects!), and the vertices are located at the x,y,z positions 
specified in the PDB/XYZ file. What Blender is doing is 
simply ‘duplicating’ the ‘representative’ ball Sodium_ball at 
all the vertices! Because only one ball is used, it makes 
things incredibly fast by representing, e.g., a thousand of 


atoms inside Blender. Note that the representative ball is in 
the center of the structure, without having any meaning. 
This is the reason why the visibility switch of the 
representative ball is switched off (see red arrow)! 


There are some consequences: a) The representative ball 
appears at all vertices with the same orientation. b) 
Changing the material properties of the representative ball 
changes the properties of all duplicated balls. c) A ball is 
NOT an individual object, it is rather a linked member of the 
structure. Actually, the object as such does not exist. 


The NaCl structure in the outliner. 


Modifications 


Displacing an ‘individual’ atom 
For this, the respective vertex has to be displaced: go 
into the Edit Mode and select the atom. You can now 
displace the atom (vertex). 


Changing material properties (of all atoms) 
For this, the material properties of the representative ball 
must be changed: in the outliner, switch on the visibility 
of the representative ball (here, Sodium_ball, see red 
arrow in figure). You can then select the ball and change 
the material properties. After, make unvisible the 
representative ball, otherwise it appears in the structure. 


Separate an atom 
For this, see Section Separate Atoms. 


For making the handling of the atomic structures a bit more 
easy, the utility panel can be used, see the next Section. 


Hint 


Converting All Atoms of an Instancing Vertex 
Structure to Real Independent Objects 


Do the following: Select the atomic structures with the 
mouse and use Make Instances Real. With this, you 
produce real independent objects! In the Outliner, delete 
the remaining instancing vertex structures, named like 
“Carbon”, “Hydrogen”, etc. 


Note that if the structures represent many hundreds and 
thousands of atoms, Blender can be become quite slow: at 
once, all these new atoms are represented as individual 
ball objects and Blender has to deal with all of them in 
several ways. As mentioned above, for each instancing 
vertex structure, there is only one representative ball 
object! 


Atomic Blender Utilities Panel 


The Atomic Blender Utilities panel makes your life easier 
during manipulating atoms of imported structures. 


Atom 

Number ee 

Name : Hydrogen 
Short name : 4H 

Radius used : 0.320000 
Radius, covalent : 0.320000 
Radius, atomic : 0.790000 
Charge state ie | 

Radius, ionic : 1.540000 
Color : 1.0,1.0,1.0,1.0 
P BSDF Subsurface method : BURLEY 

P BSDF Distribution : MULTI GGX 

P BSDF Subsurface : 8.68 

P BSDF Subsurface Color - 1.8, 1:0, 1.8, 1.6 
P BSDF Subsurface Radius : 1.0, 0.2, 0.1 
P BSDF Metallic : 0.0 

P BSDF Specular + 6.5 

P BSDF Specular Tilt 3.025 

P BSDF Roughness :, 6.5 

P BSDF Anisotropic 7 8.5 

P BSDF Anisotropic Rotation : 0.5 

P BSDF Sheen > 0.5 

P BSDF Sheen Tint > 0.5 

P BSDF Clearcoat = 66 

P BSDF Clearcoat Rough : 0.030 

P BSDF IOR 21.4 

P BSDF Trans : 0.0 

P BSDF Trans Roughness : 0.0 

P BSDF Emisssion :. 6.6...6.6,.6:6;,. 1.6 
P BSDF Emission Strength : 0.0 

P BSDF Alpha 1.8 

Eevee Use Backface Culling : True 

Eevee Blend Method : OPAQUE 

Eevee Shadow Method : OPAQUE 

Eevee Clip Threshold ‘-8.5 

Eevee Use Screen Refraction : False 

Eevee Refraction depth > 0.5 

Eevee Use SSS Translucency : False 

Eevee Pass Index 3 8 


The entry for hydrogen in the custom data file. 


Custom Data File 


A separate custom data file can be loaded, which contains 
for each element the following information: 


¢ All types of radii (atomic, VdW, ionic) in A 

e Ball color 

e Other material properties for the Principled BSDF 
shader. 


Such an option is useful when it is desired to use predefined 
values for atom radii and shader properties. An example can 


be downloaded from here: Custom data file. 


The custom data file is an ASCII file, which can be duplicated 
and modified by the user. The radius and material properties 
of the atoms can be changed as follows: open the ASCII file 
with a standard text editor, search the name of the atom 
and change the radius (Radius used). Do the same with, e.g., 
the RGB values for the color (Color). The value RGBA(1.0, 
1.0, 1.0, 1.0) corresponds to white and RGBA(0.0, 0.0, 0.0, 
1.0) is black. Note that the last value of a color tuple is the 
alpha value of the color. Furthermore, several other 
properties such as Metallic, Roughness and Transmission can be 
changed. These are the properties in the Principled BSDF 
shader. There are also some properties for Eevee, which can 
be used to determine the object’s transparency etc. 


Note that in the header of the custom data file, all possible 
values of the string options P BSDF Subsurface method, P BSDF 
Distribution, Eevee Blend Method and Eevee Shadow Method are 
listed. 


Inside Blender, the data file needs to be loaded first. The 
colors and material properties are changed after executing 
Apply. Note that only selected atoms are changed! 


¥ Atomic Blender Utilities 


Custom data file 


Apply 


Measure distances 
Measure ... 


Distance (A) 


Change atom size 


predefined 


2. Radii in pm 
Atom name 
100.00 
3. Radii by scale 
Scale 1.05 


Smaller ... Bigger ... 


Change stick size 
Scale 1.05 


Smaller ... Bigger ... 


Change atom shape 


Shape Unchanged 


Materi.. Unchanged 


Special: None 


Default values 


Separate atoms 


The Atomic Blender Utilities panel. 


Measure Distances 


With this tool the distance of two objects in the Object Mode 
but also in the Edit Mode can be measured. The unit is 


Angstrom. 


Change Atom Size 


Note that the atomic structures must be selected! 


Type of Radii 
Type 
With this selector the type of radii can be chosen. 
Fither one uses Predefined, Atomic or Van der Waals 
radii. The default values for Predefined radii are the 
Atomic radii. 


Charge 
For option /onic radii, the charge state can be chosen 
and the radii of selected objects are instantaneously 
changed. Select one type of atom (e.g. only all 
hydrogen ones) and then apply the charge state. 
Changes only apply if a charge state of an atom is 
available. See, e.g., in the Custom data file. 


Radii in pm 
The radii of all atoms that belong to one element can be 
manipulated. Type in the name of the atom (e.g. 
‘Hydrogen’) and choose the radius in picometer. 


Radii by Scale 
This modifies the radii of all selected atoms and atom 
structures with one scaling factor. Type in the scaling 
factor and increase or decrease the size of the radii by 
using the Bigger or Smaller button, respectively. 


Change Stick Size 


The diameter of selected sticks are changed. The buttons 
Bigger and Smaller allow increasing or decreasing the 
diameter, respectively. The scale factor determines, how 
strong the change of diameter will be. By using the Outliner, 
one can apply these operators on only a selection of sticks 
(e.g. only the sticks of the hydrogen atoms). Note that 
changes only apply if the sticks are individual objects, e.g. 
single cylinders or if the sticks are described in instancing 
vertex structures. 


Change Atom Shape 


It is possible to change the atom’s shape to a sphere, cube, 
icosphere, etc. Furthermore, the material of the atom can be 
changed. First, select your atoms in the 3D Viewport or the 
Outliner. 


Shape 
Choose the shape in the first selector. 


Material 
Choose one of the materials in the second selector. The 
materials are only examples, further refinements can be 
done in the Materials tab of the Properties. 


Special 
Here, you can choose an object with a special shape, 
material, etc. Such objects are quite nice to represent 
defects in atomic structures. When choosing such a 
special object, you cannot anymore separately choose 
the shape and material from above. In the Objects and 
Materials tabs of the Properties further changes can be 
done. 


Button Replace 


After all, push the Replace button. The shape and/or 

material of all selected atoms are then changed. This 
option works for objects and instancing vertex object 
structures. 


Button Default 
If you want to have the default values (NURBS spheres 
and specific element colors and sizes) of selected atoms 
push the Default button. 


Separate Atoms 


To separate single atoms, select the atoms (vertices) first in 
the Edit Mode. Upon choosing Edit Mode, the Separate 
button appears at the bottom of the Atomic Blender Utilities 
panel. If the selectors in Change atom shape remain on 
Unchanged the type of object (NURBS, mesh, meta) and its 
properties will not be changed upon separation. 


After having chosen the atoms, use button Separate Atoms 
to separate the selected atoms: the atoms are now single, 
new objects, which can be manipulated in standard way. 
They appear in the Outliner and carry the suffix sep. 


Examples 


Different Part of a DNA 
presentations of one molecule. 
and the same 

molecule. 


THE JOURNAL OF 


PHYSICAL 
CHEMISTRY 


Energy 
Science & 
Engineering 


Oa x | 
ENERGY CONVERSION AND STORAGE, OPTICAL AND ELECTRONIC DEVICES, 
INTERFACES, NANOMATERIALS, AND HARD MATTER 


se ACS Publications www.36s.07g 
‘ors Most Che, ost ead 


Functionalized Solar cell structure 


[5]helicene to underline the 
molecules on the properties of silicon 
NaCl(O0O1) surface nanocrystals 
(Clemens Barth et deposited by pulsed 
al. - Link to spray system 
publication). (Mickael Lozac’h et 
al. - Link to 
publication). 


This video was created by Sébastien Coget (responsible 
researcher: Frank Palmino) at the Femto-ST institute in 
Besancon (France). The movie demonstrates that with 
Blender, professional movies can be done for research. It 
was rendered with Cycles. 


BioVision Motion Capture 
(BVH) 


Reference 
Category: Import-Export 
Menu: File >» Import/Export » Motion Capture 


(.bvh) 


Imports or exports bvh-files or files with BioVision 
Hierarchical data or data of a skeleton (rig) including its 
animation. Useful for importing data from motion capture 
devices. 


Properties 


Import 


Target 
The motion capture data type. 


Armature: The bvh-file contains an animated 
rigged skeleton such as a walking 
motion capture. 

Object: The bvh-file contains a static (not 
animated) mesh object such as a 
character model. 


Transform 


Scale 


Factor to increase the physical size of the BVH. 


Rotation 


Todo 
The documentation here is incomplete, you can help by 
contributing. 


Forward / Up 
Since many applications use a different axis for pointing 
upwards, these are axis conversion for these settings, 
Forward and up axes - By mapping these to different 
axes you Can convert rotations between applications 
default up and forward axes. 


Blender uses Y forward, Z up (since the front view looks 
along the +Y direction). For example, its common for 
applications to use Y as the up axis, in that case -Z 
forward, Y up is needed. 


Animation 


Start Frame 
The start frame, in Blender, to start playback of the BVH 
animation. 


Scale FPS 
Scales the frame rate from the BVH file to the scene 
frame rate set in Blender, otherwise each BVH frame 
maps directly to a frame in Blender. 


Loop 
Cycles the animation playback. 


Update Scene FPS 


Set the scene’s frame rate to match the frame rate of the 
BVH file. 


Update Scene Duration 
Extend the scene’s duration to match the BVH’s duration. 


Export 
Transform 


Scale 
Factor to increase the physical size of the BVH. 


Rotation 
TODO. 


Root Translation Only 


Only write the translation animation channels for the root 
bone. 


Animation 


Start / End 
Sets the range of animation to export to the BVH file. 


AutoCAD DXF 


Reference 

Category: Import-Export 

Menu: File > Import/Export » AutoCAD DXF 
Import 


DXF layers are reflected as Blender groups. This importer 
uses a general purpose DXF library called “dxfgrabber”. 


DXF Type Mapping 


To be as non-destructive as possible the importer aims to 
map as many DXF types to Blender curves as possible. 


DXF to Curves 


e LINE aS POLYLINE Curve (with the option to merge 


connecting lines). 
(LW)POLYLINE, (LW)POLYGON aS POLYLINE curve if they have no 


bulges else as BEZIER Curve. 
e ARCS, CIRCLES and ELLIPSES aS BEZIER Curves. 
HELIxXes (3D) aS BEZIER Curves. 


DXF to Meshes 


e MESH iS mapped to a mesh object with a Subdivision 
Surface modifier, including the edge crease. 
e POLYFACES and POLYMESHeS are imported to a mesh object. 


e 3DFACE S, SOLID S, POINT S are imported into one combined 
mesh object per layer called layername_3Dfaces. 


Missing DXF Types 


e Hatches 
e Leader 


Properties 
Merge Options 


Blocks As 
DXF Blocks can be imported as linked objects or group 
instances. Linked objects use parenting for DXF sub- 
blocks (blocks in blocks). 


Parent Blocks to Bounding Boxes 
Draw a bounding box around blocks. 


Merged Objects 
Since Blender (v2.71) is pretty slow at adding objects the 
user might want to merge similar DXF geometry to one 
object. 


By Layer 
Produces one object per layer; if there is mesh, curve, 
lamp, text data on one layer one object per layer and 
per Blender object. 


By Layer and DXF Type 
The second not only differentiates between Blender 
data types but also DXF types, such as LWPOLYLINE and 
POLYLINE. 


By Layer and Closed No-bulge Polygons 
Closed polylines with no bulge, that is no curved 
edges, can be merged to one single mesh. This makes 
sense when the DXF polylines have an extrusion 
and/or an elevation attribute, which basically 
describes a location/rotation/scale transformation. If 
this merge option is chosen, line thickness settings 
will be ignored/disabled. 


By Layer and DXF-Type and Blocks 
For DXF files with a block being referenced many 
times, this option allows to insert the same block 
many times with one instanced-face object instead of 
with one object for each time the block needs to be 
inserted. Unfortunately this works only for block 
inserts that are uniformly scaled. Non-uniformly scaled 
block inserts are being imported as defined in Blocks 
AS. 


Combine LINE Entities to Polygons 
Separated lines in DXF might be merged to one 
consecutive Blender poly curve. Similar to Remove 
Doubles but for curves. 


Line Thickness and Width 


Represent Line Thickness/Width 
DXF line attributes thickness and width have an effect on 
line in Z and X/Y direction respectively. A straight line 
might be turned to a cube by its attributes for instance. 
Therefore, in Blender these attributes are represented 
with curve extrusion, bevel and taper objects. 


Merge by Attributes 
If both Merged Objects and Represent Line 
Thickness/Width are activated the object merging needs 


to be extended to separate all lines width different 
thickness and width. With Merge by Attributes this 
separation option is also available without the actual 
representation of line thickness and width. 


Optional Objects 


Import TEXT 
(TEXT, MTEXT) 


Import LIGHT 
Including support for AutoCAD colors. 


Export Acts Entities 
Export NURBS 3D geometry (BODY, REGION, PLANESURFACE, 
SURFACE, 3DSOLID) to ACIS-Sat files, since this is the format 
AutoCAD stores NURBS to DXF. You are going to be 
notified about the amount of stored .sat/.sab files. 


View Options 


Display Groups in Outliner(s) 
Switch the Outliner display mode to Groups (DXF layers 
are mapped to groups). 


Import DXF File to a New Scene 
Todo. 


Center Geometry to Scene 
Center the imported geometry to the center of the scene; 
the offset information is stored as a custom property to 
the scene. 


Georeferencing 


Important: DXF files do not store any information about the 
coordinate system / spherical projection of its coordinates. 
Best practice is to know the coordinate system for your 
specific DXF file and enter this information in the DXF 
importer interface as follows: 


Pyproj 
Installation: Download (Windows, macOS) Pyproj and 
copy it to your 


AppData/ApplicationSupport 
Folder/Blender/3.4/scripts/modules/. 


In case you need to compile your own binary refer to this 
post on Blender Artists. 


Pyproj is a Python wrapper to the PRO] library, a well- 
known C library used to convert coordinates between 
different coordinate systems. Open source GIS libraries 
such as PRO] are used directly or indirectly by many 
authorities and therefore can be considered well- 
maintained. 


If Pyproj is available the DXF importer shows a selection 
of national coordinate systems but lets the user also to 
enter a custom EPSG / SRID code. It also stores the SRID 
as a custom property to the Blender scene. If a scene has 
already such an SRID property the coordinates are being 
converted from your DXF file to target coordinate system 
and therefore you must specify an SRID for the DXF file. 
If no SRID custom property is available the scene SRID is 
by default the same as the DXF SRID. 


No Pyproj 
In case Pyproj is not available the DXF importer will only 
use its built-in lat/lon to X/Y converter. For conversion the 
“transverse Mercator” projection is applied that inputs a 


lat/lon coordinate to be used as the center of the 
projection. The lat/lon coordinate is being added to your 
scene as a custom property. Subsequent imports will 
convert any lat/lon coordinates to the same 
georeference. 


Important: So far only lat/lon to X/Y conversion is 
supported. If you have a DXF file with Euclidean 
coordinates that refer to another lat/lon center the 
conversion is not (yet) supported. 


Rules of thumb for choosing an SRID 
if you have your data from OpenStreetMap or some 
similar GIS service website and exported it with QGIS or 
ArcGIS the coordinates are most likely in lat/lon then use 
WGS84 as your SRID with Pyproj or “spherical” if Pyproj is 
not available. For other DXF vector maps it’s very likely 
that they use local / national coordinate systems. 


Open the DXF with a text editor (it has many thousands 
of lines) and make an educated guess looking at some 
coordinates. DXF works with “group codes”, a name 
Autodesk invented for “key” as in key/value pairs. X has 
group code 10, Y has 20, Z has 30. If you find a pattern 
like: 


10, newline, whitespace, whitespace, NUMBER, newline, 
20, newline, whitespace, whitespace, NUMBER, newline, 
30, newline, whitespace, whitespace, NUMBER 


then NUMBER will be most likely your coordinates. You can 
probably tell from the format and/or the range of the 
coordinates which coordinate system it should be. 


Export 


Supported Data 


e Mesh face: POLYFACE or 3DFACE 
e Mesh edge: LINE 
e Modifier (optionally) 


Unsupported Data 


e Mesh vertex: POINT 
e Curve: LINES Or POLYLINE 
e Curve NURBS: curved-POLYLINE 
e Text: TEXT or (Wip: MTEXT) 
e Camera: POINT Or VIEW Or VPORT or (Wip: 
INSERT (ATTRIB+XDATA) ) 
e Light: POINT or (Wip: INSERT (ATTRIB+XDATA) ) 
e Empty: POINT or (wip: INSERT) 
e Object matrix: extrusion (210-group), rotation, elevation 
e 3D Viewport: (Wip: VIEW, VPORT) 
e Instancing vert: auto-instanced or (wip: INSERT) 
e Instancing frame: auto-instanced or (wip: INSERT) 
e Instancing group: auto-instanced or (wip: INSERT) 
e Material: LAYER, COLOR and STYLE properties 
e Group: BLOCK and INSERT 
e Parenting: BLOCK and INSERT 
e Visibility status: LAYER on 
e Frozen status: LAYER frozen 
e Locked status: LAYER locked 
e Surface 
e Meta 
e Armature 
e Lattice 


Camera Animation 


Reference 
Category: Import-Export 
Menu: File » Export » Cameras & Markers (.py) 


Todo. 


Paper Model 


Reference 

Category: Import-Export 

Menu: File » Export >» Paper Model (.pdf/.svg) 
Panel: Properties » Mesh >» Paper Model Islands 
Menu: Mesh » Unfold 


This add-on generates a flat net of a given mesh. It creates 
either PDF or SVG files suitable for direct printing and paper 
modeling. The main goal is a maximal possible automation 
of the whole process. Common tasks like baking the model’s 
texture into the output document are also supported. 


Usage 


To avoid eventual issues, switch to Object Mode. Then, 
select the mesh you want to export so that it is the active 
one. If you want to get results quickly, just execute this add- 
on from the File » Export menu. It will ask for a file name 
and do everything else automatically. All relevant settings 
are in the bottom left corner. These are described in more 
detail below. 


If you are unhappy with the generated net, you can edit it 
manually. For this, you have to execute the Unfold tool first 
(available Mesh tab in the Properties). Edges that will be cut 
in order to flatten the mesh must be marked as Edit Mode 
seams. You can use Clear Seam and Mark Seam tools to 
organize them as you wish, or use the helper button Clear 
All Seams in Object Mode to start from scratch. When you 


export the model, it will use all the given seams and add 
some more cuts if necessary. 


You can also call the Unfold tool just for a preview of the net. 
It will list all islands of the produced net in the panel and if 
you enable so in the tool’s settings, it will also create a UV 
layout showing the islands. Note that island positions are 
not calculated in this stage, so that they will all just lay on 
top of each other. You can use Blender’s Pack Islands tool to 
arrange them. 


There are a few kinds of topology that are possible in 
Blender but not in paper reality: 


e N-gon faces (everything except triangles) that are not 
perfectly flat. 

e Zero-length edges (two vertices exactly in the same 
spot and connected by an edge) 

e Zero-area faces (typically their vertices lie all in line) 


If any of these cases is detected, the add-on will throw an 
error message and will not export. The error message 
guides you how to fix the issues. 


Exporting Textured Meshes 


To export your model with a hand-painted texture, you have 
to unwrap the model, paint an image and assign it to the 
model so that it has an effect during render. You can use any 
tools you like for these tasks. What the add-on does is 
simply that it uses baking in Textures mode. 


Switch to Object Mode and deselect any objects except the 
one to be exported. Then execute Export Paper Model and in 
the File Browser switch the Textures selector to From 
Materials. 


If you choose to export an SVG file, you get several options 
how to attach the images. All the options are explained in 
more detail Properties. 


The resulting texture does not depend on any scene settings 
except for the given material, and on the other hand, all 
settings should be intact after doing the export. 


How to Read the Net 


Most of the document’s appearance can be customized 
during export (see below). However, the default style is 
supposed to be familiar to paper modelers: dashed lines 
represent folding outwards, dash-dotted lines inwards (i.e., 
to form concave shapes). Boundary of each part of the net is 
rendered in solid lines. Sticking tabs have a grayish fill color 
to be distinguishable from other parts of the net. 


A label is written on a tab when its target edge might not be 
clear. Specifically, the label is omitted if the edge will be 
sticked to the same place as its both neighbors or if one of 
these is the target itself. The format of labels is 

island abbreviation: edge number. ISland abbreviation is 
written in square brackets under the corresponding island, 
before to its full-length name. Edge number is written as a 
triangle arrow next to that target edge, outside the net. 


If Create Tabs is disabled, the same format is used for labels 
along each of the related edges, inside the net. This method 
is designed for modeling from hard and/or thick materials, 
for which sticking tabs are quite pointless. If Create 
Numbers is disabled, the labels are omitted; this may be 
necessary for highly detailed models. 


How to Print the Net 


The PDF file can be directly printed almost anywhere. 
However, things become difficult if you need to change the 
net by hand. 


If you select the SVG format, you can edit the exported files 
in a vector graphics editor such as Inkscape. One reason 
why you may want to do is to pack the islands manually and 
Save paper. Another reason is that the tabs and numbers 
often make a lot of clutter around the model and it can be 
helpful to remove some of them by hand. 


If printed document gets cropped around the page borders, 
it means you should increase the Margin setting during 
export. 


Placing Marks on the Net 


Edges with a Freestyle Mark (Edge >» Mark Freestyle Edge) 
will be highlighted in the net with a user-defined color and 
drawing style. This is helpful especially when used on flat 
edges, which would normally not be drawn at all. If you 
draw a Shape with the Knife tool and then mark some of the 
edges as Freestyle ones, you can make a simple line 
drawing on the model. 


When used on folding edges, the highlight will be drawn 
below the folding line. So you will probably have to change 
the Freestyle Lines drawing style to make it wider and not 
black, so that the lines stay distinguishable. 


Settings 


Paper Model Islands 


The Paper Model Islands tab in the Mesh tab offers two 
buttons for calling the Unfold and Export Paper Model tools 
conveniently. It also offers buttons for marking and clearing 
seams, depending on the context, and the experimental 
functionality Limit Island Size. 


Once the Unfold tool is called, the model is split into 
flattened parts and these are presented in a list called 
Islands below. The list allows you to change the label of 
each island. If Create Numbers is enabled during export, 
abbreviations of these labels will be used to describe which 
tab should be sticked to which island. After running the 
Unfold tool, these island labels are recalculated so that as 
many faces as possible remain under the same label. 


If you select an island and enable the Highlight Selected 
Island button (and the mesh you unfolded is the active one), 
the island will be highlighted in orange in the 3D Viewport. 
Using the slider below, you can change the opacity of the 
highlight. 


Unfold 


The first option from top is Create UV map. If enabled, a new 
UV map will be generated to show all the islands. However, 
their positions are not calculated yet at this time of the 
export process, so they are all just placed in the bottom left 
corner. This option is useful when editing the cutting lines by 
hand. You can use the Unwrap tool and get a similar result. 


The tool has three sliders, which all adjust edge cutting 
priority (namely: Face Angle Convex, Face Angle Concave, 
Edge Length). A high value gives an edge with the 
corresponding property a higher chance to be cut. Because 
of that, it is usually better to set Edge Length to a negative 
value, letting long edges stay connected. Randomly 


modifying these values may often help to reduce the count 
of islands in the net. For information about the meaning of 
these values, read the Unfold section in the Technical 
Details. 


Properties 


When the export is initiated, the add-on silently unfolds the 
mesh (without marking any seams) and divides all faces into 
islands, which may take a few seconds for complex meshes. 
Then, a File Browser is displayed. With SVG format, the file 
name you choose will get a _page<number>.svg suffix, even if 
only one page was needed. 


Settings of this exporter are presented in the bottom left 
corner of the File Browser. 


Preset 
The Preset menu allows to quickly save and recall all the 
settings below it, including model scale and color style. 


Model Scale 
Model Scale can be used to scale the whole net. If you 
want to have a model in 1:72 scale, just set this to 72. 
This is an important option also because the add-on often 
produces islands bigger than the page. 


By default, this value is set so that even the biggest 
island fits onto the page. If set to one, the real model will 
have the same dimensions as the virtual one. 


Create UV Map 
Has a similar effect as the similar named option of the 
Unfold tool, but not the same. It will create a new UV 
map that exactly reflects the placement of all the 
model’s islands. Unfortunately, islands from all pages are 


placed on top of each other, and it is quite impossible to 
tell them apart. 


Document Settings 


Settings closely related to the format of the output 
document are in the Document Settings subpanel. 


Format 
First selector switches between PDF and SVG document 
formats. 


Page Size 
Another selector below allows you to choose one of the 
most common paper sizes quickly. If you need something 
else, choose User Defined and set the dimensions 
manually. 


Page Margin 
Makes it easier to export models in exact scale (if you set 
the Model! Scale slider to 1). 


You can set it to the width of the non-printable border of 
your printer, in order for the resulting SVG document to 
be printable without further scaling. However, exporting 
in-scale models is still difficult, as the add-on does not 
automatically split oversize islands. 


DPI 
The next value is DPI, which defines the overall resolution 
of the net. That is, not only resolution of baked images (if 
any), but also line thickness. 


Create Tabs 
Controls if the sticking tabs are created at all. For 
example, uncheck this if you want to stick the model 


using tape. 


Create Numbers 
Adds numbers to some edge pairs that are supposed to 
be sticked together. These numbers are excluded if the 
correct destination is easy to guess from the neighboring 
edges. In more complex models, they may overlap a lot 
with each other and with the net itself. Disabling this 
option may help solve such issues. If Create Tabs is 
disabled, the numbers will be rendered inside of the net. 


Tabs and Text Size 
Sets the maximal width of the sticking tabs around 
islands. The actual size of each tab is adjusted to be at 
most half the length of the corresponding edge. In some 
special cases, tabs are made not to overlap with real 
faces, but it does not work reliably yet. If Create Tabs is 
disabled, this slider controls the size of numbers on 
edges. 


Hidden Edge Angle 
Edges with folding angle below Hidden Edge Angle will 
not be drawn at all. Increasing this value may produce 
nicer results when exporting smooth surfaces, such as 
cylinders: it will soare a lot of unnecessary lines. 
Decreasing it could possibly help in some special cases. 


Textures 
The Textures select menu lists options for exporting 
textured meshes. 


No Texture 
Just creates the net on a white background (this used 
to be called “Pure Net”). The remaining options invoke 
texture baking and therefore are noticeable slower. 


From Materials 
Exports the image that is assigned to each of the 
model’s faces in their active material. 


Full Render, Selected to Active 
Correspond to the respective Bake Type options. They 
both render all the materials and illumination: Full 
Render renders the model only, while Se/ected to 
Active projects other nearby selected objects onto the 
model. It may be helpful for creating patterns such as 
fur or leaves procedurally. 


Images 
The Images select menu allows you to choose how to 
include the baked images in the SVG file. If you want to 
edit the layout of the net in an SVG editor, choose either 
Linked or Embedded. 


Embedded 
Creates standalone SVG files, making them bigger but 
portable. 


Single Linked 
Remains mostly for compatibility reasons. 


Colors and Style 


Options related to the drawing style are packed in the Colors 
and Style subpanel. They should be quite self-explanatory. 


Technical Details 


Unfold 


Firstly, the algorithm assigns every edge a “priority”, 
depending on its angle and length. Edges with higher 
priority will more probably be cut apart in the final net. 
Shorter edges have higher priority (they are easier to glue 
on) and sharper angles too (that makes the net easier to 
visually understand). 


Faces form a concave angle if their normals are pointing 
against each other. Such angles have even a bit higher 
priority which is supposed to help for typical models. If some 
face normals are flipped, the algorithm always assumes the 
angle between them be convex. 


If more than two faces are connected by an edge, two of 
them are designated as the main ones and all others will 
have to be glued. The main faces are chosen so that they 
form the smallest angle possible. 


The actual priority effect of angle versus length may change 
the resulting net very much. The default values were chosen 
by trial and error for some basic models, but may be a bad 
choice for others. If you want to tweak them, the Unfold tool 
allows you to: they are the tool’s three only settings. 


The cutting algorithm begins with all faces separated and 
tries to connect them to form bigger islands, ordered by the 
connecting edge’s priority. If some of the faces of the 
resulting island would overlap, the operation is canceled 
and the algorithm continues with another edge. If some 
vertices or edges end up close enough to each other, they 
are merged. During this process, each edge is visited 
exactly once. 


The overlap check is basically the Bentley-Ottmann 
algorithm for line segment intersection, applied to the 
boundary of the resulting island. To handle some special 


cases, the algorithm automatically switches between a 
Slightly quicker and a more robust version of itself. Another 
check is applied to detect if the boundary crosses itself in 
just a vertex of the resulting island - such cases have to be 
tested explicitly as they need not cause any intersecting line 
segments. 


Positioning the Nets on Pages 


Because the nets are not consisting only of the real faces, 
but also of the gluing tabs around, they cannot be 
positioned by the internal Blender tool (Pack Islands). 
Therefore, a standalone algorithm had to be written. 


For a great simplification of the process, all nets are packed 
into (smallest possible) bounding rectangles. These are then 
ordered by size (largest first) and in this order the algorithm 
tries to position them on a page. The positions tested for the 
lower left corner are given by ann xX ngrid resulting from all 
the corners of islands already positioned. A position is 
accepted or rejected by checking overlaps with each of the 
islands’ bounding rectangles. 


When there are any islands left that could not be placed 
onto the page, a new free page is created. 


This algorithm should work reliably and quite fast. However, 
it is clearly inefficient if the bounding rectangles contain 
much free space. Also, the packing depends heavily on the 
order in which the islands are processed, which is in no way 
optimal. 


Pointcache (pc2) 


Reference 
Category: Import-Export 
Menu: File » Export >» Pointcache (.pc2) 


This exporter produces pointcache files. These can be used 
to transfer animated meshes to external applications. Only 
the vertex positions at the samples are saved. 


The exporter can export meshes, surfaced curves, surfaces 
and font objects. They are all treated as meshes. The base 

object has to be converted into a mesh before exporting it 

also. 


Properties 


Convert to Y-Up 
Rotates the mesh data -90 degrees around X. 


Export into World Space 
Transform the mesh data into world space. 


Apply Modifiers 
Export objects using the evaluated mesh, meaning the 
resulting mesh after all Modifiers have been calculated. 


Start Frame 
First frame to export. 


End Frame 
Export up to this frame. 


Sampling 
The sample rate. 1 means one sample per frame. 0.1 
means 10 samples per frame, and 10 means one sample 
every 10 frames. 


Importing 


The use of these files depends on the importing application. 
In general the object has to be first exported normally (OB) 
export or the like) and then the pointcache data can be 
attached to the object. 


e In 3ds Max there is a modifier which can directly read 
pc2 files. 


e In Maya the pc2 cache has to be converted into Maya’s 
geometry cache format first. The MEL command for that 
is this: 


cacheFile -pc2 1 -pcf "<insert filepath of source>" -f " 
<insert target filename w/o extension>" 

-dir "<insert directory path for target>" -format 
"OneFile"; 


FBX 


Reference 

Category: Import-Export 

Menu: File > Import/Export > FBX (.fbx) 
Usage 


This format is mainly use for interchanging character 
animations between applications and is supported by 
applications such as Cinema4D, Maya, Autodesk 3ds Max, 
Wings3D and engines such as Unity3D, Unreal Engine 3/UDK 
and Unreal Engine 4. 


The exporter can bake mesh modifiers and animation into 
the FBX so the final result looks the same as in Blender. 


Note 


e Bones would need to get a correction to their 
orientation (FBX bones seems to be -X aligned, 
Blender’s are Y aligned), this does not affect skinning 
or animation, but imported bones in other applications 
will look wrong. 

Animations (FBX AnimStacks, Blender actions) are not 
linked to their object, because there is no real way to 
know which stack to use as ‘active’ action for a given 
object, mesh or bone. This may be enhanced to be 
smarter in the future, but it’s not really considered 
urgent, so for now you'll have to link actions to objects 


manually. 


e Armature instances are not supported. 


Note 


e Bones’ orientation importing is complex, you may have 
to play a bit with related settings until you get the 
expected results. 

e Animation support is minimal currently, we read all 
curves as if they were ‘baked’ ones (i.e. a set of close 
keyframes with linear interpolation). 

e Imported actions are linked to their related object, 
bone or shape key, on a ‘first one wins’ basis. If you 
export a set of them for a single object, you’ll have to 
reassign them yourself. 


Note 
Saving Just Animations 


The FBX file format supports files that only contain takes. It 
is up to you to keep track of which animation belongs to 
which model. The animation that will be exported is the 
currently selected action within the Action editor. To reduce 
the file size, turn off the exporting of any parts you do not 
want and disable Al! Actions. For armature animations 
typically you just leave the armature enabled which is 
necessary for that type of animation. Reducing what is 
output makes the export and future import much faster. 
Normally each action will have its own name but the 
current or only take can be forced to be named “Default 
Take”. Typically, this option can remain Off. 


Note 


Blender now only supports complex node-based shading. 
FBX having a fixed pipeline-like support of materials, this 
add-on uses the generic wrapper featured by Blender to 
convert between both. 


Properties 


Import 
Include 


Import Normals 
TODO. 


Import Subdivision Surface 
Todo. 


Import User Properties 
TODO. 


Import Enums as Strings 
TODO. 


Image Search 
TODO. 


Transform 


Scale 
Todo. 


Decal Offset 
TODO. 


Manual Orientation 
TODO. 


Forward / Up Axis 
Since many applications use a different axis for ‘Up’, 
these are axis conversion for these settings, Forward and 
Up axes - By mapping these to different axes you can 
convert rotations between applications default up and 
forward axes. 


Blender uses Y Forward, Z Up (since the front view looks 
along the +Y direction). For example, its common for 
applications to use Y as the up axis, in that case -Z 
Forward, Y Up is needed. 


Apply Transform 
TODO. 


Use Pre/Post Rotation 
TODO. 


Animation 


TODO. 


Animation Offset 
TODO. 


Armature 


Ignore Leaf Bones 
TODO. 


Force Connect Children 
TODO. 


Automatic Bone Orientation 


TODO. 


Primary/Secondary Bone Axis 


TODO. 


Export 


Path Mode 


When referencing paths in exported files you may want 
some control as to the method used since absolute paths 
may only be correct on your own system. Relative paths, 
on the other hand, are more portable but mean that you 
have to keep your files grouped when moving about on 
your local file system. In some cases, the path doesn’t 
matter since the target application will search a set of 
predefined paths anyway so you have the option to strip 


the path too. 


Auto: 


Absolute: 
Relative: 


Match: 
Strip Path: 


Copy: 


Embed Textures 
TODO. 


Uses relative paths for files which are 
in a subdirectory of the exported 
location, absolute for any directories 
outside that. 

Uses full paths. 

Uses relative paths in every case 
(except when on a different drive on 
Windows). 

Uses relative / absolute paths based on 
the paths used in Blender. 

Only write the filename and omit the 
path component. 

Copy the file on exporting and 
reference it with a relative path. 


Batch Mode 
When enabled, export each group or scene to a file. 


Group/Scene 
Choose whether to batch export groups or scenes to 
files. Note, when Group/Scene is enabled, you cannot 
use the animation option Current Action since it uses 
scene data and groups are not attached to any 
scenes. Also note, when Group/Scene is enabled you 
must include the armature objects in the group for 
animated actions to work. 


Batch Own Directory 
When enabled, each file is exported into its own 
directory, this is useful when using the Copy Images 
option. So each directory contains one model with all 
the images it uses. Note, this requires a full Python 
installation. If you do not have a full Python 
installation, this button will not be shown. 


Include 


Selected Objects 
Only export the selected objects. Otherwise export all 
objects in the scene. Note, this does not apply when 
batch exporting. 


Active Collection 
Todo. 


Object Types 
Enable/Disable exporting of respective object types. 


Custom Properties 
TODO. 


Transform 


Scale 
Scale the exported data by this value. 10 is the default 


because this fits best with the scale most applications 
import FBX to. 


Apply Scaling 
TODO. 


Forward / Up 
Since many applications use a different axis for ‘Up’, 
these are axis conversions for Forward and Up axes - By 
mapping these to different axes you can convert 
rotations between applications default up and forward 
axes. 


Blender uses Y Forward, Z Up (since the front view looks 
along the +Y direction). For example, its common for 
applications to use Y as the up axis, in that case -Z 
Forward, Y Up is needed. 


Apply Unit 
TODO. 


Apply Transform 
TODO. 


Geometry 


Smoothing 
TODO. 


Export Subdivision Surface 
Todo. 


Apply Modifiers 
Export objects using the evaluated mesh, meaning the 
resulting mesh after all Modifiers have been calculated. 


Loose Edges 
TODO. 


Tangent Space 
TODO. 


Armatures 


Primary/Secondary Bone Axis 
TODO. 


Armature FBXNode Type 
TODO. 


Only Deform Bones 
TODO. 


Add Leaf Bones 
TODO. 


Bake Animation 


TODO. 


Key All Bones 
TODO. 


NLA Strips 
TODO. 


All Actions 


Export all actions compatible with the selected armatures 
start/end times which are derived from the keyframe 
range of each action. When disabled only the currently 
assigned action is exported. 


Force Start/End Keying 
TODO. 


Sampling Rate 
TODO. 


Simplify 
TODO. 


Compatibility 


Import 


Note that the importer is a new addition and lacks many 
features the exporter supports. 


e binary FBX files only. 
e Version 7.1 or newer. 


Missing 
e Mesh: shape keys. 
Export 


NURBS surfaces, text3D and metaballs are converted to 
meshes at export time. 


Missing 


Some of the following features are missing because they are 
not supported by the FBX format, others may be added 
later. 


Object instancing - exported objects do not share data, 
instanced objects will each be written with their own 
data. 

Material textures 

Vertex shape keys - FBX supports them but this 
exporter does not write them yet. 

Animated fluid simulation - FBX does not support this 
kind of animation. You can however use the OB} 
exporter to write a sequence of files. 

Constraints - The result of using constraints is exported 
as a keyframe animation however the constraints 
themselves are not saved in the FBX. 

Instanced objects - At the moment instanced objects are 
only written in static scenes (when animation is 
disabled). 


Images as Planes 


Reference 


Category: 
Menu: 


Import-Export 


File » Import >» Images as Planes, 3D 


Viewport >» Add > Image > Images as 


Planes 


This add-on imports images and 
creates planes with them as textures. 
It automates the process of creating a 
plane, resizing it to fit the dimensions 
of the image, and adding a material 
and image texture to that plane. The 
name of the plane, material and 
texture is derived from the image 
name. 


You can either import a single image, 
multiple images, or an image 
sequence/movie clip. Selecting a 
single image will create one plane, 
selecting multiple images will create 
as many planes as images selected, 
on top of each other or spaced. 
Selecting a movie clip, or an image 
sequence will create a single plane 
with an animation. 


Operator Presets 

, Import Options: 
Relative Paths 
Force Reload 


Animate Image Sequences 


ia) Compositing Nodes: 


Setup Comer Pin 


© Material Settings: 


Principled Shadeless 
¥ Overwrite Material 
3 Texture Settings: 
¥ Use Alpha Straight 
¥ Auto Refresh 


®t Position: 


Offset Planes 


€ > Plane dimensions: 

Absolute Camera... Dpi 
Height 

Orientation: 


Align: Main Axis 


Dots/BU 


1m 


Track Camera 


Properties panel. 


Properties 


You save the current settings of the import as an Operator 
Preset. 


Import Options 


Relative Path 
Link to the image file using a relative file path. 


Force Reload 
Reloads the image file into Blender if it is already added 
as an image data-block. 


Animate Image Sequences 
Import sequentially numbers images as an animated 
image sequence instead of separate planes. They will be 
imported as a Clip texture on a single plane. The frame 
range will automatically be set but can be changed later. 


Compositing Nodes 


Setup Corner Pin 
A Corner Pin node is used to distort a plane and to create 
a warp view of the image. Selecting this option will build 
a compositing setup with the Image Texture, Scale and 
Corner Pin Node added to the Compositor. 


Material Settings 


The image is displayed on the plane through material and 
textures nodes. They can be edited in the Shader editor. 


Shader 


Principled 
Creates a new material for the plane with a Principled 
BSDF shader node with default settings as the main 
component. The base color of the Principled BSDF 
node comes from an Image Texture node that is linked 
to the imported image. 


Shadeless 
A shadeless material is a material that does not 
respond to light from other objects and has always the 
same color in any lighting environment. This option 
creates a new material for the plane with a group 
node as the main component. This node group is 
essentially a mix between a Diffuse and an Emission 
shader controlled by a Light Path node. 


Emit 
Creates a new material for the plane with an Emission 
shader node as the main component. The base color 
of the node comes from an Image Texture node that is 
linked to the imported image. The strength can be set. 


Override Material 
The name of the material is the same as the name of the 
image. If the material already exist Blender will append a 
number to the material name. With the Override Material 
checkbox, you can force the add-on to replace the 
existing material. 


Texture Settings 


Use Alpha 
The alpha channel of the image is used for transparency. 


Alpha Mode 


Representation of alpha in the image file, to convert to 
and from when saving and loading the image. See 
Alpha Channel. 


Auto Refresh 


Automatically refresh images in the viewport on frame 
changes. 


Position 


A single plane is positioned at the 3D Cursor. Multiple planes 
can be offset against each other following a selected axis. 


Offset Planes 
Local Axis 


The axis that is used to offset the different planes. For 
example, if you choose X+, the images are positioned 
along the X axis, starting at the X coordinate of the 3D 
cursor and following with X+ offset. 


X+, X-, Y+, Y-, Z+, Z- 
Offset 
The space between each plane. 


Plane Dimensions 


Use the image’s pixel count to determine the planes size in 
units. 


Absolute 


The size of the plane is based on the amount of pixels in 
the image. 


Height 


The width is calculated based on the input height and 
the pixel dimensions of the image. For example, with 
the default Height of 1, an image of 800 x 600 will 
have a calculated width of 1 / 600 x 800 or 1.33 units. 


Camera Relative 


The size of the image plane is set relative to the size of 
the camera frame. 


Fit 
Scales the image to fit inside the camera view without 
altering the aspect ratio. 


Fill 
Scales the image so that it fills the entire camera 


view, without altering the aspect ratio but some of the 
image can be spilled outside the camera frame. 


DPI 
Dots per Inch. 


Definition 
This is the number of pixels that fit in 1 inch. So, with 
the Unit System set to Metric and the Definition field 
set to the default 600 DPI, an image of 800 x 600 
pixels will have a size of 0.0339 x 0.0254 units 


because 600 pixels are defined as 1 inch which equals 
0.0254 m. 


Dots/BU 
Dots per Blender Unit. 


Definition 
The field Definition is by default set to 600, indicating 
that 1 unit equals 600 pixels in the image. So, an 
image of 800 x 600 will have a size of 1.33 x 1 unit. 


Orientation 


Align 
With this option you can set the rotation of the plane. 


Main Axis 
The plane is positioned so that it faces the camera. 
This is achieved by rotating the plane so that the 


viewing axis of the camera is perpendicular to the 
plane. 


Face Camera 
Face Camera is similar to Main Axis, but the plane is 


also rotated so that it aligns with the rotation of the 
camera. 


Z- (Down), Y-, X-, Z+ (Up), Y+, X+ 

The plane is rotated in such a way that the selected 
axis is perpendicular to the plane with the front face 
pointing to the positive or negative side of the axis. 
For example, the option Z+ (Up) is fully visible in Top 
View, because the Z axis is pointing perpendicular to 
the plane in this view and the front face of the image 
iS pointing to the positive (Up) side of the Z axis. 


Track Camera 


Uses a Locked Track Constraint to make the plane always 
align with the camera. The plane always faces the 
camera, even if the camera is moved. This option is only 
available if Main axis or Face Camera is selected in the 
Align panel. 


Import Palettes 


This add-on imports color palettes from Krita and 
Photoshop. 


Todo. 


Reference 


Category: Import-Export 
Menu: File » Import Palettes 


NewTek MDD 


Reference 


Category: Import-Export 


Menu: File > Import/Export >» Lightwave Point 
Cache (.mdd) 


Todo. 


Nuke Animation (chan) 


Reference 
Category: Import-Export 
Menu: File > Import/Export >» Nuke (.chan) 


The chan format is used to store camera animations, 
including location, rotation and optionally field of view. This 
add-on can import and export chan files using the active 
object’s animation. 


A chan file is an ASCII file with parameter values saved in 
columns, one column per parameter, one line per frame. 
The properties saved and read by this script are: 


frame location.x location.y location.z rotation euler.x 
rotation euler.y rotation euler.z angle y 


The file format itself is as simple as can be, but its simplicity 
is its greatest advantage. It is being used by applications 
like Nuke and Houdini, and since it is so simple to write an 
import or export script for it is both fast and easy. 


angle_y Stands for vertical field of view. It is used for 
calculation of the camera lens, and only applies to camera 
animations, while importing/exporting object animation this 
parameter is skipped. 


Usage 


The add-on gets the currently active object (works in Object 
Mode only) and saves/loads its transformations from or to a 


simple ASCII file, through the whole animation range (set 
either in the Timeline or in the render settings). All you need 
to do is to select an object and run the add-on in File > 
Import/Export >» Nuke (.chan). 


Note that Chan saves only the raw property values 
(rotation x, rotation y, rotation z, etc.), So you have to mind 
the rotation order. In other words - the rotation orders 
during export and import must be the same (both are being 
set in the File Browser while importing/exporting). 


Another thing is the camera sensor size and its influence on 
camera lens. You can set the sensor size so you can fit a real 
life cameras (default in Blender is 32 x 18), the best 
practice in this case is using horizontal fit for the camera 
(Nuke is using this as a default). While importing the camera 
from a chan file you have to remember to set the same 
sensor size as you had in Nuke (or other software that this 
camera has been exported). 


Tip 
File names 


It is a good practice to save the chan files with it’s 
rotations order and sensor size stored in a file name (i.e. 
camera_for_shot_ZXY_36x24.chan) so you don’t have to look for 
those values in old files. 


Tip 
Exporting Geometry to Other Software 


If you want to export the objects movement to other 
software via the OBJ format, you have to save it with the Z 
up, Y forward setting. After loading it to the other software 


it will be rotated 90 degrees, but when you apply the chan 
file it’ll jump into its place. 


STL 


Reference 


Category: Import-Export 
Menu: File > Import/Export > Stl (.stl) 


This format is useful if you intend to import/export the files 


for CAD software. It is also commonly used for loading into 
3D printing software. 


Warning 


Currently the script does not handle importing or exporting 
of normals and does not handle endianness, there is 
nothing in the STL specification about it. 
Importing 

Note 


The STL importer Add-on is deprecated and being replaced 
with the much faster Integrated STL Importer. 


Properties 
Transform 


Scale 


Value by which to scale the imported objects in relation 
to the world’s origin. 


Scene Unit 
Apply current scene’s unit (as defined by unit scale) to 
imported data. 


Forward / Up Axis 
Since many applications use a different axis for pointing 
upwards, these are axis conversion for these settings, 
Forward and up axes - By mapping these to different 
axes you can convert rotations between applications 
default up and forward axes. 


Blender uses Y forward, Z up (since the front view looks 
along the +Y direction). For example, it is common for 
applications to use Y as the up axis, in that case -Z 
forward, Y up is needed. 


Geometry 
Facet Normals 


Use (import) facet normals (note that this will still give 
flat shading). 


Exporting 


Properties 


ASCII 
TODO. 


Batch Mode 
TODO. 


Include 


Selection Only 
When checked, only selected objects are exported. 
Instanced objects, for example collections that are 
instanced in the scene, are considered ‘selected’ when 
their instancer is selected. 


Transform 


Scale 


Value by which to scale the exported objects in relation 
to the world’s origin. 


Scene Unit 


Apply current scene’s unit (as defined by unit scale) to 
exported data. 


Forward / Up Axis 
Since many applications use a different axis for ‘Up’, 
these are axis conversion for these settings, Forward and 
Up axes - By mapping these to different axes you can 
convert rotations between applications default up and 
forward axes. 


Blender uses Y Forward, Z Up (since the front view looks 
along the +Y direction). For example, it’s common for 
applications to use Y as the up axis, in that case -Z 
Forward, Y Up is needed. 


Geometry 
Apply Modifiers 


Export objects using the evaluated mesh, meaning the 
resulting mesh after all Modifiers have been calculated. 


Usage 


Use the operator to import ASCII or binary STL-files, you can 
select multiple files at once. For exporting you can select 
multiple objects and they will be exported as a single STL- 
file. You can select between ASCII/binary file format (binary 
is more compact). You can also choose to enable or disable 
the modifiers during the export. 


Scalable Vector Graphics 
(SVG) 


Reference 

Category: Import-Export 

Menu: File » Import » Scalable Vector Graphics 
(.svg) 

Note 


Currently the script allows only importing and is limited to 
path geometry only. 


Properties 


This add-on does not have any properties. 


Usage 


Todo. 


Stanford PLY 


Reference 

Category: Import-Export 

Menu: File » Import/Export » Stanford (.ply) 
Warning 


Only one mesh can be exported at a time. 


Properties 


Import 

The import does not have any properties. 
Export 

Include 


Selection Only 
When checked, only selected objects are exported. 
Instanced objects, for example collections that are 
instanced in the scene, are considered ‘selected’ when 
their instancer is selected. 


Transform 


Forward / Up 


Since many applications use a different axis for ‘Up’, 
these are axis conversion for these settings, Forward and 
Up axes - By mapping these to different axes you can 
convert rotations between applications default up and 
forward axes. 


Blender uses Y Forward, Z Up (since the front view looks 
along the +Y direction). For example, its common for 
applications to use Y as the up axis, in that case -Z 
Forward, Y Up is needed. 


Scale 


Value by which to scale the exported objects in relation 
to the world’s origin. 


Geometry 


Apply Modifiers 
Export objects using the evaluated mesh, meaning the 
resulting mesh after all Modifiers have been calculated. 


Normals 
Todo. 


UVs 
Todo. 


Vertex Colors 
Todo. 


Usage 


Use the operator to import ASCII or binary PLY-files, you can 
select multiple files at once. For exporting, you can choose 
to enable or disable the modifiers during the export and you 


can choose which data you want to export (UV textures, 
Color Attributes, ...). 


UV Layout 


Reference 

Category: Import-Export 

Menu: UV Editor » UV > Export UV Layout 
Usage 


Using your favorite image painting program, you could use 
an exported UV layout to create a texture. Then save your 
changes, and back in Blender, use the Image » Open to load 
it as your UV image for the mesh in Edit Mode for the 
desired (and active) UV map. 


As a way of communicating to an artist who is painting your 
UV Texture for you, Blender has a tool called UV Layout (UV 
Editor » UV > Export UV Layout) that saves an image asa 
Targa (.tga), EPS, or SvG format for the object you have 
selected. 


The image will be lines defining the UV edges that are within 
the image area of the UV mapping area. Edges outside the 
boundary, even if selected, will not be shown in the saved 
graphic. The artist will use this as a transparent layer in 
their paint program as a guide when painting your texture. 
The example below shows Blender in the background, and 
the Gimp working on the texture, using the saved layout as 
a guide. Note that targa format supports the Alpha channel, 
SO you Can paint transparent areas of the mesh. For using 
images as textures, see the page on Image Textures. 


A UV layout in the A UV layout ina 
UV Editor. paint program. 


Properties 


PNG Image (.png) 


Export options. 


All UVs 
if disabled, then only the UV faces selected will be 
outlined. 


Modified 
Export UVs from the modified mesh. 


Format 
Select the type of image file to save (.png, .eps, .svg). 


Size 
Select the size of the image in pixels. 


Fill Opacity 
Set the opacity of the fill. 


Wavefront OB] 


Reference 
Category: Import-Export 
Menu: File >» Import » Wavefront (.obj) (legacy) 


OB) format is a popular plain text format, however, it has 
only basic geometry and material support. 


Import and export of OB] files is built into Blender 3.3 and 
later without the need of an add-on. It’s documentation can 
be found here: OB] Exporter. 


Web3D X3D/VRML2 


Reference 

Category: Import-Export 

Menu: File > Import/Export » X3D Extensible 3D 
(.x3d/.wrl) 

Usage 

TODO. 

Properties 

Import 

Transform 


Forward / Up Axis 
Since many applications use a different axis for ‘Up’, 
these are axis conversions for Forward and Up axes - By 
mapping these to different axes you can convert 
rotations between applications default up and forward 
axes. 


Blender uses Y forward, Z up (since the front view looks 
along the +Y direction). For example, its common for 
applications to use Y as the up axis, in that case -Z 
forward, Y up is needed. 


Export 
Include 


Selection Only 
When checked, only selected objects are exported. 
Instanced objects, for example collections that are 
instanced in the scene, are considered ‘selected’ when 
their instancer is selected. 


Hierarchy 
TODO. 


Named Decorations 
TODO. 


H3D Extensions 
TODO. 


Transform 


Scale 
TODO. 


Forward / Up 
Since many applications use a different axis for pointing 
upwards, these are axis conversion for these settings, 
Forward and up axes - By mapping these to different 
axes you Can convert rotations between applications 
default up and forward axes. 


Blender uses Y forward, Z up (since the front view looks 
along the +Y direction). For example, it is common for 
applications to use Y as the up axis, in that case -Z 
forward, Y up is needed. 


Geometry 


Apply Modifiers 
Export objects using the evaluated mesh, meaning the 
resulting mesh after all Modifiers have been calculated. 


Triangulate 
TODO. 


Normals 
TODO. 


Compress 
TODO. 


gITF 2.0 


Reference 

Category: Import-Export 

Menu: File > Import/Export > gITF 2.0 (.glb, .gitf) 
Usage 


gITF™ (GL Transmission Format) is used for transmission 
and loading of 3D models in web and native applications. 
gITF reduces the size of 3D models and the runtime 
processing needed to unpack and render those models. This 
format is commonly used on the web, and has support in 
various 3D engines such as Unity3D, Unreal Engine 4, and 
Godot. 


This importer/exporter supports the following gITF 2.0 
features: 


e Meshes 

Materials (Principled BSDF) and Shadeless (Unlit) 
Textures 

Cameras 

Punctual lights (point, spot, and directional) 
Extensions (listed below) 

Extras (custom properties) 

Animation (keyframe, shape key, and skinning) 


Meshes 


gITF’s internal structure mimics the memory buffers 
commonly used by graphics chips when rendering in real- 
time, such that assets can be delivered to desktop, web, or 
mobile clients and be promptly displayed with minimal 
processing. As a result, quads and n-gons are automatically 
converted to triangles when exporting to gITF. Discontinuous 
UVs and flat-shaded edges may result in moderately higher 
vertex counts in gITF compared to Blender, as such vertices 
are separated for export. Likewise, curves and other non- 
mesh data are not preserved, and must be converted to 
meshes prior to export. 


Materials 


The core material system in gITF supports a metal/rough 


e Base Color 

e Metallic 

e Roughness 

e Baked Ambient Occlusion 

e Normal Map (tangent space, +Y up) 
e Emissive 


Some additional material properties or types of materials 
can be expressed using gITF extensions. The complete list 
can be found in _Extensions_ part of this documentation. 


An example of the various image maps available in 
the gITF 2.0 core format. This is the water bottle 
sample mode! shown alongside slices of its various 
image maps. 


Imported Materials 


The gITF material system is different from Blender’s own 
materials. When a gITF file is imported, the add-on will 
construct a set of Blender nodes to replicate each gITF 
material as closely as possible. 


The importer supports Metal/Rough PBR (core gITF), 
Spec/Gloss PBR (KHR materials pbrSpecularGlossiness) and 
some extension materials. The complete list can be found in 
_Extensions_ part of this documentation. 


Tip 


Examining the result of the material import process is a 
good way to see examples of the types of material nodes 
and settings that can be exported to gITF. 


Exported Materials 


The exporter supports Metal/Rough PBR (core gITF) and 
Shadeless (KHR materials unlit) materials. It will construct a 
gITF material based on the nodes it recognizes in the 
Blender material. The material export process handles the 
settings described below. 


Note 


When image textures are used by materials, gITF requires 
that images be in PNG or JPEG format. The add-on will 
automatically convert images from other formats, 
increasing export time. 


Base Color 


The gITF base color is determined by looking for a Base 
Color input on a Principled BSDF node. If the input is 
unconnected, the input’s default color (the color field next 
to the unconnected socket) is used as the Base Color for the 


gITF material. 


Principled BSDF 


GGX 
Random Walk 
Base Color 


@ Subsurface 


A solid base color can be specified directly on the 
node. 


If an Image Texture node is found to be connected to the 
Base Color input, that image will be used as the gITF base 
color. 


Principled BSDF 


Subsurface Anisotropy 
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Transmission Roughness 
Emission 


2 Emission Strength 


An image is used as the gITF base color. 
Metallic and Roughness 


These values are read from the Principled BSDF node. If 
both of these inputs are unconnected, the node will display 
Sliders to control their respective values between 0.0 and 
1.0, and these values will be copied into the gITF. 


When using an image, gITF expects the metallic values to 
be encoded in the blue (B) channel, and roughness to be 
encoded in the green (Gc) channel of the same image. If 
images are connected to the Blender node in a manner that 
does not follow this convention, the add-on may attempt to 
adapt the image to the correct form during exporting (with 
an increased export time). 


In the Blender node tree, it is recommended to use a 
Separate RGB node to separate the channels from an Image 
Texture node, and connect the green (G) channel to 
Roughness, and blue (B) to Metallic. The gITF exporter will 
recognize this arrangement as matching the gITF standard, 
and that will allow it to simply copy the image texture into 
the gITF file during export. 


The Image Texture node for this should have its Color Space 
set to Non-Color. 


© Separate Color 


A metallic/roughness image connected in a manner 
consistent with the gITF standard, allowing it to be 
used verbatim inside an exported gITF file. 


Baked Ambient Occlusion 


gITF is capable of storing a baked ambient occlusion map. 
Currently there is no arrangement of nodes that causes 
Blender to use such a map in exactly the same way as 
intended in gITF. However, if the exporter finds a custom 
node group by the name of glTF Material Output, and finds an 
input named Occlusion on that node group, it will look for an 
Image Texture attached there to use as the occlusion map in 
gITF. The effect need not be shown in Blender, as Blender 
has other ways of showing ambient occlusion, but this 
method will allow the exporter to write an occlusion image 
to the gITF. This can be useful to real-time gITF viewers, 
particularly on platforms where there may not be spare 
power for computing such things at render time. 


¥ occlusionRoughnessMetallic.png 


ionRoughnessMetallic.png ! 


A pre-baked ambient occlusion map, connected to a 
node that doesn’t render but will export to gITF. 


Tip 


The easiest way to create the custom node group is to 
import an existing gITF model that contains an occlusion 
map, such as the or another existing model. A 
manually created custom node group can also be used. 


gITF stores occlusion in the red (R) channel, allowing it to 
optionally share the same image with the roughness and 
metallic channels. 


lusionRoughnessMetallic.png 


cclusionRoughnessMetallic.png 


This combination of nodes mimics the way gITF 
packs occlusion, roughness, and metallic values into 


a single image. 
Tip 


The Cycles render engine has a Bake panel that can be 
used to bake ambient occlusion maps. The resulting image 
can be saved and connected directly to the glTF Material 
Output node. 


Normal Map 


To use a normal map in gITF, connect an Image Texture 
node’s color output to a Normal Map node’s color input, and 
then connect the Normal Map normal output to the 
Principled BSDF node’s normal input. The Image Texture 
node for this should have its Color Space property set to 
Non-Color. 


The Normal Map node must remain on its default property of 
Tangent Space as this is the only type of normal map 
currently supported by gITF. The strength of the normal map 
can be adjusted on this node. The exporter is not exporting 
these nodes directly, but will use them to locate the correct 
image and will copy the strength setting into the gITF. 


A normal map image connected such that the 
exporter will find it and copy it to the gITF file. 


Tip 


The Cycles render engine has a Bake panel that can be 
used to bake tangent-space normal maps from almost any 
other arrangement of normal vector nodes. Switch the 
Bake type to Normal. Keep the default space settings 
(space: Tangent, R: +X, G: +Y, B: +Z) when using this bake 
panel for gITF. The resulting baked image can be saved 
and plugged into to a new material using the Normal Map 
node as described above, allowing it to export correctly. 


See: Cycles Render Baking 


Emissive 


An Image Texture node can be connected to the Emission 
input on the Principled BSDF node to include an emissive 
map with the gITF material. Alternatively, the Image Texture 
node can be connected to an Emission shader node, and 
optionally combined with properties from a Principled BSDF 
node by way of an Add Shader node. 


If the emissive map is alone in the material, it is best to set 
the Base Color default to black, and the Roughness default 
to 1.0. This minimizes the influence of the other channels if 
they are not needed. 


This arrangement is supported for backwards 
compatibility. It is simpler to use the Principled BSDF 
node directly. 


If any component of emissiveFactor is > 1.0, 
KHR materials emissive strength extension will be used. 


Clearcoat 


When the Clearcoat input on the Principled BSDF node has a 
nonzero default value or Image Texture node connected, the 
KHR materials clearcoat gITF extension will be included in the 
export. This extension will also include a value or Image 
Texture from the Clearcoat Roughness input if available. 


If Image Textures are used, gITF requires that the clearcoat 
values be written to the red (R) channel, and Clearcoat 
Roughness to the green (Gc) channel. If monochrome images 
are connected, the exporter will remap them to these color 
channels. 


The Clearcoat Normal input accepts the same kinds of 
inputs as the base Normal input, specifically a tangent- 
space normal map with +Y up, and a user-defined strength. 
This input can reuse the same normal map that the base 
material is using, or can be assigned its own normal map, or 
can be left disconnected for a smooth coating. 


All Image Texture nodes used for clearcoat shading should 
have their Color Space set to Non-Color. 


>rincipled BSDF 


~ Separate Color 


RGB 


Color 


» Normal Map 


An example of a complex clearcoat application that 
will export correctly to gITF. A much simpler, smooth 


coating can be applied from just the Principled BSDF 
node alone. 


Sheen 


When the Velvet BSDF node is used in addition to Principled 
BSDF node, the KHR materials sheen gITF extension will be 
included in the export. The Sheen Color will be exported 
from Color socket of Vevlet node. Sheen Roughness will be 
exported from Sigma socket. 


If a Sheen Rougness Texture is used, gITF requires the 
values be written to the alpha (A) channel. 


Tip 


Velvet BSDF node is only available on Cycles render 
engine. You may have to temporary switch to Cycles to 
add this node, and get back to Eevee. 


Note 


Because the node tree is adding 2 Shaders (Principled and 
Sheen), the resulting shader is not fully energy 
conservative. You may find some difference between 
Blender render, and gITF render. Sheen models are not 
fully compatible between Blender and gITF. This trick about 
adding Velvet Shader is the most accurate approximation 
(better that using Sheen Principled sockets). 


Specular 


When the Specular or Specular Tint input of Principled BSDF 
node have a non default value or Image Texture node 
connected, the KHR materials specular gITF extension will be 
included in the export. 


Note 


Specular models are not fully compatible between Blender 
and gITF. By default, Blender data are converted to gITF at 
export, with a possible loss of information. Some 
conversion are also performed at import, will a possible 
loss of information too. 


At import, a custom node group is created, to store original 
Specular data, not converted. 
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At export, by default, Soecular data are converted from 
Principled BSDF node. 


You can export original Specular data, enabling the option at 
export. If enabled, Principled Specular data are ignored, only 
data from custom node are used. 
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Tip 


If you enable Shader Editor Add-ons in preferences, you 
will be able to add this custom node group from Menu: Add 
> Output > gITF Material Output 
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Preferences 


¥ Shader Editor Add-ons ¥ Material Variants 


Transmission 


When the Transmission input on the Principled BSDF node 
has a nonzero default value or Image Texture node 
connected, the KHR materials transmission gITF extension will 
be included in the export. When a texture is used, gITF 
stores the values in the red (R) channel. The Co/or Space 
should be set to Non-Color. 


Transmission is different from alpha blending, because 
transmission allows full-strength specular reflections. In 
gITF, alpha blending is intended to represent physical 
materials that are partially missing from the specified 
geometry, such as medical gauze wrap. Transmission is 
intended to represent physical materials that are solid but 
allow non-specularly-reflected light to transmit through the 
material, like glass. 


gITF does not offer a separate “Transmission Roughness”, 
but the material’s base roughness can be used to blur the 
transmission, like frosted glass. 


Tip 


Typically the alpha blend mode of a transmissive material 
should remain “Opaque”, the default setting, unless the 
material only partially covers the specified geometry. 


Note 


In real-time engines where transmission is supported, 
various technical limitations in the engine may determine 
which parts of the scene are visible through the 
transmissive surface. In particular, transmissive materials 
may not be visible behind other transmissive materials. 
These limitations affect physically-based transmission, but 
not alpha-blended non-transmissive materials. 


Note 


If you want to enable refraction on your model, 

KHR materials transmission must also be used in addtion with 
KHR materials volume. See the dedicated Volume part of the 
documentation. 


Warning 
Transmission is complex for real-time rendering engines to 


implement, and support for the KHR materials transmission 
gITF extension is not yet widespread. 


IOR 


At import, there are two different situation: 


e if KHR materials ior is not set, lIOR value of Principled 
BSDF node is set to 1.5, that is the gITF default value of 
IOR. 

e If set, the KHR materials ior is used to set the IOR value 
of Principled BSDF. 


At export, IOR is included in the export only if one of these 
extensions are also used: 


e KHR materials transmission 
e KHR_ materials volume 
e KHR materials specular 


IOR of 1.5 are not included in the export, because this is the 
default gITF IOR value. 


Volume 


Volume can be exported using a Volume Absorption node, 
linked to Volume socket of Output node. Data will be 
exported using the KHR materials volume extension. 


e For volume to be exported, some transmission must be 

set on Principled BSDF node. 

Color of Volume Absorption node is used as gITF 

attenuation color. No texture is allowed for this property. 

e Density of Volume Absorption node is used as inverse of 
gITF attenuation distance. 

e Thickess can be plugged into the Thickess socket of 
custom group node glTF Material Output. 

e If a texture is used for thickness, it must be plugged on 
(G) Green channel of the image. 
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gITF Variants 


Note 


For a full Variants experience, you have to enable UI in 
Add-on preferences 
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Description Import-Export as gITF 2.0 
Location File > Import-Export 
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Preferences 


¥ Shader Editor Add-ons ¥ Material Variants 


There are two location to manage gITF Variants in Blender 


e In 3D View, on glTF Variants tab 
e For advanced settings, in Mesh Material Properties (see 
Advanced gITF Variant checks) 


The main concept to understand for using Variants, is that 
each material slot will be used as equivalent of a gITF 
primitive. 


gITF Variants switching 


After importing a gITF file including KHR materials variants 
extension, all variants can be displayed. 
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You can switch Variant, by selecting the variant you want to 
display, then clicking on Display Variant. 


You can switch to default materials (when no Variant are 
used), by clicking on Reset to default. 


gITF Variants creation 


You can add a new Variant by clicking the + at right of the 
Variant list. Then you can change the name by double- 
clicking. 


After changing Materials in Material Slots, you can assign 
current materials to the active Variant using Assign to 
Variant. 


You can also set default materials using Assign as Original. 

These materials will be exported as default material in gITF. 
This are materials that will be displayed by any viewer that 
don’t manage KHR materials variants extension. 


Advanced gITF Variant checks 


If you want to check primitive by primitive, what are 
Variants used, you can go to Mesh Material Properties. 
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Assign To Variant 


The g/ITF Material Variants tab refers to the active material 
Slot and Material used by this slot. You can see every 
Variants that are using this material for the given 
Slot/Primitive. 


You can also assign material to Variants from this tab, but 
recommandation is to perform it from 3D View tab. 


Double-Sided / Backface Culling 


For materials where only the front faces will be visible, turn 
on Backface Culling in the Settings panel of an Eevee 


material. When using other engines (Cycles, Workbench) 
you can temporarily switch to Eevee to configure this 
setting, then switch back. 


Leave this box unchecked for double-sided materials. 
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Custom Properties 


The inverse of this setting controls gITF’s DoubleSided 
flag. 


Blend Modes 


The Base Color input can optionally supply alpha values. 
How these values are treated by gITF depends on the 
selected blend mode. 


With the Eevee render engine selected, each material has a 
Blend Mode on the material settings panel. Use this setting 
to define how alpha values from the Base Color channel are 
treated in gITF. Three settings are supported by gITF: 


Opaque 
Alpha values are ignored. 


Alpha Blend 
Lower alpha values cause blending with background 
objects. 


Alpha Clip 
Alpha values below the Clip Threshold setting will cause 
portions of the material to not be rendered at all. 
Everything else is rendered as opaque. 


With the Eevee engine selected, a material’s blend 
modes are configurable. 


Note 


Be aware that transparency (or Aloha Blend mode) is 
complex for real-time engines to render, and may behave 
in unexpected ways after export. Where possible, use 
Alpha Clip mode instead, or place Opaque polygons behind 
only a single layer of Aloha Blend polygons. 


UV Mapping 


Control over UV map selection and transformations is 
available by connecting a UV Map node and a Mapping node 
to any Image Texture node. 


Settings from the Mapping node are exported using a gITF 
extension named KHR_ texture transform. There is a mapping 
type selector across the top. Point is the recommended type 
for export. Texture and Vector are also supported. The 
supported offsets are: 


e Location - X and Y 
e Rotation - Z only 
e Scale - X and Y 


For the Texture type, Scale X and Y must be equal (uniform 
scaling). 


From Instancer 


« UVMap 


A deliberate choice of UV mapping. 
Tip 


These nodes are optional. Not all gITF readers support 
multiple UV maps or texture transforms. 


Factors 


Any Image Texture nodes may optionally be multiplied with 

a constant color or scalar. These will be written as factors in 
the gITF file, which are numbers that are multiplied with the 
specified image textures. These are not common. 


e Use Math node (multiply) for scalar factors. Use second 


value as factor 
e Use MixRGB (multiply) for color factors. Set Fac to 1, and 


use Color2 as factors 
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Example 


A single material may use all of the above at the same time, 
if desired. This figure shows a typical node structure when 
several of the above options are applied at once: 
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A Principled BSDF material with an emissive texture. 


Exporting a Shadeless (Unlit) Material 


To export an unlit material, mix in a camera ray, and avoid 
using the Principled BSDF node. 
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One of several similar node arrangements that will 


export KHR materials unlit and render shadeless in 
Blender. 


Extensions 


The core gITF 2.0 format can be extended with extra 
information, using gITF extensions. This allows the file 
format to hold details that were not considered universal at 
the time of first publication. Not all gITF readers support all 
extensions, but some are fairly common. 


Certain Blender features can only be exported to gITF via 
these extensions. The following gITF 2.0 extensions are 
Supported directly by this add-on: 


Import 


e KHR_ materials pbrSpecularGlossiness 
e KHR_ materials clearcoat 

e KHR materials transmission 

e KHR_ materials unlit 

e KHR_ materials emissive strength 
e KHR_materials volume 

e KHR materials sheen 

e KHR materials specular 

e KHR_ materials ior 

e KHR_ materials variants 

e KHR_lights_ punctual 

e KHR_ texture transform 

e KHR_mesh_ quantization 


Export 


e KHR draco mesh compression 
e KHR_lights_ punctual 

e KHR_ materials clearcoat 

e KHR materials transmission 
e KHR_ materials unlit 

e KHR materials emissive strength 
e KHR_ materials volume 

e KHR_ materials sheen 

e KHR materials specular 

e KHR_ materials ior 

e KHR_ materials variants 

e KHR_ texture transform 


Third-party gITF Extensions 


It is possible for Python developers to add Blender support 
for additional gITF extensions by writing their own third- 
party add-on, without modifying this gITF add-on. For more 
information, see the example on GitHub and if needed, 
register an extension prefix. 


Custom Properties 


Custom properties are always imported, and will be 
exported from most objects if the Include » Custom 
Properties option is selected before export. These are stored 
in the extras field on the corresponding object in the gITF 
file. 


Unlike gITF extensions, custom properties (extras) have no 
defined namespace, and may be used for any user-specific 
or application-specific purposes. 


Animation 


A gITF animation changes the transforms of objects or pose 
bones, or the values of shape keys. One animation can 
affect multiple objects, and there can be multiple 
animations in a gITF file. 


Import 
Imported models are set up so that the first animation in the 


file is playing automatically. Scrub the Timeline to see it 
play. 


When the file contains multiple animations, the rest will be 
organized using the Nonlinear Animation editor. Each 
animation becomes an action stashed to an NLA track. The 
track name is the name of the gITF animation. To make the 
animation within that track visible, click Solo (star icon) next 
to the track you want to play. 


This is the fox sample model showing its “Run” 
animation. 


If an animation affects multiple objects, it will be broken up 
into multiple parts. The part of the animation that affects 
one object becomes an action stashed on that object. Use 
the track names to tell which actions are part of the same 
animation. To play the whole animation, you need to enable 
Solo (star icon) for all its tracks. 


Note 


There is currently no way to see the non-animated pose of 
a model that had animations. 


Export 


You can export animations by creating actions. How gITF 
animations are made from actions is controlled by the 
Animation >» Group by NLA Track export option. 


Group by NLA Track on (default) 


An action will be exported if it is the active action on an 
object, or it is stashed to an NLA track (e.g. with the Stash 
or Push Down buttons in the Action Editor). Actions which 
are not associated with an object in one of these ways are 
not exported. If you have multiple actions you want to 
export, make sure they are stashed! 


A gITF animation can have a name, which is the action 
name by default. You can override it by renaming its NLA 
track from NLATrack/[Action Stash] to the name you want to 
use. For example, the Fig. fox model! will export with three 
animations, “Survey”, “Walk”, and “Run”. If you rename two 
tracks on two different objects to the same name, they will 
become part of the same gITF animation and will play 
together. 


The importer organizes actions so they will be exported 
correctly with this mode. 


Group by NLA Track off 


In this mode, the NLA organization is not used, and only one 
animation is exported using the active actions on all objects. 


Note 


For both modes, remember only certain types of animation 
are supported: 


e Object transform (location, rotation, scale) 
e Pose bones 
e Shape key values 


Animation of other properties, like physics, lights, or 
materials, will be ignored. 


Note 


In order to sample shape key animations controlled by 
drivers using bone transformations, they must be ona 
mesh object that is a direct child of the bones’ armature. 


File Format Variations 


The gITF specification identifies different ways the data can 
be stored. The importer handles all of these ways. The 
exporter will ask the user to select one of the following 
forms: 


gITF Binary (.glb) 


This produces a single .glb file with all mesh data, image 
textures, and related information packed into a single binary 
file. 


Tip 


Using a single file makes it easy to share or copy the 
model to other systems and services. 


gITF Separate (.gltf + .bin + textures) 


This produces a JSON text-based .gitf file describing the 
overall structure, along with a .bin file containing mesh and 
vector data, and optionally a number of .png or . jpg files 
containing image textures referenced by the .gitf file. 


Tip 


Having an assortment of separate files makes it much 
easier for a user to go back and edit any JSON or images 
after the export has completed. 


Note 


Be aware that sharing this format requires sharing all of 
these separate files together as a group. 


gITF Embedded (.gitf) 


This produces a JSON text-based .gitf file, with all mesh 
data and image data encoded (using Base64) within the file. 
This form is useful if the asset must be shared over a plain- 
text-only connection. 


Warning 


This is the least efficient of the available forms, and should 
only be used when required. 


Properties 


Import 


Pack Images 
Pack all images into the blend-file. 


Shading 
How normals are computed during import. 


Guess Original Bind Pose 
Determines the pose for bones (and consequently, 
Skinned meshes) in Edit Mode. When on, attempts to 
guess the pose that was used to compute the inverse 
bind matrices. 


Bone Direction 
Changes the heuristic the importer uses to decide where 
to place bone tips. Note that the Fortune setting may 
Cause inaccuracies in models that use non-uniform 
scaling. Otherwise this is purely aesthetic. 


Export 


Format 
See: File Format Variations. 


Textures 
Folder to place texture files in. Relative to the gltf-file. 


Copyright 
Legal rights and conditions for the model. 


Remember Export Settings 


Store export settings in the blend-file, so they will be 
recalled next time the file is opened. 


Include 


Selected Objects 
Export selected objects only. 


Visible Objects 
Export visible objects only. 


Renderable Objects 
Export renderable objects only. 


Active Collection 
Export objects from active collection only. 


Active Scene 
Export active scene only. 


Custom Properties 
Export custom properties as gITF extras. 


Cameras 
Export cameras. 


Punctual Lights 


Export directional, point, and spot lights. Uses the 
KHR_ lights punctual gITF extension. 


Transform 


Y Up 
Export using gITF convention, +Y up. 


Geometry 


Apply Modifiers 
Export objects using the evaluated mesh, meaning the 
resulting mesh after all Modifiers have been calculated. 


UVs 
Export UVs (texture coordinates) with meshes. 


Normals 
Export vertex normals with meshes. 


Tangents 
Export vertex tangents with meshes. 


Vertex Colors 
Export Color Attributes with meshes. 


Loose Edges 
Export loose edges as lines, using the material from the 
first material slot. 


Loose Points 
Export loose points as gITF points, using the material 
from the first material slot. 


Materials 
Export full materials, only placeholders (all primitives but 
without materials), or does not export materials. (In that 
last case, primitive are merged, lossing material slot 
information). 


Images 
Output format for images. PNG is lossless and generally 
preferred, but JPEG might be preferable for web 
applications due to the smaller file size. If None is 
chosen, materials are exported without textures. 


Compression 


Compress meshes using Google Draco. 


Compression Level 
Higher compression results in slower encoding and 
decoding. 


Quantization Position 
Higher values result in better compression rates. 


Normal 
Higher values result in better compression rates. 


Texture Coordinates 
Higher values result in better compression rates. 


Color 
Higher values result in better compression rates. 


Generic 
Higher values result in better compression rates. 


Animation 


Use Current Frame 
Export the scene in the current animation frame. For rigs, 
when off, rest pose is used as default pose for joints in 
gITF file. When on, the current frame is used as default 
pose for joints in gITF file. 


Animation 


Exports active actions and NLA tracks as gITF animations. 


Limit to Playback Range 
Clips animations to selected playback range. 


Sampling Rate 


How often to evaluate animated values (in frames). 


Always Sample Animations 
Apply sampling to all animations. 


Group by NLA Track 
Whether to export NLA strip animations. 


Optimize Animation Size 
Reduce exported file-size by removing duplicate 
keyframes. 


Export Deformation Bones Only 
Export deformation bones only. 


Shape Keys 


Export shape keys (morph targets). 


Shape Key Normals 


Export vertex normals with shape keys (morph targets). 


Shape Key Tangents 


Export vertex tangents with shape keys (morph targets). 


Skinning 


Export skinning (armature) data. 


Include All Bone Influences 


Allow more than 4 joint vertex influences. Models may 


appear incorrectly in many viewers. 


Contributing 


This importer/exporter is developed through the gITF- 
Blender-lO repository, where you can file bug reports, 
Submit feature requests, or contribute code. 


Discussion and development of the gITF 2.0 format itself 
takes place on the Khronos Group gITF GitHub repository, 
and feedback there is welcome. 


Interface 


These add-ons add custom elements and menus to the user 
interface. 


3D Viewport Pie Menus 
Amaranth Toolset 
Copy Attributes Menu 
Collection Manager 
Dynamic Brush Menus 
Dynamic Context Menu 
Modifier Tools 


3D Viewport Pie Menus 


Individual menu Activation. 13 individual menus to choose 
from. Based on Pie menus from sebastian _k, pitiwazou, 
italic, saidenka, meta-androcto. Since there are many 
hotkey changes each menu can be deactivated in the add- 
on’s preferences. 


yads..3d_pie_menus\_ init y 


Intern.. [Documentation [x] Remove 


Preferences: 


> Animation Pie: Hotkey: ‘Shift Spacebar’ 


Apply Transform Pie: Hotkey: ‘Ctrl A’ 


Edit Align Pie: Hotkey: 'Alt X' 


ys ‘Ctrl Alt S' 


Manipulator Pie: Hotkey: 'Alt Spacebar’ 


Mode Switch Pie: Hotkey: 'Ctrl Tab’ 


Sculpt Pie: Hotkey: 'W' 


Select Pie: Hotkey: ‘A’ 


1 End of Pie Menu Activations 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 


e Click Interface then 3D Viewport Pie Menus to enable 
the script. 


Description 


Animation Shift -Spacebar 
This menu allows you to change the animation Play 
Settings from the viewport. 


Apply Transforms Ctrl-A 
This menu allows you to change the mode of the 
manipulator to move, rotate, scale or combination using. 


Edit Align Alt-x 
This menu allows you to align vertices/edges/faces to 
each other in Edit Mode. 


Edit Delete x 
Extended menu for deletion of vertices/edges/faces in 
Edit Mode. 


Editor Switch ctrl-Alt-s 
Switch Editor Modes from any editor space. 


Manipulator Menu Alt-Spacebar 
Manipulator on off and combinations. 


Mode Switch ctrt-Tab 
Switch between Object Type Modes. 


Origin Ctrl-Alt-X 
This menu allows you to move the cursor and set the 
object origin or pivot. 


Save Open Ctrl-s 
Save, Open, Import files menus. 


Sculpt w 


Easy open your Brushes with this pie menu. 


Select A 


Menu of selection types. 


Shading z 


Shading viewport display. 


View Numpad Alt-Q 
Numpad View Directions. 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Interface 

Individual and optional pie menu 
activation. 

3D Viewport 

Space view3d_ pie menus folder 
meta-androcto 

meta-androcto 

GPL 

Community 

This add-on is bundled with Blender. 


Amaranth Toolset 


A collection of tools and settings to improve productivity. 


Activation 


e Open Blender and go to Edit menu, Preferences, then 
Add-ons. 
e Search for Amaranth, and activate the add-on. 


3D View 


Set Camera Bounds as Render Border 


When in camera view, we can now set the border-render to 
be the same size of the camera, so we don’t render outside 
the view. Makes faster render preview. 


Usage: Context menus (RMB) when in Camera View. 


Select Meshlights 


Select all the meshes that emit light. 


Usage: On the header of the 3D View, top of the select 
menu. 


Adjust Passepartout 


The passepartout value of local Cameras is now available 
via the context menu, while in Camera view. 


Usage: Context menus (RMB) when in Camera View. 


Scene, Cameras, and Meshlights Count 


Add the number of scenes, cameras, and light emitting 
meshes to the stats in the Status Bar. 


Disabled by default as there has been reports of very minor 
slowdown on scenes with many hi-poly objects. Never 
experienced myself but just in case. 


Usage: Once enabled in the add-on preferences, it will 
appear in the Status Bar. 


Wireframe Toggle 


Enable or disable wireframe display on mesh objects. It even 
works on linked objects/scenes too, where this option is not 
accessible. 


“Display” will enable the wireframe, while “Clear” will 
disable it. 


Both using the following settings: 


Draw All Edges 
Display edges even on coplanar faces 


Subdvision Optimal Display 
Enable/Disable the “Optimal Display” option on 
Subdvision modifiers 


Only Selected Objects 
Only apply to the selected objects, otherwise apply to all. 


All Scenes 


Display wireframe on all the objects in all scenes. Handy 
when working with linked scenes, where it’s impossible to 
access the Wireframe option from the UI. 


Render 


Ul: Final Resolution 


Display a Final Resolution label with the size in pixels of 
your render. It also displays the final size for border renders. 


Usage: Find it in the ‘Format’ panel, Render properties. 


Cycles: Set Samples Per 


A quick way to see and set the number of render samples 
on each Scene or ViewLayer. 


Usage: Find it in the Sampling panel, on Render properties. 


Object ID for Collection Instances 


Override the Pass Index for all objects in the Collection. 


In order for the Pass Index to be loaded on computers 
without Amaranth installed, it will automatically create a 
text file (called AmaranthStartup.py) and save it inside the 
.blend, this will auto-run on startup and set the Pass Index. 
Remember to have auto-run Python scripts on your 
Preferences. 


Usage: Select an Instanced Collection and set a Pass Index 
(other than zero) and press “Apply Object ID to Duplis” in 
the Relations panel in Object Properties. 


Nodes Editor 


Display Image Node in Image Editor 


A quick way to view an image assigned to an Image node. 


Usage: Double-click an Image Node in the Nodes Editor 
(Compositor or Cycles), there must be at least 1 image 
editor available. 


Node Templates: Vignette 


Add a set of nodes to create a vignette effect attached to 
the selected node. 


Vignette 
Adjust the size and position of the vignette with the 
Ellipse Mask’s X/Y and width, height values. 


Usage: Find the templates in the Compositor’s header, 
“Template” pulldown. Or hit w. 


Nodes: XYZ Sliders for Normal Node 


Tweak the Normal node more accurately by using these 
Sliders. 


Usage: Find it in the Properties panel, when selecting a 
Normal node. 


Object / Material Indices Panel 


When working with ID Masks in the Nodes Editor, it’s hard to 
follow track of which Objects/Materials have which Pass 


Index. 


This adds a panel on the sidebar when an ID Mask node is 
selected. The active object is highlighted between [square 
brackets] 


Usage: On the Nodes Editor’s sidebar, when an ID Mask 
node is selected. 


Shaders Extra Info 


Display the name and type of the current object. It works on 
Materials and Lights. 


Usage: Find it in the Node Editor’s header. 
Nodes Stats 


Display the number of selected and total nodes on the 
compositor. 


Usage: Find it in the Compositing Nodes Editor. 


Nodes Simplify Panel 


Disable/Enable certain nodes at a time. Useful to quickly 
“simplify” compositing. 


This feature is a work in progress, the main issue now is 
when switching many different kinds one after the other. 


Experimental feature. 


Usage: Find it in the Nodes Editor sidebar (N). 


Animation 


Jump N Frames 


Press Shift-Up Or Shift-Down to jump forward/backwards a 
custom number of frames. 


Useful for example when animating at 12 frames per 
second, to be able to jump every 1 second with a shortcut. 
Make sure to save the preferences so this value is stored 
and used in the future. 


Usage: Find it in Preferences, Animation section, Timeline 
panel. 


Current Frame Slider 


Currently the only way to change the current frame is to 
have a Timeline editor open, but sometimes you don’t have 
one, or you’re fullscreen. This feature adds the Current 
Frame slider to the context menu. 


Usage: Find it in the RMB (context or w in right-click select 
keymap) menu in Object mode or Pose mode, click-drag 
sideways or click in the middle to set the frame manually. 


Bone Motion Paths: Match Frame Range 
+ Clear All Paths 


Clear All Paths 
Simple operator to loop through all bones and clear their 
paths, useful when having hidden bones (otherwise you 
have to go through each one of them and clear manually) 


Match Current Frame Range 
Set the current frame range as motion path range. 


Scene 


Save & Reload File 


When working with linked libraries, very often you need to 
Save and load again to see the changes. 


Note: Since this feature is meant to speed-up the 
save/reload process, there is no prompt on save. 


Usage: Press Shift-Ctrl-w or find it at the bottom of the File 
menu 


Refresh Scene 


Refresh the current scene, useful when working with 
libraries or drivers. 


Usage: Press F5 or find it in the context menu w 
Debug 


List Missing Images 


Display a list of missing images (that is, images that can’t 
be found) Under a collapsable list. 


Display the image name and its path, if the image is coming 
from a linked .blend, display the path to it. 


Clicking on the .blend library path (Blender icon) will open 
the file in a new Blender instance. 


Usage: Find it in the Scene Debug panel, under Scene 
Properties. 


List Missing Node Links 


Operator to look for empty image nodes, or missing images 
in nodes. 


The “List Missing Node Links” button will print: * Node 
Groups that were linked but are now “Missing Datablock” * 
Image Nodes pointing to a non-existent image * Image 
Nodes that don’t have any output connected 


Additionally, it will print in the terminal a list of all the 
Materials that meet any of the missing cases above, the 
object they belong to, and their path (if they’re coming from 
a Library). 


Usage: Find it in the Scene Debug panel, on Scene 
Properties. 


List Empty Material Slots 


Having empty material slots with no material assigned to it 
is rare, but can happen. Sometimes because the material 
was linked and the link got lost. 


The “List Empty Material Slots” button will print a list of all 
the objects that have empty material slots. 


If the objects are linked, it will show a list of the libraries 
paths, click on them to open a new Blender instance with 
that library. 


Usage: Find it in the Scene Debug panel, on Scene 
Properties. 


List Cycles Material using X shader 


Where X is any shader type you want. It will display (and 
print on console) a list of all the materials containing the 
Shader you specified above. 


Good for finding out if there’s any meshlight (Emission) 
material hidden somewhere, or if there are many glossy 
Shaders making things noisy. 


Lighter’s Corner 


A list of all the lights in the scene, including meshlights 
(meshes that have a Material with Emission shader). 


From this list it is possible to adjust Ray Visibility (Camera, 
Diffuse, Glossy, Shadow) and renderability. 


Usage: Find it in the Lighter’s Corner panel, on Scene 
Properties. 


File Browser 


Go to Current Blend’s Folder 
A quick way to go to the currently open blend’s directory. 
Libraries Bookmark 


The “Libraries” panel in the File Browser displays the path to 
all the libraries linked to that .blend. That way you can 


quickly go to the folders related to the file. 


Usage: Find it in the Libraries panel in File Browser. Click on 
any path to go to that directory. 


Timeline 


Timeline Extra Info 


Display amount of frames left until Frame End, very handy 
especially when rendering an animation or OpenGL preview. 


Display current/end time in SMPTE. 


Usage: Find it in the Timeline Editor’s header. 


Modeling 


Symmetry Tools 


Two operators to help making a mesh symmetric. 


Find Asymmetric 
Selects vertices whose position doesn’t match the 
opposite side. 


Make Symmetric 
Move selected vertices to match the position of those on 
the other side. 


Usage: Search (Spacebar) for Find Asymmetric, and Make 
Symmetric operators. 


Miscellaneous 


Color Management Presets 


Save your Color Management options as presets, for easy 
re-use. 


Store most options in the Color Management panel, such as 
the look and color settings. Storing curve points is not 
Supported yet. 


Usage: Find the presets selector on the top of the Color 
Management panel under Render Properties. 


Instancing: Show Path of Libraries 


Display the library path of a linked Collection Instance. Click 
on the path to open that .blend file in a new Blender 
instance. 


Usage: Find it in the Instancing panel, when a Collection 
Instance (linked) is active. 


Sequencer: Display Image File Name 
When seeking through an image sequence, display the 


active strips’ file name for the current frame, and its 
playhead (in square brackets). 


Usage: Find it in the VSE header. 


EXR Render: Warn when Z not connected 


Display a warning label when exporting EXR, with Z Buffer 
enabled, but the Z input in the Composite node is not 


connected. 


Usage: Find it in the Output panel, Render properties. 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Interface 

A collection of tools and settings to 
improve productivity. 

Everywhere 

amaranth folder 

Pablo Vazquez (pablovazquez) 

Pablo Vazquez (pablovazquez) 

GPL 

Community 

This add-on is bundled with Blender. 


Copy Attributes Menu 


This add-on extends the Copy Objects ctri-c hotkey to 
include many extra copy types. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Interface then Copy Attributes Menu to enable the 
Script. 


Description 


Object Mode 


Select more than one object, press ctri-c to copy attributes 
from active to selected, you’ll see the following menu: 


Each item on the menu will copy some attributes from the 
active (last selected object) to all the other se/ected items: 


Copy Location 
Copies the object location in world coordinates. 


Copy Rotation 
Copies the object rotation in world coordinates. 


Copy Scale 
Copies the object scale in world coordinates. 


Copy Draw Options 


Copies display options: for instance wireframe, empty 
display shape, empty display size, etc. 


Copy Instancing 
Copies the objects instancing group/vertex/face settings. 


Copy Object Color 
(Self-explanatory) 


Copy Protected Transform 
Duplicates the transform locks. 


Copy Object Constraints 
Currently deletes all constraints on the selected objects 
and replaces them with the constraints on the active 
object. 


Copy Pass Index 
(Self-explanatory) 


Copy Modifiers 
Currently behaves like constraints, all you original 
modifiers will be replaced by the ones on the active item. 


Copy Vertex Weights 
(Self-explanatory) 


Collection Links 
Copy selected into active object’s collection. 


Copy Selected Constraints 
Copy all the selected constraints from the active object 
to the selected objects. 


Copy Selected Modifiers 
Copy all the selected modifiers from the active object to 
the selected objects. 


Copy Selected Custom Properties 
Copy all the selected custom properties from the active 
object to the selected objects. 


Mesh Edit Mode 


With a mesh object selected, enter Edit Mode and press 
Ctri-c to copy texture face attributes. The following menu 
appears: 


Some of the items may not appear, depending on the 
number of UV textures or Color Attributes on the mesh. 


The first group of options copies attributes from the active 
face to all other selected faces in the same UV texture or 
Color Attribute. 


Copy Material 
Copy material index to selected faces. 


Copy Image 
Copy image assignment to selected faces. 


Copy UV Coordinates 
Copy UV coordinates to selected faces. 


Copy Vertex Colors 
Copy Color Attributes to selected faces. 


The second group of options copies attributes to selected 
faces in the active UV texture or Color Attribute from their 
corresponding faces in a different UV texture or Color 
Attribute. 


Copy UV Coordinates from Layer 


Copy UV coordinates from another layer for selected 
faces. 


Vertex Colors from Layer 
Copy Color Attributes from another layer for selected 
faces. 


Pose Mode 


Select more than one bone, press Ctri-c to copy attributes 
from active (last selected bone) to all other se/ected bones. 
The following menu appears: 


Copy Local Location 
Copies the location coordinate (as seen in the transform 
panel) to the selected bones. 


Copy Local Rotation 
Copies the rotation coordinate (as seen in the transform 
panel) to the selected bones. 


Copy Local Scale 
Copies the scale coordinate (as seen in the transform 
panel) to the selected bones. 


Copy Visual Location 
Copies the actual location of the bone (as seen in the 
screen) to the selected bones. 


Copy Visual Rotation 
Copies the actual rotation of the bone (as seen in the 
screen) to the selected bones. 


Copy Visual Scale 
Copies the actual size of the bone (as seen in the screen) 
to the selected bones. 


Copy Bone Shape 
(Self-explanatory) 


Copy Protected Transform 
(Self-explanatory) 


Copy Pose Constraints 
(Self-explanatory) 


Copy IK Limits 
(Self-explanatory) 


Copy Pose 
Is what was originally mapped to ctri-c before installing 
the add-on. 


Distinction between Local and Visual 


Local transformation of bones is relative the each bone’s 
own rest position; if they do not match in Edit Mode, they 
will not match in Pose Mode, even though the numbers 
appear the same in the bone’s transformation panel. They 
also do not take into account constraints, or parenting. 


Visual transformation of bones copies the visual transform 
(on screen) of the active bone to the selected bones, 
regardless of parenting or constraints. The result should look 
exactly the same even if the bone’s numbers do not match. 
Constraints on the selected bones may prevent this from 
working (or drivers for that matter): 


Reference 


Category: Interface 
Description: Copy Attributes Menu. 
Location: 3D Viewport ctri-c 


File: 
Author: 


Maintainer: 
License: 
Support Level: 
Note: 


Space view3d_ copy _attributes.py 
Bassam Kurdali, Fabian Fricke, Adam 
Wiseman 

to do 

GPL 

Community 

This add-on is bundled with Blender. 


Collection Manager 


This add-on adds new functionality for the management of 
collections via a pop-up and a QCD (Quick Content Display) 
system in the 3D Viewport. It also offers simple display and 
modification of the relationship of objects with collections. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Interface then Collection Manager to enable the 
Script. 


Description 


Pop-up 


Use m to call up the main Collection Manager pop-up in the 
3D Viewport when in Object Mode. It can also be found in 
the Object > Collection menu. 


View Layer 
Render 
Enable/disable rendering of this view layer with this 
checkbox. 


View Layer 
Data-Block Menu of the current view layer. 


Expand All Items 
Toggle all collections expanded or collapsed. Only 
enabled when you have subcollections. 


Renumber QCD Slots 
Shown only if QCD is enabled in the preferences. 


e LMB - Renumber the QCD slots from the root slot (the 
slot designated 1) down to the bottom, for each 
depth level (breadth first search). 

e Alt-LMB - Renumber from the first top-level collection 
in a breadth first search pattern. 

e Ctrl-LMB - Switch the renumber pattern to linear. This 

pattern will renumber straight down the list 

regardless of hierarchy. 

Shift-LMB - Constrain renumbering to the branch 

under the root slot. 


Hint 
All options can be combined with each other. 


Undo 
Undoes the previous action. 


Note 
Clears any in progress copy or swap actions. 


Redo 
Redoes the previously undone action. 


Specials 
Remove Empty Collections 
Remove all collections that have no subcollections or 
objects. 


Purge All Collections Without Objects 
Remove all collections that have no objects regardless 
of whether they have subcollections. 


Select All Cumulative Objects 
Select all objects that are in more than one collection. 


Display Options (funnel icon) 
Choose which restriction toggles are shown in the 
interface and whether the restriction toggles are aligned 
to the right in the tree view. 


Scene Collection 
Set Active Collection 
Sets the active collection to the Scene Collection. 


Name 
This is static and can’t be edited. 


Select All Objects in the Collection (multiple icons) 
e LMB - Select all objects in the collection (deselects 


all other objects). 
e Shift-LMB - Add/Remove all objects in the collection 


to/from the selection. 


Ctrl-LMB - Select all objects in the collection and all 
of its subcollections (deselects all other objects). 
Shift-Ctrl-LMB - Add/Remove all objects in the 
collection and all its subcollections to/from the 
selection. 


Icons and button highlights are used to show the 
selection state: 


no icon - No objects are present in this collection 
to be selected. 

no highlight - No objects are selected in this 
collection. 

Diamond outline - Objects are present in the 
collection. 

highlight - One or more objects are selected in this 
collection. 

Filled diamond - All objects are selected in this 
collection. 

small dot and grayed out - No objects can be 
selected in this collection (the collection is hidden 
or marked as not selectable or all objects are 
marked as not selectable, etc.). Note: The button 
isn’t disabled to allow selecting subcollections; 
however, if you LMB click on it it will deselect all 
objects. 


Hint 

If you try to select all the objects in the collection but 
the diamond doesn’t fill, that means you have one or 
more unselectable objects in the collection. 


Send Objects to Collection (multiple icons) 


LMB - Move selected object(s) to collection. 


e Shift-LMB - Add/Remove selected object(s) to/from 


collection. 


Icons are used to show the object/selection state: 


Import - No objects are present in this collection. 
Box outline - Objects are present, but none are 
selected in this collection. 

3 boxes with dashed outline - The collection 
contains objects that are selected, but does not 
contain the active object in the selection. 

Filled box - The collection contains the active 
object in the selection. 


Note 


The active object must also be selected to be 
indicated/moved. 


If no objects are selected the button is disabled. 


Global Restrictions (checkbox, cursor, eye, screen, 
camera, holdout, indirect only icons) 
See the Outliner page for information about 
Restrictions. 


LMB - Enable the restriction for all collections. Click 
again to restore the previous state. 
Shift-LMB - Invert the restriction state on all 


collections. 

Shift-Ctrt-LMB - Isolate collections with selected 
objects. 

Shift-Alt-LMB - Disable collections with selected 
objects. 


Ctrl-LMB - Copy/paste the restriction state on all 
collections. Click on an RTO to copy the restriction 
state, then click on another RTO to paste it. 
Ctrl-Alt-LMB - Swap the restriction state on all 
collections with that of another restriction. Click 


on an RTO to copy the restriction state, then click 
on another RTO to swap the two. 

e Alt-LMB - Discard the previous state, and anything 
that has been stored for Copy/Paste or Swap. 


Tree View 
Shows the collections within the current selected scene. 


Disclosure (Small triangle icon) 

e LMB - Expand/collapse subcollections. 

e Shift-LMB - Isolate the tree. Collapses everything 
but the current item, and it’s 
parents/descendants. Click again to restore the 
previous state. 

e Ctrl-LMB - Expand/collapse subcollections and their 
descendants. 


Set Active Collection 
Click to set the active collection to this collection. 


QCD Slot 
Set which QCD slot the collection corresponds to. 
(Shown only if QCD is enabled in the preferences.) 


Name 
Double LmB-click to rename the collection. 


Select All Objects in the Collection (multiple icons) 

e LMB - Select all objects in the collection (deselects 
all other objects). 

e Shift-LMB - Add/Remove all objects in the collection 
to/from the selection. 

e Ctrl-LMB - Select all objects in the collection and all 
of its subcollections (deselects all other objects). 

e Shift-Ctrl-LMB - Add/Remove all objects in the 
collection and all its subcollections to/from the 


selection. 


Note 
See the section in the Scene Collection for more 
details. 


Send Objects to Collection (multiple icons) 
e LMB - Move selected object(s) to collection. 
e Shift-LMB - Add/Remove selected object(s) to/from 
collection. 


Note 
See the section in the Scene Collection for more 
details. 


Local Restrictions (checkbox, cursor, eye, screen, 
camera, holdout, indirect only icons) 

e LMB - Toggle the collection’s restriction on/off. 

e Shift-LMB - Isolate the collection’s restriction, 
preserving parents if need be. Click again to 
restore the previous state. 

e Shift-Ctrl-LMB - Isolate the collection and it’s 
descendants’ restrictions, preserving parents if 
need be. Click again to restore the previous state. 

e Ctrl-LMB - Toggle the restrictions of the collection 
and it’s descendants on/off. 

e Alt-LMB - Discard the previous state. 


Remove X 
Remove the collection. 


Filtering 
By Name 
A text field to filter collections by name. 


Invert <-> 
Invert filtering (inverts the collections shown in the 
tree view so that what is shown is hidden and what 
was hidden is shown). 


By Selected (3 boxes with dashed outline icon) 
Filter collections by selected objects (show only 
collections that contain the selected objects). 


By QCD Slots (Q key icon) 
Filter collections by those designated as QCD slots 
(show only collections that correspond to a QCD 
slot). Shown only if QCD is enabled in the 
preferences. 


Hint 
All options can be combined with each other. 


Add Collection, Add Subcollection 
Self-explanatory. 


Note 


If the tree view is filtered when adding collections, new 
collections that do not fit the filter rules will be 
displayed until the filtering changes. 


Phantom Mode 


All visibility changes made in this mode will be discarded 
when it’s disabled. 


Enabling Phantom Mode saves the current state of the 
restrictions and allows you to edit them without fear of 
losing their current state. When finished, disabling 
Phantom Mode will restore the saved state. 


Note: You will be unable to edit anything other than the 
restrictions while in Phantom Mode. 


Apply Phantom Mode (check mark icon) 


Applies all changes made to RTOs while in Phantom Mode 
and exits the mode. 


QCD 


The Quick Content Display system provides a way to rapidly 
interact with collections by allowing you to designate up to 
20 collections as QCD slots. You can then interact with these 
slots by using hotkeys or the widget to view or move objects 
to them. 


3D Viewport Header Widget 


The header widget is composed of the Quick View Toggles 
button and 20 QCD slots. 


Quick View Toggles (eye icon) 
e Create All QCD Slots. (Creates any missing QCD slots 
So you end up with a full 20) 
e Enable All QCD Slots. 
e Enable All QCD Slots Isolated. (Enables all QCD slots 
and disables any non QCD slots) 
Isolate Selected Objects Collections. 
Disable Selected Objects Collections. 
Disable All Non QCD Slots. 
Disable All Collections. 
Select All QCD Objects. (Select all objects that belong 
to enabled QCD slots) 
e Discard QCD History. (Discards previous QCD slot 
states) 


Hotkeys: 


LMB - Enable All QCD Slots. 


e Alt-LMB - Select All QCD Objects. 


LMB hold down - Opens a menu with all Quick View 


Toggles. 


QCD Slots 
20 buttons in two rows in groups of five where the first 
row starts with slot 1 and the second with slot 11. 


The state of each slot is shown with a combination of the 
following indicators: 


x - Unassigned slot. 

non-highlighted - non-visible slot. 

highlighted - visible slot. 

no icon - no objects in the slot. 

horizontal line icon - objects are present in this slot. 
circle icon - one or more objects in this slot are 
selected. 

dot icon - the active object is in this slot. 


Assigned Slot Hotkeys: 


LMB - View single slot excluding all others. 

Shift-LMB - Add/remove slot to/from view. 

Ctrl-LMB - Move selected objects to slot. 
Shift-Ctrl-LMB - Add/remove selected objects to/from 
Slot. 

Alt-LMB - Replace selection with objects in this slot. 
Shift-Alt-LMB - Add/remove slot objects to/from the 
selection. 


Unassigned Slot Hotkeys: 


LMB - Create the slot. 


e Shift-LMB - Create the slot and isolate it, excluding all 


others from view. 


e Ctrl-LMB - Create the slot and move the selected 
objects to it. 

e Shift-Ctrl-LMB - Create the slot and add the selected 
objects to it. 


Note 


The slot number and its associated collection name, as 
well as all the relevant hotkeys, are shown in the tooltip 
when hovering over the slot. 


Move Widget 


Use v to call up the Move widget in the 3D Viewport when in 
Object Mode. It can also be found in the Object -> Collection 
menu. 


The Move Widget shares its layout and indicators with the 
3D Viewport header widget. 


Hotkeys 


LMB - Move selected objects to slot. 

Shift-LMB - Add/remove selected objects to/from slot. 

0 - 9 - Move selected objects to slot 1-10 (0 is slot 10). 

Alt-0 - Alt-9 - Move selected objects to slot 11-20 (0 is 

Slot 20). 

e Shift-0 - Shift-9 - Add/remove selected objects to/from 
Slot 1-10 (0 is slot 10). 

e Shift-Alt-0 - Shift-Alt-9 - Add/remove selected objects 

to/from slot 11-20 (0 is slot 20). 


3D Viewport Hotkeys 


Object Mode 


QCD 


@ - 9 - View slot 1-10 (0 is slot 10). Excludes all 
others. 

Alt-0 - Alt-9 - View slot 11-20 (0 is slot 20). Excludes 
all others. 

Shift-0 - Shift-9 - Add/remove slot 1-10 (0 is slot 10) 
to/from view. 

Shift-Alt-0 - Shift-Alt-9 - Add/remove slot 11-20 (0 is 
slot 20) to/from view. 

Shift-= —- Enable All QCD Slots. 

= - Isolate Selected Objects Collections. 

Minus - Disable Selected Objects Collections. 
Shift-Alt-= - Disable All Non QCD Slots. 

Ctrl-Alt-= - Disable All Collections. 

Shift-Ctrl-= - Select All QCD Objects. 

Alt-= - Discard QCD History. 


Disable Objects (only available if enabled in the 
preferences.) 


H - Disable Selected. 
Shift-H - Disable Unselected. 
Alt-H - Restore Disabled Objects. 


Edit Mode 


All Object Mode hotkeys except for Select All QCD Objects 
and the Disable Objects hotkeys. (Only available if enabled 
in the preferences.) 


e AccentGrave - Mesh Select Mode menu. 


Note 


Slots with objects not in Object Mode can not be excluded. 


Preferences 


Disable objects instead of hiding 
Replaces the object hiding hotkeys with hotkeys to 
disable objects instead and adds these options to the 
Object » Show/Hide menu. 


Disabling objects prevents them from being shown again 
when a collection’s exclude checkbox is toggled off and 
on, and so will preserve the object’s visibility when 
switching QCD slots. 


QCD 
Enable the QCD system. 


QCD Hotkeys 
Enable 3D Viewport hotkeys in Object Mode. 


QCD Edit Mode Hotkeys 
Enable 3D Viewport hotkeys in Edit Mode. 


QCD 3D Viewport Header Widget 
Enable the widget containing the QVT menu and a 
graphical representation of the 20 QCD slots in the right- 
hand corner of the 3D Viewport header. 


Note 


Create All QCD Slots and Enable All QCD Slots Isolated 
(from the QVT menu) currently don’t have hotkeys and 
are only available through this widget. 


QCD Move Widget: 
Tool Theme Overrides 


Enable overrides in this section to change the color of 
individual elements in the QCD Move Widget (colors 
default to the current theme). 


Icon Alpha 
Opacity of the icons for selected (but not active) 
objects and unselected objects. 


Note 


The values for icon alpha are not overrides and 
always affect the QCD Move Widget. 


Known Issues 


e Linked collections are not supported. 

e Two QCD slots can swap collections if the collections are 
under the same parent and you rename one collection 
with the name of the other, then undo the rename and 
redo the rename. 


Glossary 
General 
Chaining: Dependent on parents for whether an 
RTO can be active. 
QCD: Quick Content Display. 
QVT: Quick View Toggles. 
RTO: Restriction Toggle Option. 


RTO Short Forms 


EC: 


SS: 


VV: 


DV: 


RR: 


HH: 


Reference 


Category: 
Description: 
Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Exclude Checkbox. (Excludes the 
collection from the current view layer - 
affects both 3D Viewport and render - 
non-chaining.) 

Selectability. (Disables selection for the 
collection in all view layers - affects 3D 
Viewport - chaining.) 

Visibility. (Hides the collection from the 
current view layer - affects 3D 
Viewport - chaining.) 

Disable Viewports. (Disables the 
collection in all view layers - affects 3D 
Viewport - chaining.) 

Renderability. (Disables the collection 
from being rendered in all view layers - 
affects render - chaining.) 

Holdout. (Masks out the collection from 
the view layer - affects render - non- 
chaining.) 

Indirect Only. (Makes the collection only 
contribute indirectly 
(shadows/reflections) to the render for 
the current view layer - affects render - 
non-chaining - Cycles only.) 


Interface 

Collection management system. 

3D Viewport 

object_collection manager folder 
Imaginer (Ryan Inch) 

Imaginer 

GPL 

Community 

This add-on is bundled with Blender. 


Dynamic Brush Menus 


Provides access to commonly used settings and tools for 
painting/sculpting. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Interface then Dynamic Brush Menus to enable the 
Script. 


Description 


Features of Note: 


e Pop-ups to pick colors and edit curves. 

e A brush menu that supports user created brushes. 
Sliders included at the top of submenus like Radius, 
Strength, and Weight to allow for precise adjustment. 
Fast creation of UV maps and Texture Paint Slots in 
Texture Paint Mode if they are not already present. 
Integrates well with the Dynamic Context Menu add-on. 


A Preference for the number of columns shown in the Brush 
and Brush Mode menus can be found for this add-on by 
going to the Add-ons tab in Preferences and expanding the 
add-on. 


Darken 


Multiply 


2 Search Color Burn 
s¥ Tools 


Linear Burn 


Quick Favorites Lighten 


Interactive Mode 

7 Screen 
Color Color Dodge 
Brush Add 


Radius Overlay 


Texture Options 
Stroke Options 
Curve 


Symmetry Options 


Reference 


Category: Interface 


Description: Fast access to brushes & tools in Sculpt 


and Paint Modes. 


Location: Spacebar in Sculpt/Paint Modes 
File: Space _view3d_brush_ menus folder 
Author: Ryan Inch (Imaginer) 

Maintainer: Ryan Inch (Imaginer) 

License: GPL 


Support Level: Community 


Note: This add-on is bundled with Blender. 


Vivid Light 
Linear Light 
Pin Light 
Difference 
Exclusion 
Subtract 
Hue 
Saturation 
Color 

Value 

Erase Alpha 
Add Alpha 


Dynamic Context Menu 


Dynamic Context Menu provides access 


to many of the menus found in the 3D DSR 
Viewport’s header. It also packs a few LY Tools 
features of its own, such as the Cursor P Animation 
menu. Access Menu Search, Tools, eS eae 
Animation, Quick Favorites, Modifiers, OS cere ae 
Collections and more. It is context i? view 
sensitive for the 3D Viewport’s modes Me Re 

and object sensitive based on object ines 


selected in Edit Mode. This add-on pairs 
well with the Dynamic Brush Menus. 


‘Object 


1 Collections 


& Add Modifier 


X Delete Object 


<> Undo/Redo 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Interface then Dynamic Context Menu to enable 
the script. 


Note 


If you are have trouble accessing the add-on in the 
interface: You may need to set the Preferences » Keymaps 
>» Spacebar Action to Tools and save your preferences. 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Interface 

Object and mode context sensitive pop- 
up menu. 

3D Viewport Spacebar 

Space view3d_ spacebar menu folder 
meta-androcto 

meta-androcto 

GPL 

Community 

This add-on is bundled with Blender. 


Modifier Tools 


A small collection of utilities for managing modifiers. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Interface then Modifier Tools to enable the script. 


Description 


Apply All 
Applies all modifiers on all selected objects in 3D 
Viewport. This option is also available in the Apply menu. 


Delete All 
Removes all modifiers on all selected objects in 3D 
Viewport. 


Viewport Visibility 
Toggles viewport visibility on/off of modifiers for all 
selected objects in the 3D Viewport. Some modifiers will 
be skipped as they don’t have their visibility exposed in 
the interface (for example the Collision modifier). In that 
case, a message will be added with the modifier’s name. 


Toggle Stack 
Expands/collapses the stack of modifiers on the active 
object. While in collapsed state, only the header of a 
panel is shown. 


Usage 


When enabled and the object has modifiers the additional 
helpers appear above the modifier stack. 


Known Limitations 


e To access the options, the active object has to have 


modifiers. 


e Sometimes applying modifiers can fail for some objects. 
For instance, if the modifier is disabled (i.e. Boolean 
Modifier that doesn’t have the Object field defined - 
Mesh used for Boolean operation or objects that share 


linked data). 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Interface 

Modifiers specials show/hide/apply 
selected. 

Properties » Modifiers 

Space view3d_ modifier tools folder 
meta-androcto, saidenka 
meta-androcto 

GPL 

Community 

This add-on is bundled with Blender. 


Lighting 
These add-ons relate to lighting and lighting sets. 
e Dynamic Sky 


e Tri-Lighting 
e Sun Position 


Dynamic Sky 


Dynamic Sky is an add-on to create a procedural sun and 
sky with lots of additional options to tweak. With this single 
add-on you can create interior, exterior or any type of 
natural lighting with just a few clicks. 


The Authors documentation can be found on the author's 
site. 


Activation 


e Open Blender and go to Preferences then the Add-ons 


tab. 
e Click Lighting then Dynamic Sky to enable the script. 


Interface 


Located in the 3D Viewport > ¥ Dynamic sky 
Sidebar » Create tab. mn 


fe) Create 
World: Dynamic 1 


Scene Control 


View 


Brightness 1.000 
Shadow colorsaturatio 1.000 


Sky Control 
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Cloud color 


Cloud opacity 1.000 
Cloud density 0.267 


Sun Control 


Sun value 1.000 


Soft hard 1.000 


Instructions 


1. In the 3D Viewport >» Sidebar >» Create tab press the 
Create button to run the script. 

2. Open the Properties >» World tab and choose Dynamic _1 in 
the World data-block menu. 

3. Back in the Sidebar panel you will have new settings to 
adjust your sky. You can also adjust the world settings in 
the Shader editor. 


Reference 


Category: Lighting 


Description: 
Location: 

File: 

Author: 
Maintainer: 
License: 
Support Level: 
Note: 


Creates a Dynamic Sky for Cycles/Eevee. 
3D Viewport > Sidebar >» Create tab 
lighting _dynamic_sky.py 

Pratik Solanki 

Pratik Solanki 

GPL 

Community 

This add-on is bundled with Blender. 


Tri-Lighting 


This add-on creates a simple three point studio style lighting 
set up. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Lighting then Tri-Lighting to enable the script. 


Interface 


Located in the 3D Viewport » 
Add >» Light menu. 


Height 
Distance 


Base Energy 


Contrast 


Left Angle 
Right Angle 


Back Angle 


Usage 


1. Select the object to point the lights at. 


2. Add the lights with 3D Viewport >» Add >» Light menu » 3 
Point Lights. 

3. Adjust settings in the Tri-Lighting Creator Adjust Last 
Operation panel. 

4. The created lights are pointed at and locked to the 
active object using a Track To constraint. 

5. In the Properties >» Light tab you can further edit the 
properties of your lights. 


Reference 


Category: Lighting 
Description: Add three point lighting to the selected 
or active object. 


Location: 3D Viewport > Add >» Lights 
File: lighting _tri_lights.py 
Author: Daniel Schalla 
Maintainer: meta-androcto 

License: GPL 


Support Level: Community 
Note: This add-on is bundled with Blender. 


Sun Position 


Sun Position allows positioning and animating the Sun (to a 
certain degree of accuracy), to simulate real-world natural 
lighting. It uses physical characteristics to position the Sun 
in the scene: geographic location, time and date. It is based 
on the Earth System Research Laboratory’s online 
calculator. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Lighting then Sun Position to enable the script. 


Interface 


Located in the Properties » World >» Sun Position panel. 


Usage 


This add-on has two distinct modes of operation: the Normal 
Mode allows you to animate the Sun realistically, while the 
Sun + HDRI Texture Mode is useful for synchronizing a sun 
light to an HDRI texture. 


The usage mode can be selected from the top of the Sun 
Position panel. 


Normal Mode 


This is the mode by default. After selecting the time and 
place, you can set up a sun light, a sky texture, anda 
collection to serve as visualization. 


Use Object 


Select the sun object which will be placed according to the 
chosen time and place. Its position will be updated every 
time you change the location or time, and you can thus 
create animations by setting keyframes on them. 


Use Collection 


Select a collection of objects to be placed around the scene 
for visualization. Two options are available: analemma and 
diurnal. 


Note 


It is recommended to create a collection in the scene, and 
to move the objects into this collection. If you wish to 
create several visualizations, create as many collections as 
needed, select them in turn and choose the right settings. 
Once deselected, a collection will stay in place. 


Analemma 


The analemma is a visualization of the position of the Sun in 
the sky around the year for a given time of the day. In other 
words, it is like a time lapse picture of the sky over a year, 
with the Sun appearing multiple times at the same time of 
the day. 


The analemma was used here to match 


Diurnal 


This option allows you to visualize the trajectory of the Sun 
in the sky during a single day. 


Sky Texture 


Select a Sky Texture node in the World shading node tree. It 
will be set up to match the sun animation. This is useful if 
you want to have a simple sky texture matching a sun 
light’s position. 


Location 


In order for the Sun to be placed correctly, you need to 
choose a place on Earth where the scene is located. This 
place is represented by two coordinates, Longitude (East / 
West) and Latitude (North / South). They are expressed in 
degrees, from -180° to +180° for the longitude, and from 
-90° to 90° for the latitude. The coordinates match those 
found on such databases as OpenStreetMap or Google 
Maps. You may enter and animate them manually, or paste 
them in. 


Entering Coordinates 


In the Location panel, enter Latitude and Longitude 
coordinates corresponding to the location you wish to 
simulate. A simpler way is to go to an online map such as 
OpenStreetMap, copy the coordinates from there, and paste 
them into the Enter Coordinates field. They will be parsed 
automatically. 


Another source is Wikipedia. Suppose you want to render 
the Barcelona Pavilion by Mies van der Rohe. You can copy 
the coordinates from the article and paste them into 
Blender. 


Using coordinates from Wikipedia. 


r Scene © World 


Barcelona Pavilion 
Pabellon Aleman (in Spanish) 
Pavellé Alemany (in Catalan) 
ae 


¥ Sun Position 


Usage mode 


Normal Sun + HDR texture 
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Alternative names German Pavilion 


General information 


Type Exhibition building An d p a ste th em j n to 
Architectural style Modernism, 

os Minimalism Blender to have 
Location ni Catalonia, th e aa) p a rsed : 


Coordinates = 41°22'14"Ni 
hk 


Construction started 1928 
Completed 1929 


Copy the 
coordinates from 
Wikipedia. 


North Offset 


By default, the North points to the Y axis in the scene (to 
the top of the screen in top view). But sometimes, you may 
have modeled it in another orientation. In that case, you 
may enter a North Offset, to change the orientation of the 
scene. Show North toggles a dashed line pointing to the 
North in the 3D Viewport, to help you visualize the cardinal 
directions. 


Setting the Time 


After selecting the location on Earth, select or animate the 
date and time. This is fairly straightforward, but care must 
be taken to match the Time zone and Daylight Saving to the 
moment you wish to simulate. Time entered is the local 
time, but the global, UTC time may be displayed below as 
well. 


Note 


Time is stored in decimal format instead of 
hour:minute:second. IO Match a time in that format, look at 
the label Local. 


Sun + HDRI Texture Mode 


Instead of simulating the position of the Sun for a real 
location and time, this mode simply locks an environment 
texture with a sun light object. It is useful if you want to 
increase the contrast in a texture, by using an additional 
sun. 


Synchronizing the Sun Object to the HDRI Texture 


Start by selecting the sun object and Environment Texture 
node. You can then synchronize them by enabling Sync Sun 
to Texture. Hovering any 3D Viewport will display the 
environment texture. Use the mms to pan, scroll wheel to 
zoom, and Ctrl-MMB to set the exposure. Zoom and click the 
center of the sun in the texture. After that, the sun object 
will be locked to it. 


You can now rotate both the texture and the light by using 
the Rotation slider. 


¥ Sun Position 


Usage mode: 
Normal Sun + HDR tex.. 


te 
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Environment texture: 


f"> Environment Texture 


a 

Sun object 
@ Sun 

Distance 

Elevation 

Rotation 126° 
@ Bind Texture to Sun 
xt Sync Sun to Texture 


>» Viewport Display 


>» Custom Properties 


Click the sun in the environment texture in the 3D 
Viewport to lock it to the sun light object. 


Preferences 


The preferences for the add-on make some features 
optional, so you can hide those you don’t use. 


Reference 


Category: Lighting 

Description: Show Sun position with objects and/or 
sky texture. 

Location: Properties » World > Sun Position panel 

File: sun_position folder 


Author: Michael Martin (xaire) 

Maintainer: Damien Picard (pioverfour) 
License: GPL 

Support Level: Community 

Note: This add-on is bundled with Blender. 


Materials 


These add-ons relate to materials libraries and materials 
helpers. 


e Material Library 
e Material Utilities 


Material Library 


Materials Library VX is a Blender add-on that will create a 
material library. You can save, load and categorize materials 
that can be shared across all your projects. This version 
uses a blend-file as database so all external render engines, 
all node materials and textures are supported. It also makes 
use of Blender compression. 


See also 


Please see author’s site for the older original docs. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Material then Material Library VX to enable the 
Script. 


Add-ons Preferences 
Once the add-on is enabled you can open the 
preferences and choose to set a path to use your own 
materials in the library. 


Interface 


Located in the Properties >» Materials » Material Library VX. 


- 


- 
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¥ Material Library VX 


‘Cube © 


@ Material 


Surface 
Volume 


Settings 


Cycles Materials 


1970 tiles 
Anodized 

Ant Snowy 
Apple Juice 
Basic Glass 


Blaster Bolt (Red) 


New Library 
Add To Library 
Apply To Selected 


Reload Material 


~ Preview Material 


Remove Preview 


Remove Material 


e 


Settings 
Ct) 
Category Tools 
All 


VY Filter 


— Remove 


te Set Type + New 


Instructions 


It’s advisable to add a Fake User to your materials and to 
save your blend-file before use. 


New Library + 
Create a new Library and name it. The new library will 
have one material to start. 


Add to Library + 


Add your materials to the library. 


Apply to Selected (material icon) 
Select a material in the list and apply it to the active 
object. 


Reload Material (circular arrows icon) 
Restore the saved version of the material if you want to 
revert edits. 


Preview Material (palette icon) 
Display the material in the materials Preview panel 
before adding it to the object. 


Remove Preview (ghost icon) 
Restore the Preview panel. 


Remove Material - 
Delete the active material from the Matlib VX list and 
your library. 


Settings (wrench icon) 
Extend the interface for some extra options. 


Search 
Search the library for a material. 


Category Tools: 
Here you can make sub categories. 


Filter (funnel icon) 
Apply the current filter. 


Set Type (up arrow icon) 
Apply the current selected category to the current 
material library. 


Add + 


Add a new category. 


Remove - 


Remove the current selected category from the list. 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Material 

Materials Library VX system for library 
creation. 

Properties >» Material 

materials library_vx folder 

Mackraken 

meta-androcto 

GPL 

Community 

This add-on is bundled with Blender. 


Material Utilities 


Materials Utilities/Specials is designed to help with batch 
materials tasks. The add-on works in either Eevee or Cycles 
renderers. Common tasks are available from the Shift-Q pop- 
up menu and also the Materials Specials menu. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Material then Material Utilities to enable the script. 


Add-ons Preferences 
Choose the default settings for the add-ons actions here. 


Interface 


Located in the 3D Viewport Shift-Q hotkey. 


Located in the Properties >» Materials >» Specials. 


Instructions 


Assign Material + 
Assign a material to the current selection. List of all 
materials and search for a material by name. 


Select by Material (magnifying glass icon) 
In Edit or Object Mode you can select based on material. 
Faces with chosen material will become selected. All 
objects with a chosen material will be selected in Object 
Mode. 


Copy Material to Selected (ID icon) 
Copy the material from the active object to selected 
objects. 


Clean Slots (glossy sphere icon) 
Clean Material Slots x 
For all selected objects, removes all empty and 
unused material slots (not assigned to any polygons). 
Due to Blender’s current limitations, available only in 


Object Mode (the option will be grayed out in Edit 
Mode). 


Remove Active Material Slots - 
Todo. 


Remove All Material Slots (x) 
Removes All material slots of the active object. 


Replace Material (overlay icon) 
Replace a material by name. Lets your replace one 
material by another. Optionally for all objects in the 
blend, otherwise for selected editable objects only. An 
additional option allows you to update object selection, 
to show which objects were affected and which not. 


Set Fake User (shield icon) 
Lets you set all the materials to have a fake user. This is 
very useful when saving materials for use later. 


Change Material Link (chain icon) 
Todo. 


Specials (star icon) 
Merge Base Names 
Todo. 


Join by Material 
Todo. 


Set Auto Smooth 
Activate Auto Smooth. 


Slot to Top/Slot to Bottom 
Move the slot to top or bottom of the stack. 


Further comprehensive documentation can be found in the 
co-author’s Github repository. 


Reference 


Category: 
Description: 


Location: 
File: 
Author: 
Maintainer: 
License: 


Support Level: 


Note: 


Material 

Menu of material tools (assign, select...) 
in the 3D Viewport. 

3D Viewport Shift-Q 

materials utils folder 

MichaleW, ChrisHinde 

MichaleW, ChrisHinde 

GPL 3+ 

Community 

This add-on is bundled with Blender. 


Mesh 


These add-ons relate to edit mesh mode and related tools. 


3D Print Toolbox 

Auto Mirror 

Bsurfaces GPL Edition 
Edit Mesh Tools 

F2 

Inset Straight Skeleton 
Loop Tools 

Snap Utilities Line 
tinyCAD Mesh Tools 
Tissue 


3D Print Toolbox 


Reference 

Category: Mesh 

Description: Utilities for 3D printing. 
Location: 3D Viewport > Sidebar 
File: object_print3d_utils folder 
Author: Campbell Barton 
Installation 


e This add-on is bundled with Blender. 

e Open Blender and go to Preferences, then the Add-ons 
tab. 

e Click Mesh then 3D Print Toolbox to enable the script. 


Description 


Blender can be used to created meshes for 3D printing. 
Meshes exported from Blender are usually imported into a 
piece of software takes the mesh and “slices” it into paths 
that the 3D printer can execute. An example of such Slicer 
software is Cura. 


In order to correctly slice a mesh, it needs to be 
“watertight”, meaning that the surface is closed 
everywhere. Additionally, there should be no edges or faces 
sticking out. 3D Print Toolbox helps you analyze problems in 
your mesh that could cause slicing issues. 


It can be found in 3D Viewport » Sidebar > 3D-Print, when a 


mesh is selected. 


Analyze 


Statistics 


By clicking either Volume or Area, the volume or area of the 


mesh is calculated and shown. 


Checks 


A number of different checks can be 
performed to analyze in which ways 
your mesh might be invalid for use 
with a Slicer. 


Upon execution of one of the checks, 
the Result field shows which, if any, 
parts of your mesh are invalid. 


When in Edit Mode, clicking these 
results selects these parts of your 
mesh. You can use View Selected 
Backslash to focus on these parts. 


Although Slicers are becoming 


increasingly tolerant when it comes to 


“tidiness” of meshes, it is always 
worth trying to provide as cleana 
mesh as possible. 


Solid 


Solid 
Intersections 
Degenerate 0.00010 
Distorted 45° 
Thickness 0.001 m 
Edge Sharp 160° 
Overhang 45° 
Check All 
Result 
(jy) Non Manifold Edge: 18 
Bad Contig. Edges: 0 


Intersect Face: 0 


iy Zero Faces: 2 


yp Zero Edges: 9 
) Non-Flat Faces: 2 

Thin Faces: 0 

Sharp Edge: 0 


ry Overhang Face: 1 


The Checks panel. 


Checks for Non-Manifold edges and 
Bad Contiguous edges. 


Edges should connect to exactly 2 faces. In it connects to 
only one, it means there’s a hole in the mesh. More is 
also not allowed. These edges are considered Non- 
manifold. If one of the faces’ normals is pointing in a 
different direction than its neighbors, its edges are 
marked as “Bad Contiguous”. 


In this screenshot, the left shape has a hole, and the 
right shape has one of its faces flipped. 


Left, marked in blue: Non-manifold edges. Right, 
marked in red: Bad contiguous edges. 


Intersections 


These two cubes have intersecting faces. A Boolean 
modifier would help in this example. It’s worth noting 
that some slicer applications can deal with this, so it’s 
not always required to resolve this issue. 


Degenerate 
Faces and edges which have 0 area or length, are 
considered degenerate. In this example, the top face of a 
cube has been scaled down to 0, but have not been 
merged. A Merge > By Distance would resolve this issue. 


There’s a hidden face here. 


Distorted 
The vertices of a quad or ngon can be folded in such a 
way that the face is not flat. In practice, quads are rarely 


ever flat. When exporting, these faces are converted to 
triangles. If the surface is excessively deformed, this can 
result in unexpected shapes. 


In this example, a quad has been folded into a saddle-like 
Shape. This triggers the Distorted check. It would be best 
to triangulate by hand here. 


This quad can triangulate in unexpected ways. 


Thickness 


Faces that form very thin geometry might be missed 
entirely by the slicer. Such faces are marked as Thin. 


Edge Sharp 
Similar to Thickness, sharp edges can thin pieces of 
geometry which might be missed by the slicer 


Overhang 
As 3D printers can’t print in mid-air, parts of the model 
which overhang will not print correctly. In practice, slicers 
can add additional material, support, to anticipate for 
overhanging layers. 


Check All 
Performs all of the above checks at once. In this example, 
Suzanne shows quite a few problems. This is because the 
eyes are separate parts, and the sockets have holes. This 
makes the mesh not Solid and Intersecting. Some of the 
faces are Distorted. 


Non Manifold Edge: 42 
ad Contig. Edges: 0 


tersect Face: 52 


Non-Flat Faces: 20 


Thin Faces: 17 
Sharp Edge: 0 
a Overhang Face: 58 


Clean Up 


Distorted 
Triangulates the faces which are considered Distorted, as 
explained above. 


Make Manifold 
Attempts to fix various problems which might make a 
mesh non-manifold, such as by fixing bad normals, filling 
holes, and removing empty edges and faces. 


Transform 


Scale To 


Volume 
Scales the model to an exact given volume. 


Bounds 
Scales the model so that the biggest axis of the objects 
bounds (or dimensions) match the given value. 


Export 


Provides quick access to Blender’s object exporting 
operators found in File >» Export. 


Auto Mirror 


This add-on makes it easy to quickly cut and mirror mesh 
objects. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Mesh then Auto Mirror to enable the script. 


Usage 


1. In Object Mode, select the object you want to mirror. 

2. Choose settings from the Auto Mirror panel in the 
Sidebar » Edit tab. 

3. Press Auto Mirror and depending on the settings, your 
object will be in Edit Mode, with mirror set up for you. 


Reference 

Category: Mesh 

Description: Super fast cutting and mirroring for 
mesh. 

Location: 3D Viewport > Sidebar » Edit tab 

File: mesh_auto_mirror.py 

Author: Lapineige 

License: GPL 


Note: This add-on is bundled with Blender. 


Bsurfaces GPL Edition 


Todo. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Mesh then Bsurfaces GPL Edition to enable the 


Script. 
Reference 
Category: Mesh 
Description: Modeling and retopology tool. 
Location: 3D Viewport Edit Mode » Sidebar » Edit 
tab 
File: mesh_bsurfaces.py 


Author: Eclectiel, Spivak Vladimir (cwolf3d) 


Edit Mesh Tools 


Mesh Edit Tool adds several tools to Blender that are not 
available in the built-in tools or provide different methods 
for similar tasks. Each Menu: Vertex, Edge, Face and Utility 
is a sub panel that is closed by default in the Sidebar » Edit 
tab. The Icons in the closed panel headers contain some 
new/different selection tools and Edit Mode vertex/edge/face 
selection modes for quick access to some tools, before 
opening the sub panels. 


In the UI there are a variety of tools in each category, most 
tools have a tooltip to provide some usage information to 
help users understand each tools basic requirements. The 
most significant hotkey is in Edit Mode double Rms brings up 
the Vertex/Edge/Face menus depending on vertex/edge/face 
selection mode. Menu Integration is main tools into the Edit 
Mode context menu, selection tools into the Edit Mode 
select menu. 


Face Inset Fillet: based completely on add-on by zmj100 

Vertex Align: by zmj100 

Edge Fillet Plus: by Gert De Roost - original by zmj100 

Split Solidify: by zmj100, updated by zeffii to BMesh 

Pen Tool: by zmj100 

Mesh Cut Faces: by Stanislav Blinov (Stan Pancakes) 

Vertex/Edge/Face Context Menu: by Stanislav Blinov 

(Stan Pancakes) 

e Edge Roundifier: by Piotr Komisarczyk (komi3D), PKHG 

e PKHG Face Extrude: by PKHG, based on Geodesic Domes 
add-on “faces function” 

e Set Edges Length: by “Giuseppe De Marco [BlenderLab] 
inspired by NirenYang” 

e Edge Tools: by Paul Marshall (brikbot) 


e Extrude and Reshape: by Germano Cavalcante (mano- 
wil) 

Fast Loop: by Andy Davies (metalliandy) 

Multi Extrude: by Liero, Jimmy Hazevoet 

Offset Edges: by Hidesato Ikeya 

Mesh to Wall: by luxuy_BlenderCN 

Vertex Chamfer: by Andrew Hale (TrumanBlending) 
Random Vertices: by Oscurart 

Select Tools: by dustractor 

Relax: by Fabian Fricke 

Thanks to Macouno and CoDEmanxX 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Mesh then Edit Mesh Tools to enable the script. 


Description 
Todo. 


See also 


Please see the old Wiki for the archived original docs. 


Extrude & Reshape 


You can select a face and extrude it inwards or outwards, 
creating new faces to accommodate the extrusions. Note: 
Also known as Push/Pull Face. 


Relax 


This operation relaxes the selected vertices while retaining 
the shape as much as possible. 


To use this operation, go into Edit Mode and select the 
vertices you want to relax. To execute the script either 
Context Menu » Relax or use Mesh » Vertices >» Relax 
instead. 


Reference 

Category: Mesh 

Description: Mesh modeling toolkit. Several tools to 
aid modeling. 

Location: 3D Viewport > Sidebar » Edit tab, 3D 
Viewport Edit Mode » context menu 

File: mesh_tools folder 

Author: Multiple Authors, Meta-Androcto 

Maintainer: meta-androcto, lijenstina 

License: GPL 


Note: This add-on is bundled with Blender. 


F2 


F2 (also Known as the ‘spider-script’) extends Blender native 
functionality of creating faces. It allows you to create a face 
from a single vertex selection or a single edge selection, 
while retaining all the built-in functionality. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Mesh then F2 to enable the script. 


Description 


Quad from Vertex 


When a single vertex is selected, a new quad is formed by 
creating a new vertex. The position of this new vertex is 
calculated based on the three existing vertices. These are 
the selected vertex, and two vertices to which it is 
connected via open edges. An open edge is an edge which 
is only part of one face, or none at all. The newly created 
quad has the same material and normal direction as the 
neighboring faces. 


Quad from Edge 


Similar to the Quad from Vertex functionality, this is based 
on open edges. The selected edge has to be connected to 


two open edges. The vertices that belong to these edges are 
used to create a new quad. 


Direction Control 


If there are multiple ways to create a new quad, the position 
of the mouse cursor is taken into account. Of the multiple 
new faces which are possible, the one which will be closest 
to the mouse cursor (in 2D screen space) is the one which 
will be created. 


Reference 


Category: Mesh 
Description: Extends the ‘Make Edge/Face’ 
functionality. 


Location: Mesh Edit Mode F 

File: mesh_f2.py 

Author: Bart Crouch, Alexander Nedovizin, Paul 
Kotelevets (concept design), Adrian 
Rutkowski 

License: GPL 


Note: This add-on is bundled with Blender. 


Inset Straight Skeleton 


This add-on makes ‘inset polygons’, which you get when you 
advance the edges of the polygon inwards at a constant 
rate. Sometimes when you do that, an advancing edge 
Shrinks to nothing, or edges hit an advancing concave 
corner. The algorithm tries to do the right thing when this 
happens: one or more new polygons may form at that point, 
and insetting can continue inside those new polygons. 


You can either inset a single polygon or you can treat groups 
of polygons connected together as a single region, forming 
a complicated polygon (that may include holes) to be 
insetted as a unit. 


In addition to insetting, it is often useful to raise or lower the 
inset polygon (perpendicular to the inset plane), soa 
parameter to do that is included also. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Mesh then Inset Straight Skeleton to enable the 
Script. 


Description 


Enter mesh Edit Mode on a mesh object, and select one or 
more faces. 


Scale 


Percent 


Means that amounts are a percentage of the amount 
for a full inset. 


Absolute 
Means that the amounts are in units. 


Amount 
The distance to move the edges inward. 


Height 
The distance to move the inset polygons upward. 


Region 
If checked, treat all selected faces as a region to be inset, 
otherwise inset each face individually. 


Quadrangulate 
Todo. 


Technical Details 


The method used is described on the Straight Skeleton 
Wikipedia page. Consider this starting polygonal region: 


As the edges move inward at a constant speed, two kinds of 
events can happen. One is that an advancing corner can hit 
an advancing edge, as seen on the right part of this picture: 


When this happens, the inset polygon splits into two. 
The other is that an advancing edge can shrink to a point. 


When the whole process continues until the end, you get 
something like this: 


One cool thing about this algorithm is that if you move 
upwards or downwards (perpendicular to the inset plane) at 
a constant speed, you form ‘roofs’ with a fixed pitch. 


See also 


Please see the old Wiki for the archived original docs. 


Reference 

Category: Mesh 

Description: Make an inset inside selection using 
straight skeleton algorithm. 

Location: 3D Viewport operator 

File: mesh_inset folder 

Author: Howard Trickey 

License: GPL 


Note: This add-on is bundled with Blender. 


Loop Tools 


Todo. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Mesh then Loop Tools to enable the script. 


Description 


Bridge 


There are two main ways to use the Bridge tool. The first 
method is to select two groups of faces and then run the 
tool. The second method is to select two (closed) loops of 
edges. Both methods can be mixed and you can even 
Bridge multiple groups at the same time. The script will try 
to make an educated guess on which groups should be 
connected. 


Bridge shares its settings with the Loft tool, so changing a 
setting for one of the tools, will also change it for the other 
tool. 


Segments 
The number of faces used to bridge the distance 
between two loops. One segment means that only faces 
will be created. Two (or more) segments means that an 
intermediary line (or lines) of vertices is created, so two 


or more faces can be defined between the loops. If the 
value is set to zero, the script automatically calculates 
the best amount of segments in order to keep the faces 
as square as possible. 


Minimum Width 
This option has no label, but is located directly to the 
right of the segments setting. The simple explanation: 
0% lot of triangles, 100% mostly square faces. There is a 
bit more to it though. It determines when a new vertex 
has to be created, or when to use the vertex next to it. It 
does this based on the distance between these vertices 
compared to the distance between the vertices in the 
Original loops. So 50% means that if the distance 
between two vertices that will be newly created is 
smaller than half the distance between two vertices in 
the original loop, they will be merged together, resulting 
in only a single new vertex. 


Interpolation 
This can be set to either cubic or linear. Linear is just a 
flat interpolation, while cubic tries to retain the surface 
tangents, resulting in more fluid curves. 


Strength 
The strength option is only available when the 
interpolation mode is set to cubic. Setting the strength to 
zero gives a result very similar to linear interpolation, 
while higher strengths result in more fluid curves. Setting 
a negative strength changes the direction of the curve. 
Or described in a more visual way: it makes deflated 
volumes inflate and vice versa. The soft limits of this 
option are set to range from -3 to +3, but you can easily 
assign bigger or smaller values by manually entering a 
number, instead of using the slider. This works just the 
Same as with normal sliders in Blender. 


Remove Faces 


When using a face-selection input, the inner faces will be 
removed after bridging. 


Because of some limitations in Blender the weight values 
assigned to the Bevel modifier might be slightly altered 
(by about 0.01) when this option is enabled. 


Twist 
Determines which vertices in both loops are connected to 
each other. This might be used for artistic reasons or to 
correct a wrong result given by the script. 


Reverse 
This option should only be used if the script gives a 
wrong result. It reverses the order in which vertices are 
connected and can fix problems when the script gives a 
result that looks inverted. It’s a bit hard to describe, but 
just try it once and you'll immediately understand what it 
does. 


Creating Holes 


You can additionally create holes in an object via the Bridge 
tool. Select two or more faces and run the Bridge tool. 


Circle 


There are two correct inputs for the circle tool: selecting a 
single vertex, or selecting a closed or open loop of edges. 
You can also have the tool operate on multiple inputs at the 
Same time and mix the input types. 


Method 
Best Fit 


When Best Fit is selected a circle is calculated using a 
nonlinear least squares method. This basically means 
that the circle that is calculated with this option best 
fits the vertices you selected. 


Fit Inside 
Selecting Fit Inside will calculate the circle in such a 
way that none of the vertices will be moved away 
from the center of the calculated circle. This is useful 
when you want to retain the topology of the 
Surrounding mesh. 


Flatten 
When enabled, the input will be flattened to an optimal 
plane. This includes the center vertex, if the input 
consisted of a single vertex. When disabled the input will 
be projected onto the existing mesh. 


Radius 
This overrides the radius calculated by the script. Useful 
if you wish to create several circles of the same size, or if 
you need more precision. 


Regular 
When this option is selected, the vertices on the circle 
will all have the same distance between each other. 


Influence 
The force of the tool. Zero percent influence means no 
changes will be made to the mesh. 100% influence 
means that the input will be fully transformed into a 
circle. 


Curve 


There are two valid input methods for the curve tool. The 
first is to select two or more vertices on the same loop. You 
can do this for multiple loops simultaneously to save time. 


The second method is to select one or more entire loops. If a 
full loop is selected, the curve tool won’t operate on that 
loop, but on all loops perpendicular to it and use the 
vertices on the selected loop(s) as control points. 


Interpolation 
Cubic gives a smooth curve, calculated using a natural 
cubic spline algorithm. Linear calculates straight lines 
through the control points. 


Restriction 
This restricts the movement of the vertices to only one 
direction. Indent only allows movement toward the mesh, 
while extrude only allows movement away from the mesh 
(in the direction of the normal). 


Boundaries 
If enabled, the curve won’t stretch beyond the input 
vertices. This limits the tool to only a subsection of the 
mesh. 


Regular 
This will evenly distribute the vertices along the curve. 
Sometimes this can create weird results, aS an even 
distribution isn’t always possible (since the selected input 
vertices aren’t moved). If that is the case, simply 
uncheck this checkbox. 


Influence 
The force of the tool. Zero percent influence means no 
changes will be made to the mesh. 100% influence 
means the tool will have the maximum effect. 


Flatten 


Any selection is considered acceptable input for the flatten 
tool. 


Plane 
The method used to calculate the plane on which the 
input is flattened. 


Best Fit 
Calculates a plane so that on average the vertices will 
have to be moved the least to be flattened. 


Normal 
Is identical to scaling the input to zero on local Z when 
the orientation is set to normal (so G Z Z 0). It’s mainly 
included for making an easy comparison between the 
flatten methods. 


View 
Flattens the input on a plane perpendicular to the 
viewport angle. So when you run the tool, it will 
appear nothing has changed, but when you rotate the 
viewport, you'll see what has happened. 


Influence 
The force of the tool. Zero percent influence means no 
changes will be made to the mesh. 100% influence 
means the input will be fully flattened. 


Loft 


For loft you can use the same input method as for Bridge: 
selecting groups of faces, or selecting (closed) loops. You 
can mix input methods. Contrary to Bridge, you can select 


more than two input groups, and have them bridged 
consecutively. 


Loft shares its settings with the Bridge tool, so changing a 
setting for one of the tools, will also change it for the other 
tool. For a full discussion of all the settings take a look at the 
Bridge settings. Below you'll find some specific information 
for the loft tool. 


Segments 
This is identical to the Segments setting of the Bridge 
tool, but setting it to automatic (Segments = 0) has an 
advantage for the loft tool. When letting the script 
determine the number of segments needed, it might 
create different numbers of segments between different 
loops. 


Loop 
Connects the first and the last loop to each other. 


Relax 


The input of the relax tool consists of a single (partial) loop. 


Interpolation 
Determines how the final position of the vertices is 
calculated. Cubic uses a natural cubic spline to project 
the vertices on, linear projects the vertices on straight 
lines. 


A word of caution: when you use the relax tool ona 
closed loop (a loop where all vertices are connected to 
two other vertices in the same loop) you can better use 
cubic interpolation instead of the linear. If you use linear 
interpolation, the volume of the loop will quickly 
diminish. 


Input 
Selection 
When set to Selection the tool will only operate on the 
selected vertices. 


Parallel (all) 
Setting it to Parallel (all), will also include the vertices 
of all parallel loops. 


Iterations 
The number of times the tool is run. A higher number 
gives a smoother result. 


Regular 
If this option is selected, the vertices will be distributed 
evenly along the loop. 


Space 


The input of the space tool consists of a single (partial) loop. 


Interpolation 
Cubic distributes the vertices along a natural cubic spline 
through, while linear projects the vertices on the already 
existing edges. 


Input 
Selection 
When set to Selection the tool will only operate on the 
selected vertices. 


Parallel (all) 
Setting it to Parallel (all), will also include the vertices 
of all parallel loops. 


Influence 


The force of the tool. Zero percent influence means no 
changes will be made to the mesh. 100% influence 
means the tool will have the maximum effect. 


See also 


For an illustrated explanation of all the tool settings visit 
the script home page. 


Please see the old Wiki for the archived original docs. 


Reference 

Category: Mesh 

Description: Mesh modeling toolkit. Several tools to 
aid modeling. 

Location: 3D Viewport >» Sidebar » Edit tab, 3D 
Viewport Edit Mode >» context menu 

File: mesh_looptools.py 

Author: Bart Crouch 

License: GPL 


Note: This add-on is bundled with Blender. 


Snap Utilities Line 


Installation 


e This add-on is bundled with Blender. 
e Open Blender and go to Preferences then the Add-ons 


tab. 
e Click Mesh then Snap Utilities Line to enable the script. 


Make Line 


Creates edges and operationally faces by snapping to mesh 
elements. When moving the cursor close to a face, edge or 
vertex, the cursor is snapped to the highlighted element. It 
can also be snapped to center or perpendicular of an edge. 
After selecting the first point you can specify the length of 
the line by typing a value and confirming with Return. 


Reference 

Mode: Edit Mode 

Tool: Toolbar >» Make Line 
Controls 


Axis Constrain x, Y, Z 
Constraint the cursor movement on the X, Y, or Z axis. 


Edge Constrain Shift 
Constraint the cursor movement towards an edge. 


For the constrain work, you need to have your cursor 
over an edge. 


This is useful for creating parallel lines. 


Confirm Input Return 
Confirms the numerical value written in the header for 
the line length. 


Cut Line LmB 
Starts the lines drawing. 


Confirm RvB 
Single click stops the lines drawing. 


Double-clicks completes the tool’s execution. 
Cancel Esc 


Cancel the operation. 


Options 


Create Faces 
A face is created when: 


1. It detects the drawing of a closed segment. 


2. The last vertex of the segment binds to an edge that 
connects another vertex of the segment. 


Z 
3. It detects an isolated edge loop. 


1 


=> 


4. We redraw existing edges to match the conditions 
mentioned above. 


2 3 

Ly a 
Reference 
Category: Mesh 
Description: Tool that allows accurate modeling 


through its own snapping system 
Location: 3D Viewport > Tools » Line Tool 


File: mesh_snap_utilities line folder 
Author: Germano Cavalcante 


tinyCAD Mesh Tools 


The add-on is a combination of several scripts which should 


drafting with some level of precision. The context menu has 
the tinyCAD functions prepended to it. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Mesh then tinyCAD Mesh tools to enable the script. 


Description 


VTX 


Automatically extends, projects or intersects the two 
selected edges if they are co-planar. For auto VTX you must 
be in (Edit Mode and edge mode) and have two edges 
selected. When invoked the add-on will detect if you are 
trying to intersect, project or extend two edges. It will 
internally pick from V, T or X. It will also notify you if the 
edge are not co-planar / do not intersect. 


e V: Extending two edges towards their calculated 
intersection point. 

e T: Extending the path of one edge towards another 
edge. 

e X: Two edges intersect, their intersection gets a weld 
vertex. You now have four edges and five vertices. 


V2X 


Places a new separate vertex at projected intersection of 
two selected edges. 


XALL 


This mass intersects a collection of edges. Pick a collection 
of edges and invoke XALL. It will deselect any edge that 
doesn’t intersect other edges first. Then it goes through all 
combinations of the remaining edges to see if there are 
intersections. Each intersection is dealt with and the result 
is added to the collection of edges to check. This process 
continues until no more intersections are found. 


BIX 


Given two selected edges, this script creates the bisector of 
these edges. The edges are first checked for co-planarity. 


CCEN 


Construct a circle and its center. Pick three vertices that 
once made up a circle, then W >» CCEN, the script adds a 
Grease Pencil representation of the circle. To add a mesh of 
that constructed circle you can press Fé straight afterwards 
and adjust the circle’s vertex count. Then press Make Circle 
Mesh to add a new circle. This is a little bit experimental, 
but works fine. 


Reference 


Category: Mesh 
Description: 


Mesh modeling toolkit. Several tools to 
aid modeling. 


Location: 3D Viewport Edit Mode » context menu 
File: tiny_cad folder 

Author: zeffii (Dealga McArdle) 

License: GPL 


Note: This add-on is bundled with Blender. 


Tissue 


TISSUE aS SE INCLUDES 
= te tessellation 

2 dual mesh 
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and more... 


www.co-de-it.com 


Tissue is a collection of tools that facilitate the use of 
computational-design techniques inside Blender. It consists 
of different tools, visible in the right panel. According to the 
active mode, different tools are displayed: 


e Tissue Tools (visible in Edit Mode and Object Mode) 
e Tissue Weight Tools (visible in Weight Paint Mode) 
e Tissue Color Tools (visible in Vertex Weight Mode) 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Mesh then Tissue to enable the script. 


Tissue Tools 


é5~ Scene 
Y Tissue Tools 


Generate: 
a Tessellate u® 
O Dual Mesh 


Convert to Curve 


Convert to Dual Mesh 
Polyhedra Wireframe 
Lattice along Surface 


UV to Mesh 


Random Materials 


gs2 = Weight to Materials 


Utils 


@® Tissue Render Animation 


Generators 


Generators are non-destructive functions that generate new 
objects starting from input objects. They include Tessellate, 
Dual Mesh (a special Tessellate) and Convert to Curve. 
For all of them, a Refresh operator can be used in order to 
reload the changes from the input objects. 


Tessellate 


The Tessellate tool allows the user to copy a selected object 
(Component) on the faces of the active object (Base), 


adapting its bounding box to the shape of quad faces. It is 
possible to use as input objects Mesh, Curve, Surface and 

Text and Meta objects. When using Tessellate, two objects 
must be selected. Once the Tessel/ate button was pressed, 
then more options will appear in the tool parameters. 


Use Modifiers Use Modifiers 


Later it will be possible to change them, together with more 
advanced settings from the Object Data Panel of the 
generated object. 


Remesh 
Geometry Data 
Tissue Tessellate 


Bey Refresh 


Base object: 
@ Cube 


Fill Mode: 
Tri Quad Fan Patch Frame 


Smooth Shading 
¢ Components 


Component Mode: 


Collection Materials 


Torus : Use Modifiers 


Thickness 


Constant 


Thickness Direction 
Merge 
Components Coordinates 
>» Rotation 


> Selective 


> Weight and Morphing 


Iterations 


Use Modifiers 
This option is available for both Base and Component 
objects and allows the use the respective modifiers. If 


this option is disabled, then only the original object’s 
data will be used. 


Fill Mode 


Tessellation strategy used to map the Component’s 
coordinates on the Base’s faces. 


Tri 


This options will automatically triangulate the Base 
object and will map the component to the triangular 
faces. The input domain will be considered 
rectangular, but the target domain will have two 
vertices coincident. 


Quad (default) 


This is the default method and will map the 
Component domain to each quad face of the Base 
object. If an face has more than 4 vertices, then it will 
be automatically separated in quad or triangular 
faces. 


BEY 
CSE) 


1 


Subdivision 
Surface 


Component Base Mesh Quad Tessellation 


Fan 
This option will split every face of the Base object in 
triangles connecting each side of the face to its 
center. 


Component Base Mesh Fan Tessellation 


Patch 
This option require the use of a Subdivision Surface 
modifier on the Base object. It is similar to the Quad 
method, but it will allow to use curved domains, based 
on the Subdivided patches. If more subdivision 
surfaces (or Multiresolution modifiers) are used, then 
only the last one will be used for defining the target 
patches. 


Ga 
Component Lh i? y 
4 ? 
? 


Frame 
Similarly to an Inset Face operator, this option will 
allow to apply the components along offset faces of a 
given Thickness. 


Component Base Mesh Frame Tessellation 


Merge 
Automatically merge together all the generated 
components. 


Smooth Shading 
Automatically sets the shading of the generated 
geometry as Smooth. If the Component object is already 
set as Smooth, then this option is not necessary. 


Components 


Three different method can be used to assign the 
components. 


Object 
Repeat the same object on all the target faces. 


Collection 
Assign the objects contained in a given Collection. The 
components can be assigned either randomly or 
according to a Vertex Group. 


Materials 
Assign the components according to the name of the 
materials assigned to each face. If for a given 
material, there is no an object with the same name, 
then the face is not used. 


Watch the Tutorial (it is based on an old version of 
Tissue, the procedure is slightly different now) 


Thickness 
Scale Mode 
Constant 
Generate components with a fixed and uniform 
thickness in the normal direction. 


Relative 
Generate components with a thickness proportional 
to the target face dimension. This will produce 
components with an aspect ration similar to the 
original Component object. 


Scale 
control the scaling factor of the components’ 
Thickness 


Offset 
Allows to control the alignment of the components 
in relation to the Base object surface. 


Components Coordinates 


Strategy used to determine the component’s domain for 
mapping it on the target faces. 


(1,1) (1,1) 
(0,0) (0,0) 
(0,0) 


Bounds Local Global 


Bounds (Default) 
Automatically defines the domain according the 
Bounding Box of the component object. 


Local 
Defines the domain according to the local coordinates 
of the component object. The face domain is 
considered from 0 to 1 in both Local X and Local Y 
directions. This method allows a customization of the 
mapping strategies, maintaining the result 
independent from Location/Rotation/Scale of the 
component object. 


Global 
Similar to Local, but based on the Global coordinates 
of the component. This allows to easily produce 
animations changing the Location/Rotation/Scale of 
the component. 


Watch the Tutorial 


Extend (Local and Global coordinates) 
Extend the domain of the components with a domain 
bigger than 0-1. 


Clip (Local and Global coordinates) 
Truncate the component according to the domain 0-1. 


Cyclic (Local and Global coordinates) 
Cut and move to the other side the parts of the 
component that exceed the domain 0-1. 


Component Base / Patches Tesselletion 


Weight and Morphing 
Combine the Vertex Groups of the base object with the 
Shape Keys from the component, in order to generate 
morphing components. 


Basis (0) 


Se 


> 


Morph (1) 


& 


? 


‘0 


Shape Keys Weight Moprhing 


Map Vertex Groups 
Remap each Vertex Group from the base mesh to the 
generated geometry 

Use Shape Keys 


Transfer the Shape Keys from the component object to 
the generated object. If the name of the base’s vertex 
groups and the Shape Keys match, then they will be 
automatically assigned in order to control their 
morphing behavior. 


Watch the Tutorial 


Iterations 


Automatically repeat the tessellation using as base the 
result of the previous iteration. 


Repeat 
Number of iterations. 


Combine iterations 


Combine the resulting tessellation with part or all of 
the previous iteration: 


Last 
Ignore the previous iterations. 


Unused 


Combine the tessellation with the faces of the 
previous iteration that are not generating 
components. 


All 


Combine the tessellation with all the faces from 
the previous iteration. 


Dual Mesh 


Dual Mesh modifies the selected meshes creating dual 
meshes. Dual Mesh output is a polygonal mesh derived from 
the triangular mesh. Quadrangular meshes are 
automatically converted to triangular before. 


1. QUADRANGULAR MESH 2. TRIANGULAR MESH 


og suas ee 


3. SUBDIVIDED MESH 4. DUAL MESH 


Quad Method 


Methods for splitting the quads into triangles. (Inherited 
from the Triangulate Faces tool.) 


Polygon Method 
Methods for splitting the polygons into triangles. 
(Inherited from the Triangulate Faces tool.) 


Preserve Borders 
Prevent alteration of the open boundaries of the mesh. 


Convert to Curve 


Generate a Curve object from the Loops, Edges or Particles 
of the active object. This is a non-destructive operation, 
meaning that in any moment it will be possible to reload the 
changes from the base object and change the parameters of 
the conversion. It will be possible to convert specific 
edges/loops according to different criteria, together with the 
addition of a pattern effect. 


(To Do) 


Refresh 


Update the active object according to the changes in the 
base geometries. This operator works on the objects 
generated through Tessellate and Convert to Curve. 


Rotate Faces 


Rotate the indexes of the selected faces (in Edit-Mode). This 
allows to control the rotation of the components of 
Tessellated objects, when using Default rotation. Once the 
operator is executed, then the interested Tessellated objects 
are automatically refreshed. 


Convert to Dual Mesh 


Destructive version of the Dual-Mesh operator. This directly 
convert the active object to its Dual-Mesh. 


Polyhedra Wireframe 
(To Do) 

Lattice Along Surface 
(To Do) 

UV to Mesh 


Convert the active UV-map to mesh trying to preserve the 
original 3D model total surface area. 


Random Materials 


Assign random materials to the face’s of the active mesh 
object. 


Weight to Materials 
Distribute existing materials according to the weight of the 


active vertex group. It is also possible to automatically 
create new materials. 


Tissue Render Animation 


(To Do) 


Tissue Weight Tools 


é5~ Scene 
Y Tissue Tools 


Weight Generate 
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ng Weight Distance 
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Deformation Analysis 
Edges Deformation 


Edges Bending 


Contour Curves 


Contour Displace 


is 
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Contour Mask 
Simulations 

nS Reaction-Diffusion 
Materials 

e. Random Materials 

He Weight to Materials 
Weight Convert 
Convert to Colors 


Convert to UV 


Area 


Weight from Faces area (Automatic Bounds, Manual Bounds) 


Curvature 


Weight from Curvature (Based on Dirty Color Attributes) 


Weight Distance 


Generate a vertex group according to the distance from the 
selected vertices. Different methods can be used: Geodesic, 
Euclidean or Topology distance. 


Weight Formula 


Weight based on Vertices parameters. Allows to use vertices 
coordinates and normals direction. Integer and Float sliders 

can be created in order to find the proper parameters more 

easily. 


Weight Laplacian 


(To Do) 
Harmonic 


Harmonic function based on active Weight 


amp * sin(weight * freq) 


Random 

(To Do) 

Edges Deformation 

Generate a Vertex Group based on Edges Deformation 


evaluated on the Modifiers result (Deformation Modifiers 
and Simulations) 


Edges Bending 


Generate a Vertex Group based on Edges Bending evaluated 
on the Modifiers result (Deformation Modifiers and 
Simulations). 


Streamlines Curves 


(To Do) 


Contour Curves 


Generates isocurves based on Active Weight. 


Contour Displace 


Cut the mesh according to active Weight in a variable 
number of isocurves and automatically add a Displace 
Modifier. 


Contour Mask 


Trim the mesh according to active Weight. 


Reaction Diffusion 


Tissue implements the Gray-Scott model for the Reaction- 
Diffusion simulation. This allows to simulate through the 
vertex groups the distribution of the two substances that 
generate the various patterns of many living organisms. 


See this video for an example of the Reaction-Diffusion 
simulation with Tissue. 


Radom Materials 
(To Do) 
Weight to Materials 


(To Do) 


Convert to Colors 


Convert To 
Value Channel, Red Channel, Green Channel, Blue 
Channel, False Color 


Invert 
Invert the values read from vertex weight. 


Convert to UV 


(To Do) 


Tissue Color Tools 


é5~ Scene 


Y Tissue Tools 


seg = Convert to Weight 


Convert to Weight 


Red Channel 
Add a vertex group derived to red channel of the active 
Color Attribute. 


Green Channel 
Add a vertex group derived to green channel of the 
active Color Attribute. 


Blue Channel 
Add a vertex group derived to blue channel of the active 
Color Attribute. 


Value Channel 
Add a vertex group derived to value channel of the active 
Color Attribute. 


Invert 
Invert the values read from vertex weight. 


Example 


See this video for an example of the Tissue add-on in action. 


Reference 

Category: Mesh 

Description: Tools for computational design. 
Location: Sidebar » Edit tab 

File: mesh_tissue folder 

Author: Alessandro Zomparelli (Co-de-iT) 
License: GPL 


Note: This add-on is bundled with Blender. 


Node 


These add-ons relate to the node editors and related tools. 


e Node Arrange 
e Node Wrangler 
e Node Presets 


Node Arrange 
This add-on allows you to neatly arrange your nodes. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Node then Node Arrange to enable the script. 


Interface 


Located in the node editors » Sidebar >» Arrange tab. 


Description 
e« To Do 
Usage 
Todo. 
Reference 
Category: Node 
Description: Node Tree Arrangement Tools. 
Location: node editor » Sidebar > Trees 
File: node_arrange.py 


Author: JuhaWw 


Node Wrangler 


This add-on gives you several tools that help you work with 
nodes quickly and efficiently. Many functions work for both 
the Compositor and shader nodes, and some functions bring 
features already in the Compositor to the shader nodes as 
well. Some tools are made for a specific function, however 
we have made it our goal to allow complete flexibility for 
you to use the tools in every situation, even where we did 
not intend. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Node then Node Wrangler to enable the script. 


Usage 


Use panel in Sidebar of node editor or Ctrl-Spacebar 
keyboard shortcut or individual shortcuts for tools. 


Description 
Lazy Connect 


Reference 


Shortcut: Ctrl-RMB-drag, Shift-Ctrl-RMB 


Make links between the nodes without having to precisely 
select the sockets. Just drag from one node to another while 
holding ctrl-RMB. The nodes nearest the mouse are used, so 
you don’t even have to click on one precisely. 


Also, use Shift-Ctrl-RMB to Show a menu of inputs and 
outputs to make a more accurate connection. This is useful 
when working with a large node tree, since you can easily 
make connections without having to zoom in and out a lot. 


Lazy Mix 


Reference 


Shortcut: Alt-RMB-drag 


Merge outputs of two nodes using a Mix node or Mix Shader 
node by dragging from one node to another while holding 
down Alt-RMB. A Mix node or Mix Shader node will be added 
and the outputs of the nodes will be connected to it. 


Merge 
Quickly add Mix, Math, Z-Combine, Alpha Over, Mix Shader 


or Add Shader nodes that will merge outputs of selected 
nodes. 


Merge with Automatic Type Detection 


Reference 


Shortcut: Ctrl-0, Shift-Ctrl-=, Ctrl-Minus, Shift-Ctrl- 
8, Ctrl-Slash, Shift-Ctrl-Comma, Shift-Ctrl- 
Period 


Selected nodes’ outputs will be merged using Mix, Math, Mix 
Shader or Add Shader nodes, depending on types of 
selected nodes. 


Add sShift-Ctrl-= 
Sets the blend mode or math operation to Add. When 
shaders are selected an Add Shader will be used. 


Multiply Shift-Ctri-8 
Multiply blend mode or math operation. 


Subtract ctri-Minus 
Subtract blend mode or math operation. 


Divide Ctrl-Slash 
Divide blend mode or math operation. 


Mix Ctrl-0 
Mix blend mode or when shaders are selected a Mix 
Shader node will be used. 


Greater than Shift-Ctrl-Comma 
Greater than math operation. 


Less than Shift-Ctrl-Period 
Less than math operation. 


Merge Using Mix Node 


Reference 


Shortcut: Shift-Ctrl-Alt-=, Ctrl-Alt-Minus, Shift- 
Ctrl-Alt-8, Ctrl-Alt-Slash 


Using Ctri-Alt with proper keys will force to use Mix node for 
merging no matter what types of nodes are selected. 


Merge Using Z-Combine Node 
Reference 
Shortcut: Ctrl-NumpadPeriod 


Z-Combine nodes will be used for merging. If possible - 
image and Z-Depth outputs will be linked. 


Merge Using Alpha Over Node 
Reference 

Shortcut: Ctrl-Alt-0 

Alpha Over nodes will be used for merging. 
Merge Using Math Node 


Reference 


Shortcut: Shift-Ctrl-=, Shift-Ctrl-Minus, Shift-Ctrl- 
8, Shift-Ctrl-Slash, Shift-Ctrl-Comma, Shift- 
Ctrl-Period 


Using Shift-Ctri with proper keys will force to use Math node 
for merging no matter what types of nodes are selected. 


Batch Change Blend Mode / Math 
Operation 


Reference 


Shortcut: Alt-Up, Alt-Down, ALt-0, Shift-Alt-=, Alt- 
Minus, Shift-Alt-8, Alt-Slash, Shift-Alt- 
Comma, Shift-Alt-Period 


Select Mix nodes or Math nodes and change their blend 
mode or math operation at the same time. Use keys 
specified above. They will change the blend mode or 
operation accordingly to: Mix, Add, Subtract, Divide, Less 
than, Greater than. Use Alt-Up or Alt-Down to go through all 
available blend modes or math operations. 


Change Mix Factor 


Reference 


Shortcut: Alt-Left, Shift-Alt-Left, Alt-Right, Shift- 
AlLt-Right 


Change Factor of selected Mix nodes or Mix Shader nodes. 


e Use Alt-Right to increase it by 0.1. 

e Use Alt-Left to decrease it by 0.1. 

e Use Shift-Alt-Right to increase it by 0.01. 

e Use Shift-Alt-Left to decrease it by 0.01. 

e Use Shift-Ctrl-Alt-Left to set factor to 0.0. Additional 
Shortcut is Shift-Ctrl-Alt-0. 

e Use Shift-Ctrl-Alt-Right to set factor to 1.0. Additional 
shortcut is Shift-Ctrl-Alt-1. 


Delete Unused Nodes 


Reference 


Shortcut: Alt-X 


Clean your node tree. Delete all of the nodes that don’t 
contribute to the final result. 


Swap Links 


Reference 


Shortcut: Alt-S 


Select two nodes that have something linked to their 
outputs. Alt-S will swap the outputs. What originally was 
linked to output of the first node will now be linked to output 
of the second node and vice versa. 


Or, select one node with a single linked input - Alt-s will 
cycle the link through the available input sockets. Or, select 
one node with two linked inputs - Alt-s will swap the two 
links. If more than two inputs are linked, the two with 
matching types will be swapped (such as a Mix node’s two 
color inputs). 


Reset Backdrop 


Reference 


Shortcut: Z 


Reset position and scale of the backdrop. 
Add UV Layout Attribute Node 


Reference 


Menu: Header >» Add menu 


Add Attribute node with the attribute set to UV Layout. 


Add Vertex Color Attribute Node 


Reference 


Menu: Header >» Add menu 


Add an Attribute node with the attribute set to Color 
Attribute. 


Shader Viewer 
Reference 
Shortcut: Shift-Ctrl-LMB 


Viewer Node for shaders. Shift-Ctrl-LMB and the output of 
the node will be linked to newly created Emission shader 
and Material Output. This is an easy way of previewing 
textures. 


Frame Selected 
Reference 
Shortcut: Shift-P 


Select nodes and “wrap” them in Frame node by hitting 
Shift-P. Immediately after that hit Fé to set the color and 
label of the Frame. 


Reload Images 


Reference 


Shortcut: Alt-R 


All of the images used in the node tree (Image inputs, 
textures) can be reloaded by hitting Alt-R. 


Switch Node Type 
Reference 
Shortcut: Shift-S 


Change the type of selected node(s) to any other type. Hit 
Shift-S and you'll get the menu ordered exactly the same as 
Add >» Node menu. Choose the new type. 

Copy Settings 

Reference 


Shortcut: Shift-C 


Copy settings of active node to all selected nodes of the 
same type. 


Copy Label 


Reference 


Shortcut: Shift-C 


Copy labels all selected nodes based on various criteria. 
Labels can be copied from labels (names) of active node 
Shift-V, or from names (labels) of nodes that are linked to 
selected ones or from the names of sockets that the 
selected nodes are linked to. All options will be revealed in 
submenu after hitting Shift-c. 


Clear Label 

Reference 

Shortcut: AlLt-L 

Clear labels of selected nodes. 
Modify Label 
Reference 

Shortcut: Shift-ALt-L 


Batch change labels of selected nodes. Add text to 
beginning, to end, replace parts of text. 


Add Texture Setup 


Reference 


Shortcut: CtrleT 


Select any shader node, Ctri-T and an image texture with 
nodes controlling coordinates will be added. If you select 
any texture node, only the Texture Coordinate and Mapping 


nodes will be added. A background shader will get an 
Environment Texture node with generated mapping. 


Add Reroutes to Outputs 


Reference 


Shortcut: Slash 


Reroute nodes will be added and linked to each output of 
each selected node. 


Link Active to Selected 


Reference 


Shortcut: Backslash, K, Shift-K, ', Shift-', :, Shift-; 


Link active node to selected nodes basing on various 
criteria. 


e Backslash - Call main Link Active to Selected menu. 

e K - Link active to all selected. Use Shift-k to force to 
replace existing links. 

e Shift-' - Link only to selected nodes that have the same 
name/label as active node (Shift-' to replace existing 
links). 

e ; - Link selected when name of output matches the 
name or label of selected node. Handy for replacing 
sources. For example Render Layer to image (multi-layer 
EXR). 


Align Nodes 


Reference 


Shortcut: Shift-= 


Align nodes horizontally or vertically. Same ass X Oors Y 0, 
but with even spacing between the nodes. 


Select within Frame (Parent/Children) 


e ] - Select all nodes wrapped in selected Frame node. 
e [ - Select frame node that selected nodes are wrapped 
in. 


Detach Outputs 


Reference 


Shortcut: Shift-Alt-D 


Detach output of selected node leaving linked inputs. 


Link to Output Node 


Reference 


Shortcut: ) 


In compositing - link to Composite output. In materials - link 
to Material Output node. 


Add Image Sequence 


Reference 


Menu: Add > Input menu for composite nodes, 
or Add > Texture menu for shader nodes 


Select just one image from a sequence in the File Browser 
and it will automatically detect the length of the sequence 
and set the node appropriately. 


Add Multiple Images 


Reference 


Menu: Add > Input menu for composite nodes, 
or Add > Texture menu for shader nodes 


Simply allows you to select more than one image and adds 
a node for each. (Useful for importing multiple render 
passes or renders for image stacking.) 


See also 


Please see the old Wiki for the archived original docs. 


Reference 

Category: Node 

Description: Various tools to enhance and speed up 
node-based workflow. 

Location: Node editor >» Sidebar or see the hotkeys 
of individual tools. 

File: node_wrangler.py 

Author: Bartek Skorupa, Greg Zaal, Sebastian 
Koenig, Christian Brinkmann, Florian 
Meyer 


License: GPL 


Note: This add-on is bundled with Blender. 


Node Presets 


This add-on allows you to set a file path to a directory with 
blend-file(s) containing node groups. All the node groups will 
then be available from a new menu in the node editors » 
Add > Template menu. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Node then Node Presets to enable the script. 


Usage 


In the add-on’s preferences you can set the path to your 
directory. The directory or folder can have multiple blend- 
files and all node groups they contain will be available. All 
node editors are supported, you can add compositing, 
texture and material node groups. 


Reference 

Category: Render 

Description: Add node presets. 

Location: node editors » Add > Templates 
File: node_presets.py 

Author: Campbell Barton 

License: GPL 


Note: This add-on is bundled with Blender. 


Object 


These add-ons relate to Object Mode and related tools. 


Align Tools 

Bool Tool 

Carver 

Cell Fracture 

Edit Linked Library 
Grease Pencil Tools 
Object Color Rules 
Real Snow 

Scatter Objects 


Skinify Rig 


Align Tools 


Used to align the location, rotation or scale of selected 
objects to the active object on the specified axes. 


See also 


Please see the old Wiki for the archived original docs. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Interface then Align Tools to enable the script. 


Description 


Align from Selected Objects 
Minimum, Maximum, Center or Origin 


Align to Active Object 
Minimum, Maximum, Center or Origin 


Location X 
Location Y 
Location Z 
Rotation X 
Rotation Y 
Rotation Z 
Scale X 

Scale Y 


« Scale Z 


Reference 


Category: 


Description: 


Location: 
File: 
Author: 
License: 
Note: 


Interface 

Align selected objects to the active 
object. 

3D Viewport > Sidebar > Item tab 
Space view3d_ align tools folder 
gabhead, Lell, Anfeo, meta-androcto 
GPL 

This add-on is bundled with Blender. 


Bool Tool 


Todo. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Object then Bool Tool to enable the script. 


Description 


Concepts 


e Brush: Is an object used as a mask for the Boolean 
operation. 
e Canvas: Is the object that keep the Boolean operation. 


You can select any count of objects and apply all these 
objects to the active one as a Boolean brush. Just select the 
objects that you want to be a brush, select an object to set 
it as active and click in one of those operations: 


Auto Boolean 
Difference Shift -Ctrl-NumpadMinus 
Remove the objects to the active. 


Union Shift-Ctrl-NumpadPlus 
Add the selected objects to the active object. 


Intersection Shift-Ctrl-NumpadAsterisk 


Apply an intersect operation between the selected 
objects and the active. 


Slice Shift-Ctrl-NumpadSlash 
Todo. 


Brush Boolean 
Difference Ctrl-NumpadMinus 
Apply direct Difference to an object. 


Union Ctrl-NumpadPlus 
Apply direct Union to an object. 


Intersection Ctrl-NumpadAsterisk 
Apply direct Intersection to an object. 


Slice Ctrl-NumpadSlash 
Todo. 


Preferences 


Fast Transformation 
When enable this option in the add-on preferences your 
G/R/s hotkeys will be replaced for a custom one that can 
handle objects visibility and Boolean modifiers before 
and after the transform operation to give a fast transform 
when using Boolean operations. It only works good when 
handling high-poly brush, if you try to use it in a low-poly 
brush when another high-poly brush is applied it will be 
slow yet since we have a bad Dependency Graph 
handling of that situation. 


Reference 


Category: Object 
Description: Boolean modifier tools. 


Location: 


File: 
Author: 


License: 
Note: 


3D Viewport > Sidebar >» Edit tab, Shift- 
Ctrl-B 

object_boolean_tools.py 

Vitor Balbio, Mikhail Rachinskiy, 
TynkaTopi, Meta-Androcto, Simon Appelt 
GPL 

This add-on is bundled with Blender. 


Carver 


Cut and Boolean objects directly in the 3D Viewport. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Object then Carver to enable the script. 


Description 


If you have an active bevel on the object to be cut, it will 
update automatically as well as objects that will be created. 


To begin, select one or more objects, depending on the 
number of objects, the add-on will adjust to that. One 
object, you can cut (basic operation) and use the default 
patterns. Multiple objects, you can also cut, use patterns, 
and the last selected object serves as a “brush”. If you enter 
in the Profile Brush mode. It works on all selected objects, 
So you can cut two objects or apply a “brush” to all objects 
at the same time. 


The add-on is more accurate on orthographic view for basic 
Boolean operations. For others operations you can use the 
view if you wish. 


e Shift-Ctri-X to call the add-on. 

e RMB to exit. 

e Ctrt-z to Undo (there are no limits, so be careful to not 
overload it). 


e H to have the help when the screen is large enough to 
display. 


Basic Boolean Operations 


This mode is active when you run the add-on at start. 


Rebool Shift 
Holding Shift allows to make a rebool. 


Move All Alt 
Allows you to move the cut. 


Cursor Depth D 
To use the position of the cursor as depth. 


Move Cursor Ctrl-LMB 
You can move the cursor with Ctrl-Lme. 


Tool Type Spacebar 
To change the tool. 


Rectangle 


The Rectangle tool. Click, move and then click again 
to confirm the operation. 


Line 
The Line tool to polygonal cuts. It also allows you to 
bisect one or more objects. Click to the start point, 


move to the desired end point and then press Spacebar 
to confirm the cutting. 


Holding ctri allows to move incrementally. 


Circle 


The Circle tool, click then move to change the radius 
(vertical axis) or rotation (horizontal axis). 


Subdivision w, X 
Allows to change the circle subdivisions. 


Create Geometry c 
Switch to Create Mode. It reacts in the same way as 
above for shortcuts. Once validated, the add-on stops 
and selects the object created. 


Profile Brush 


When in profile mode, flat objects are present by default. 
You can add your own with the ProfilCreate. py file that will 
be explain after (ToDo). 


B to enter this mode when you are in basic Boolean 
operations. If you move your mouse over the object, you will 
see an overview of the pattern that you can use anda 
preview at the bottom right. 


Rebool Shift-Spacebar 
For the rebool. 


Duplicate Alt-Spacebar 
To create the object. 


Scale s 
Todo. 


Rotation LMB 
LMB and move the mouse to rotate. 


Step Angle ctrl 
Hold ctri to rotate with 45° degree steps. 


Tool Type w, xX 
To change the tool type. 


Instantiate L 
For instances when you duplicate the object (with holding 
Alt). 


Thickness D 
To change the thickness of the pattern. Then move your 
mouse on the horizontal axis. 


Axis Locking Ctrl 
Hold ctri to constraint axis. 


Brush Type T 
Difference 
To make a difference. 


Union 
To do a union Boolean (does not work with multiple 
objects). 
Reference 
Category: Object 
Description: Multiple tools to carve or to create 
objects. 
Location: 3D Viewport Shift-Ctrl-X 
File: object_carver folder 
Author: Pixivore, Cedric LEPILLER, Ted Milker, 
Clarkx 
License: GPL 


Note: This add-on is bundled with Blender. 


Cell Fracture 


Todo. 


See also 


Please see the old Wiki for the archived original docs. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Object then Cell Fracture to enable the script. 


Usage 


1. In Object Mode select the object you want to break 
apart. 

2. Use the Operator Search: “Cell fracture selected mesh” 
(search “cell” will find the list item). This will pop up the 
add-ons menu’s. 

3. Then choose your settings (you can try small values 
first, large values may be slow). If you use the defaults 
and when the next layer checkbox is active, the 
fractured object will appear on the next layer to the 
active objects layer. 


Reference 


Category: Object 


Description: 


Location: 


File: 
Author: 
License: 
Note: 


Tool for the fracturing of objects. 

3D Viewport >» Object menu >» Quick 
Effects 

object_fracture_cell folder 
ideasman42, phymec, Sergey Sharybin 
GPL 

This add-on is bundled with Blender. 


Edit Linked Library 


When working in larger projects that involve scenes with 
Data-Blocks linked from a blend-file library, it can get very 
time-consuming to save your current scene, track down the 
proper linked blend-file, make your modifications, save, and 
return to your original scene file. This add-on allows you to 
accomplish this process with only a pair of mouse clicks 
(one to get to the linked library and one to resume work on 
your scene). 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Object then Edit Linked Library to enable the 
Script. 


Usage 


Select an object that is been linked from a separate blend- 
file. In the 3D Viewport’s Sidebar, the Edit Linked Library 
panel will show a button labeled Edit Linked Library. Click 
this button to open the blend-file that the active object is 
linked from. 


Once you complete your work to the linked file, return to the 
Sidebar and click the Return to Original File button. 


By default, this add-on automatically saves your current file 
before opening the linked library or returning to the original 


file. This can be disabled using the Autosave toggle in the 
Edit Linked Library panel of the Sidebar. 


Reference 


Category: 
Description: 


Location: 


File: 
Author: 


License: 
Note: 


Object 

Allows editing of objects linked from a 
blend-file library. 

File » External Data, 3D Viewport > 
Sidebar > Item tab 
object_edit_linked.py 

Jason van Gumster (Fweeb), Bassam 
Kurdali, Pablo Vazquez, Rainer Trummer 
GPL 

This add-on is bundled with Blender. 


Grease Pencil Tools 


A set of tools for Grease Pencil drawing. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Object then Grease pencil tools to enable the 
Script. 


Tools 


Box Deform 


Create a deformation box around Grease Pencil strokes. 
Press Ctr1-T to launch the deformation mode. 


The operational scope depends on the mode: 


e Object Mode: the whole Grease Pencil object is 
deformed. 

e Edit Mode: deform the selected points. 

e Draw Mode: deform the last strokes only. 


Shortcuts available during deformation: 


e Spacebar/ Return to confirm. 

e Delete/ Backspace/ Ctrl-T/ Tab (twice) to cancel. 
e Mto toggle between Linear and Spline mode. 
e 1-9 to set the subdivision level of the box. 


e Ctrl-Left/ Ctrl-Right to subdivide the box incrementally 
on the X axis and Ctrl-Up/ Ctrl-Down on the Y axis. 


Rotate Canvas 


Perform a rotation of the view in free navigation or active 
camera in camera view. 


e Maintain ctrl-Alt-mMMB to rotate view (customizable in 
add-on preferences). 

e Click and release immediately to reset view (free 
navigation only). 


Straighten Stroke 


Straighten the stroke between first and last point. The 
influence can be tweaked in the redo panel. 


The scopes for this tool are: 


e Last stroke in Grease Pencil Paint Mode. 
e Selected stroke in Grease Pencil Edit Mode. 


Tip 
Straight Influence Reset 


The influence percentage is stored for next use. Use Shift- 
LMB on the button to reset influence to full. 
Brush Pack Installer 


Install included Grease Pencil textured brush pack (made by 
Daniel Martinez Lara). This is available in Draw Mode in the 


Brushes panel. 


Note 


This feature will be removed once the Blender Asset 
Browser has support for brushes. 


Reference 

Category: Object 

Description: Set of tools for Grease Pencil drawing. 

Location: 3D Viewport >» Sidebar >» Grease Pencil 

File: greasepencil addon folder 

Author: Samuel Bernou, Antonio Vazquez, Daniel 
Martinez Lara, Matias Mendiola 

License: GPL 


Note: This add-on is bundled with Blender. 


Object Color Rules 


Reference 

Category: Object 

Description: Rules for assigning object color (for 
object and wireframe colors). 

Location: Properties >» Object Buttons 

File: object_color_rules.py 

Author: Campbell Barton 

Installation 


e This add-on is bundled with Blender. 

e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Object then Object Color Rules to enable the script. 


Description 


e To Do 


Real Snow 


This add-on allows you to add snow on top of objects. 


The main principle behind this addon is to add a particle 
system of metaballs on top of the selected object and 
transform it to mesh. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 


e Click Object then Real Snow to enable the script. 
Usage 


1. Open the Real Snow tab available in the N sidebar of the 
3D Viewport. 

2. Select objects you want to add snow on top. 

3. Change the parameters and click on the “Add Snow” 
button to generate the snow. 


Note 


e The snow material use microdisplacement to achieve 
realistic result. You need to change the render engine 
to Cycles and Feature Set to experimental in order for 
microdisplacement to be working. 

e You can also add snow only on part of an object by 
selecting the faces in edit mode and activating the 
“Selected Faces” toggle in the panel. 


Parameters 
Coverage ¥ Snow 
Percentage of the area to be _ : 
covered by snow. SS ae 
Height 0.30 
Heig ht Selected Faces 


Height of the snow to apply 
(define the radius of the 
metaballs). 


ok Add Snow 


Selected Faces 
If enabled, only the selected faces will receive snow 
otherwise every face pointing up will be covered by snow. 


Add Snow 
Adds the snow on the selected objects. 
Reference 
Category: Object 
Description: Generate snow mesh. 
Location: 3D Viewport > Properties Panel 
File: real Snow.py 
Author: Marco Pavanello (Wolf), Leon Zandman 
(IZandman), Drew Perttula 
License: GPL 


Note: This add-on is bundled with Blender. 


Scatter Objects 


Reference 

Category: Object 

Description: Distribute object instances on another 
object. 

Location: 3D Viewport > Search 

File: object_scatter folder 

Author: Jacques Lucke 

Installation 


e This add-on is bundled with Blender. 

e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Object then Scatter Objects to enable the script. 


Description 


e To Do 


Skinify Rig 
This add-on creates a mesh object “Skinify Guy” covering an 


armature with a mesh. 


e It works with Rigify: 
e It works with BVH imports: 
e It works with manuelbastionilab add-on: 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Object then Skinify Rig to enable the script. 


Usage 


Select your armature in Pose Mode and skin the selected or 
all bones with a per-bone mesh or whole cover. If bones in 
your rig give unwanted results, often scaling and re- 
positioning the bones in Edit Mode can help. If you are doing 
this to create your own “Skinify Guy”, you can also delete 
bones. It will work with custom shapes but results may vary. 


See also 


Please see the old Wiki for the archived original docs. 


Reference 


Category: Object 


Description: 


Location: 


File: 
Author: 
License: 
Note: 


Creates a mesh object from selected 
bones. 

3D Viewport Pose Mode » Sidebar » 
Create tab 

object_skinify.py 

Albert Makac (karab44) 

GPL 2+ 

This add-on is bundled with Blender. 


Paint 


These add-ons relate to the Paint modes and related tools. 


e Paint Palettes 


Paint Palettes 


Todo. 


See also 


Please see the old Wiki for the archived original docs. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click Paint then Paint Palettes to enable the script. 


Interface 


Located in the 3D Viewport >» Sidebar » Color Palette or 
Weight Palette depending on the mode. Located in the 
Image editor » Sidebar >» Color Palette while in Paint Mode. 


Usage 


Go into any paint mode (Image Painting, Texture Paint, 
Vertex Paint, Weight Paint) and look for the Palette panel 
corresponding to that mode. 


Color Palette 


This add-on can read and write Gimp’s palette format. The 
first thing to do is to determine your “Palettes Folder”. This 
can be the Gimp’s palette folder, or it can be a specific one 
for your project. Select the palette with the select menu. You 
can save your palette with the + button. Add as many colors 
as you need with the + button at the left of the index 
number field. Sample the current brush color with the small 
color wheel button. Select a palette color with the small 
button under the colors. 


Weight Palette 


Select the weight value from the eleven values. These can 
be adjusted with the Weight slider. 


Reference 

Category: Paint 

Description: Palettes for color and weight paint 
modes. 

Location: Image Editor, 3D Viewport Paint Modes » 
Color Palette or Weight Palette panel 

File: paint_palette.py 

Author: Dany Lebel (Axon D) 

License: GPL 


Note: This add-on is bundled with Blender. 


Render 


These add-ons relate to rendering, render engines and 
rendering tools. 


e Copy Render Settings 


e POV-Ray 3.7 
e Freestyle SVG Exporter 


Copy Render Settings 


This is a simple tool that adds in the Render properties a 
new panel with a big Copy Render Settings button, and 
some options to control what to copy, and to which scenes... 


| wrote it as | often have tens of scenes all edited/gathered 
in a single “main” scene sequence. When | want to make 
preview renders of that main scene, | had to manually set all 
other scenes’ preview scale - long and boring. And even 
worse, | often forgot to put them back to full resolution 
before final rendering! 


So, with this add-on, | just have to set the preview scale in 
the main scene, enable or disable Anti-Aliasing, and hit 
Copy Render Settings! 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Render then Copy Render Settings to enable the 
Script. 


Description 


Render Settings 
This lists all render settings. The checkbox to the right 
controls whether that setting will be copied or not. So if 
you want to copy a specific setting, hover your mouse 
over its control, note its Python name (e.g. resolution x 


for the X resolution, etc.), and enable the corresponding 
item in this list. 


Important 


This will only work if you have a Blender patched with 
ui_ template list diff, see Ul Template List 
Enhancement. 


Presets 


The column of buttons to the right of the list are a set of 
presets which set or clear one or more settings at once. 
This will work even without the UI template list patch. 


Set Scale/Clear Scale 
Copy the render scale setting (below resolution 
controls, in Dimensions panel). Highly useful to do 
preview renders! 


Set Resolution/Clear Resolution 
Copy the render resolution and aspect ratio settings. 
Beware of side effects if you modify the aspect of your 
render (e.g. switching from: 4/3 to 16/9...). 


Set OSA/Clear OSA 


Together with Render Scale, this is most useful for 
preview renders. 


Set Threads/Clear Threads 
Copy the settings (auto/fixed, and number) of threads 
used during rendering. Might be useful when e.g. you 
render your blend-files on various computers (even 
though the Auto option should work good in 
general...). 


Set Fields/Clear Fields 


Copy all fields settings. Allows you to easily switch 
from progressive to interlaced... 


Set Stamp/Clear Stamp 


Copy whether to render stamps or not (i.e. the global 
stamp switch setting). 


Affected Scenes: 
Filter Scene 


You can type in this text field a regex (using Python 
syntax), and only scene which name matches this 
regex will be available. Quite useful when you have 
tens of scenes in a file... 


E.g. if you only want to copy some of your current 
render settings to scenes having “rabbit” in their 
name, type .*rabbit.* in this field. 


Columns of buttons 


These toggle buttons represent all scenes of the 
blend-file (optionally filtered through the Fi/ter Scene 
regex), except the current one. Only enabled scenes 
will receive the copied settings! 


Reference 


Category: Render 
Description: Allows to copy a selection of render 


settings from current scene to others. 


Location: Properties » Render tab 
File: render _copy_settings folder 
Author: Bastien Montagne 
License: GPL 


Note: This add-on is bundled with Blender. 


POV-Ray 3.7 


POV-Ray is an SDL based (Scene Description Language) 
render engine with a long history that makes it very stable 
and feature rich. The latest version of POV-Ray 3.7 can be 
found at the project site. 


Features 


Some key features of the exporter include: 


Geometry import and export with their modifiers, keyed 
and physics animation 

Add POV-Ray specific non-mesh primitives (never show 
tessellation) 

Instances 

Hair particles 

Smoke simulations 

Atmospheric media (volume fog) 

HDRI environment mapping 

Aperture depth of field 

Material properties such as filtering, emission, 
translucency, subsurface scattering, glass fog (tinted 
absorption), blurry/glossy reflections... 

Procedural textures (emulated from Blender and POV- 
Ray native) 

Image textures 

Texture influence channels: Alpha, Diffuse, Bump, 
Specular, Mirror (uses same channel as specular) 
Global illumination: Radiosity (indirect lighting), photons 
caustics (reflect/refract), mesh lights 

Custom POV-Ray code input giving access to any POV- 
Ray feature not supported by the exporter. 


POV-Ray 3.7 features 


Volumetrics and media (scattering/absorption), blurry 
reflections (uberPOV), ghosting for motion blur (uberPOV), 
micropolygon displacement (HGPOV), etc. 


Activation 


e Of course, don’t forget to download and install POV-Ray 
itself! 

e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Render then POV-3.7 to enable the script. 


Usage 


Quick Start 


1. Choose POV-Ray 3.7 from render engine selector. Then 
you can render as usual with the Render button. 

2. The image will be rendered according to parameters set 
in the Properties. 


Main global render settings for instance can be changed in 
the Render tab. But there are also properties for 
environment, material (textures), object, etc. all accessible 
in other tabs depending on the selected object (geometry, 
camera, light...). 


POV-Ray Branches 


Below is a comparison of some features of the two engines 
available to this exporter: 


Feature/Engine/Support POV-Ray UberPOV 


Full Soectral Resolution x eae 
Supersampling v v 
Alpha Mapping v v 
Bump Mapping v v 
Normal Mapping x x 
Displacement Mapping x x 
Motion Blur x v 


Subsurface Scattering (SSS) v J 
Volumetric Scattering J ie 
(Medium) 

Y (very 


Ss 


Blurred Reflections tricky) 


Feature/Engine/Support 


Clay Render 


Depth of Field 


Material Layering 


Thin Film Coating 


Dispersion 


Anisotropy 


Thin Film Interference 


Complex IOR Files 


Coating Thickness 
Absorption 


Custom Reflectance 90 


Custom Fresnel Curve 


POV-Ray 


Y (tricky) 


UberPOV 


Y (tricky) 


Feature/Engine/Support 


Sigma Texture 


Sun-Pool Caustics 


Ambient Occlusion 


Lens Shift 


Diaphragm 
Circular/Polygonal 


Per-Object Texture 
Coordinates 


Texture Projection Modes 


Front/Camera Mapping 


Multiple UV Channels 


Texture Tone Mapping 


POV-Ray 


X (tricky) 


Y (tricky) 


Y (tricky) 


UberPOV 


Y (under 


development) 


Y (tricky) 


Y (tricky) 


Feature/Engine/Support POV-Ray UberPOV 


Procedural Textures v v 
Texture Layering "A a 
Synthesis Texture Layering v J 
Point Lighting "4 J 
Mesh Lighting "A J 
Image-based Lighting J J 
Physical Sun/Sky Y (tricky) Y (tricky) 
HDRI Support J J 
IES Texture Support x x 
Instance Support v J 


Resume/Merge Render J ry 


Feature/Engine/Support POV-Ray UberPOV 


Interactive Render J J 


Vignetting / Bloom / Glare 


(Post) Y (tricky) Y (tricky) 
Camera Response Function x x 

(CRF) (Post) 

Color Balance (Post) x x 
Multithreading J J 

Region Rendering J J 
Passive Emitter J J 
Invisible Emitter J J 
Invisible Object J J 
Shadowless Object v v 


Shadowless Point Lights v v 


Feature/Engine/Support POV-Ray UberPOV 


Bucket Rendering v J 


Exported UI Properties 


Render Properties 
Radiosity 


In POV-Ray, “Radiosity” is diffuse interreflection which has 
nothing to do with vertex color based radiosity. In fact, it is 
more similar to final gathering of irradiance samples and 
provides a noise free indirect light. 


Some presets to radiosity are included, their names and 
settings are those of the rad_def include file shipped with 
POV-Ray, they set up the properties so you don’t need to 
include the rad _def.inc in the exported pov-file, it’s one of 
the many examples of what an interface like Blender can 
bring to all POV-Ray users who are not used to have one. 


See also 


More details on POV-Ray Wiki. 


Anti-Aliasing 
Three sampling methods are supported: 


e Non-recursive 


e Recursive 
e Stochastic (Monte Carlo) Only available for UberPOV. 


Sampling Depth 


Values must be comprised between 1 and 9. Higher values 
increase render time and may even introduce some 
undesired blur. 


Anti-Alias Threshold 


In the simple, non-recursive method, POV-Ray initially traces 
one ray per pixel. If the color of a pixel differs from its 
neighbors (to the left or above) by at least the set threshold 
value, then the pixel is supersampled by casting a given, 
fixed number of additional rays. The default threshold is 0.3 
but it may be changed using this Antialias Threshold=n.n 
option. 


See also 


More details on POV-Ray Wiki. 


Tip 
Depth of Field Without Anti-Aliasing 


Using no anti-aliasing when camera depth of field is on will 
speed up rendering and often provide decent enough 
images. 


Bounding Method 


Also called acceleration, it is set to automatic BSP (Binary 
Space Partitioning) by the exporter as it’s generally the 
most efficient (POV-Ray 3.7 only) but other acceleration 
methods are available in POV-Ray. 


See also 


More details on POV-Ray Wiki. 


Command Line Switches 


Some command line arguments can be passed to POV-Ray. 
Arguments are separated by spaces. Command line 
switches consist of a / (Slash), + (plus) or - (minus) sign, 
followed by one or more alphabetic characters and possibly 
a numeric value. 


See also 


More details on POV-Ray Wiki. 


Some Commonly Used Commands: 


-D: Hide image while rendering 
Use this command line switch to not show the rendered 
image in POV-Ray (slightly faster and lighter on memory). 
The image will be sent back to Blender after completion 
(on Linux this is a hidden default switch to avoid OS- 
specific editor problems). 


+wT: Limit the number of threads used 
Limits POV-Ray to using only one single render thread. 
(Likewise, +wT2 would instruct POV-Ray to use two render 


threads.) 


+C: Continue an interrupted render 
For “Continue trace” is able to recover the point at which 
your last render stopped and continue it from there (even 
if you switched off your computer). 


/EXIT: Close POV-Ray after rendering the image 
There is an option in POV-Ray for Windows interface to do 
the same: The “On Completion” option to “Exit POV-Ray 
for Windows” (in the Render menu). 


Tip 
Fast Preview Renders 


When first setting up your scene, and for fast preview 
rendering, turn off anti-aliasing, depth of field, photons, 
Radiosity, expensive material features, and in the scene 
Shading panel, turn off shadows. (Other features might get 
turned off from this panel in future versions of the 
exporter.) 


Alternatively, use the Quality command line switches +q1 to 
+q11. These allow you to easily disable most of the CPU- 
intensive features. 


Formatting 


The exported POV-Ray file can be customized: 


e Different indentation characters to choose from. 

e Option to add comments to POV-Ray file. 

e Option to write long lists of coordinates in one line for 
easier browsing of the pov-file (and slightly faster 


parsing by the renderer). 


Scene Properties 
Color Management 


SRGB is supposed to be always used currently. 


World Properties 
Background 


Blender World gets exported: 


e As POV-Ray background{} if flat colored. 
e Using Blender’s Blend Sky options triggers its export as 
a POV-Ray sky_sphere{}. 


(Sky texture currently appears a little different because of 
its mapping). 


Atmospheric Media 


(To create volume lights): 


e Number of samples for media calculation 
e Atmospheric media color 


Object Properties 


Importance Sampling 


It is a priority value between O and 1 that can be set per 
object in the Object properties tab for Radiosity to cast more 


rays at objects that require them most. Touch this rather 
carefully when trying to improve render times. 


Data Properties 


The script exports sky, lights, hair particles, smoke, fluids, 
meshes, blobs (metaballs). 


Camera 
Depth of Field 


It has to be enabled for below property to act: 


The focal point of depth of field is based on Blender UI 
Distance field, or Object field. 


Aperture 
Sets the blur amount (increase to get more). 
Perturbation 


Normal map for camera plane, native POV procedural 
patterns can be used with variable: 


e Strength 
e Turbulence 
« Scale 


Lights 


No Shadows toggle button can be used to deactivate tracing 
of shadows for specific lights only. 


Tip 
For Realistic Light Attenuation 


Use Inverse square falloff, and a small falloff distance 
value with a higher light intensity will give the best results 


with POV-Ray’s implementation of inverse square law. See 
this discussion. 


Smoke 


A DF3-file (POV-Ray voxel format) is exported and used with 
a POV-Ray media container with the same dimension and 
resolution as Blender smoke domain. 


Hair 
A union of POV-Ray sphere sweep is exported and used for 


each strand. They can take the color of a texture applied to 


emitting object, and shape of sphere sweep tries to emulate 
Shape of strands. 


Material Properties 

Emission 

Tip 

Mesh Lights 

When used together with Radiosity, the Emit property will 


allow you to create light bulbs or any luminous form that 
really illuminates other objects. 


SSS / SSLT 

Note that SSS in POV-Ray (called SSLT) is very sensitive and 
will give different results if the mesh normals are smooth 
shaded or flat. 

Translucency 


Ilumination from the back of a surface. 


See also 


More details on POV-Ray Wiki. 


IOR Mirror 


This option is for using one consistent IOR for ray-traced 
reflection and refraction and not breaking the law of 
conservation of energy between the two. 


lridescence 
(Newton’s thin film coating.) 
Caustics 


e Chromatic dispersion for refractive caustics 

e Fast fake caustics (somewhat like Blender Ray 
Transparency) 

e Refractive caustics using photons 

e Reflective caustics using photons (high IOR or no mirror 
IOR for easier effect.) 


Tip 
Faster Photons 


To set up some caustics, try moving from the smallest 
photon depth value to a minimum at which you start to 
see the effect you are after. Check off the Receive Photons 
object property for any object that does not really need it. 
(A glass object casting caustics often doesn’t need to 
receive any itself.) Then you can balance other parameters 
to tune photons distribution and smoothing (gathering). 
Don’t set the global spacing too fine in scene settings, 
because then you can still make it finer on each object 
using its spacing multiplier. If your system has several 
threads, they can be used in the photons stage: one thread 
per light, so you can then make your scene lighting more 
complex without overhead. 


Shaders 


Emulation is attempted from Blender for: 


Specular and diffuse toon (no edges yet) 

Phong and Cook Torrance (both the same) 

Blinn (not perfectly matched) 

Ward isotropic 

Fresnel and Minnaert, started but not finished yet 


Tip 
Glass Like Materials 
When trying to achieve some glass like material, keep low 


diffuse value, dark or totally black to avoid a dull surface 
and keep a clear transparency. 


Texture Properties 

UV Coordinates 

Best with planar projection for now. (Silvio Falcinelli) 
Texture Channels 

Texture influences currently exported are: Alpha, Diffuse, 
Bump, Specular, Mirror (uses same channel as specular). 
(No other channel because of POV-Ray non-uniform syntax 
for them.) 


Custom Gamma 


For image textures (read POV-Ray 3.7 docs before using 
since it generally needs not be used). 


See also 


More details on POV-Ray Wiki. 


Custom POV Code 


POV-Ray files are not just pure data files (unlike with most 
other renderers). They are programs, with loops, functions, 
etc. This means that no matter how many features this 
exporter could support, POV-Ray will always have much 
more under the hood. 


Step by Step 


You can add custom POV code directly in Blender’s Text 
editor, all you have to do is to make sure this POV code has 
directly or indirectly a #declare keyword, followed by the 
name of your choice and the POV item you want to use. 
(Current POV syntax is closer to C than Python, so anything 
that follows two slash character (//) is a comment.) 


Adding POV Code Directly 


POV items can be anything but for now only the equivalent 
of Blender materials can be replaced with this method. In 
POV-Ray, it is called texture {} don’t get confused, it really 
includes all the material properties. 


Though you can directly specify a texture {} block in POV- 
Ray files, the #declare directive allows to assign it toa 
variable and reuse it more easily. The exporter makes use of 
this feature by default, so you won’t be able to use your 
custom texture, unless you declare it. Here is an example: 


#declare MyTexture = 
texture{ 
pigment{ 
brick color rgb< 0.99, 0.99, 0.99> // color mortar 
color rgob< 0.75, 0,5, 0.305*0.75 // color brick 
brick sizer<0.25,, 0),0525,,°0.125> 7/7 format in xX, Y and 
Z-direction 
mortar 0.01 // size of the mortar 
scale 3 
} // end of pigment 
normal {wrinkles 0.75 scale 0.01} 
finish {ambient 0.15 diffuse 0.95 phong 0.2} 
rotate<0,0,0> translate< 0.01, 0.00, 0.00> 
} // end of texture 


1. Open the Text editor’s Sidebar. 


2. In the text view properties option, you can chose to 
render 3D View and/or text. Enable Both. 

3. Syntax highlight detects pov/inc/mcr/ini extensions. 

4. Some complete POV-Ray scenes are available to 
Templates header menu. 

5. And an Insert menu to add just some POV code snippets 
at cursor’s location. 

6. Then you have to go into the material properties to the 
Custom POV Code field, and just type in the name of 
your declared item to use: “MyTexture” in the example 
given. Then you can render your image normally and 
the material will be replaced. 


Blender and POV-Ray do not have the same coordinates 
systems: POV is Y up while Blender is Z up, so it is to be 
expected that text generated content is not turned the 
Same as exported UI items since the exporter adds a 
transform matrix to all exported entities. So if you want to 
specify orientations more intuitively by looking at the 
interface, some transforms have to be specified at the end 
of your custom blocks, for instance as follows: 


scale <-1, 1, 1> 
rotate <90, 0, -90> 
} 


Adding POV Code from Include Files 


In any POV-Ray scene you can use the #include directive to 
add items from an external POV-Ray file. It’s like the import 
function in Python. The files to be included have .inc as 
their name extension. Then in the replacement field, you 
can type in any of the declared names available in the 
include file. “Out of the box”, POV-Ray ships with a lot of 
include files. So you can use them for your textures, but you 
can also use them for some of their elements. For instance a 


very often used include file is one that allows to call colors 
by their names instead of numbers called colors.inc, so the 
previous example could also be written: 


#include "colors.inc" 
#declare MyTexture = 
texture{ 
pigment{ 
brick color White*0.99 // color mortar 
color rgb= 0.75, 0.5, 0:30>*0.75: 7/7 color brick 
brick size <0.25, 0.0525, 0.125>-// format in x, y and 
z- direction 
mortar 0.01 // size of the mortar 
scale 3 
} // end of pigment 
normal {wrinkles 0.75 scale 0.01} 
finish {ambient 0.15 diffuse 0.95 phong 0.2} 
rotate<0,0,0> translate< 0.01, 0.00, 0.00> 
} // end of texture 


Some other POV-Ray specific objects are also available: In 
POV-Ray a triangle mesh is just one primitive among many. 
You can explore the POV-Ray language by modifying the 
output file and with the same method, add these primitives 
by hand, or you can just pick some from the Add menu. 


POV-Ray Primitives 


The Add menu in the 3D Viewport allows you to add POV- 
Ray specific objects in addition to native Blender objects. 


They are mathematically defined shapes as opposed to 
meshes. The sphere, torus, cylinder or cone side will always 
be round and smooth when rendered, no matter how close 
you get, and regardless of their appearance in the 3D 
Viewport, which is only a proxy. 


These objects are the type of objects that get created when 
you import a POV-Ray file, so that ideally, you could 
“exchange” data back and forth between POV-Ray and 
Blender. 


Infinite Plane 

The rendered plane is actually infinite, but represented by a 
proxy in the 3D Viewport, which is just very big, but still 
finite. Please report if you would rather have a different 
default scale. 


See also 


More details on POV-Ray Wiki. 


Box 


Based on a mesh cube the object can be transformed using 
move/rotate/scale 


See also 


More details on POV-Ray Wiki. 


Sphere 
The sphere has a radius parameter, a location and a scale. 


See also 


More details on POV-Ray Wiki. 


Cylinder 

In POV-Ray, cylinders are defined by radius, base point and 
end point. For convenience, move/rotate/scale can be used 
to the same effect. 


See also 


More details on POV-Ray Wiki. 


Cone 
Cones have a basis radius and end radius. 


See also 


More details on POV-Ray Wiki. 


Torus 
Torus has a main radius and a section radius. 


See also 


More details on POV-Ray Wiki. 


Parametric 


This is a surface generated from the combination of three 
mathematical equations. 


See also 


More details on POV-Ray Wiki. 


Rainbow 
The rainbow is a view dependent effect. 


See also 


More details on POV-Ray Wiki. 


Lathe 

This object behaves like the Blender Screw modifier to 
create surfaces by revolving a spline except instead of being 
tessellated beforehand, it follows the mathematical 


curvature of the spline so you won’t see any polygons no 
matter how close you zoom. 


See also 


More details on POV-Ray Wiki. 


Prism 
This is a POV-Ray primitive that simply extrudes a shape. 


See also 


More details on POV-Ray Wiki. 


Superquadric Ellipsoid 


A quite versatile tool that can provide quick models for 
cushion or star-shaped objects. 


See also 


More details on POV-Ray Wiki. 


Height Field 

This is a displacement of a surface following a texture. 
Tessellation also happens at render time, so you don’t need 
to subdivide anything before. 


See also 


More details on POV-Ray Wiki. 


Sphere Sweep 

This POV-Ray primitive sweeps a sphere a long as spline to 
create an interpolated form that can have variations of 
radius along the spline. It is also used to export hair strands. 


See also 


More details on POV-Ray Wiki. 


Blob Sphere 


Like Blender metaballs. 


See also 


More details on POV-Ray Wiki. 


Ilsosurfaces 


In POV-Ray isosurfaces are objects that can combine and be 
deformed using pigments or equations. 


See also 


More details on POV-Ray Wiki. 


lsosurface Box 
An isosurface component shaped as a box. 


lsosurface Sphere 
An isosurface component shaped as a sphere. 


Supertorus 
An isosurface shaped as a torus with deforming 
parameters equivalent to those of the superellipsoid. 


Parameters (POV-Ray names): 


MajorRadius, MinorRadius 
Base radii for the torus. 


MajorControl, MinorControl 
Controls for the roundness of the supertorus. Use 
numbers in the range [0, 1]. 


Accuracy 
The accuracy parameter. 


MaxGradient 
The max_gradient parameter. 


Macro Based Primitives 


Two primitives are actually macros that generate a mesh 
from curves before render time: 


e Polygon to Circle Blending 
e Loft 


Importing POV-Ray Files 


1. From the same Add menu, you can also import POV-Ray 
files. 

2. Or otherwise, clicking File > Import from the Topbar 
menu. 

3. You can then select one or several files. 


Reference 

Category: Render 

Description: POV-Ray 3.7 integration for Blender. 
Location: Render > Engine » POV-Ray 3.7 
File: render _povray folder 

Author: Campbell Barton, Maurice Raybaud, 


Leonid Desyatkov, Bastien Montagne, 
Constantin Rahn, Silvio Falcinelli 
License: GPL 
Note: This add-on is bundled with Blender. 


Freestyle SVG Exporter 


This add-on can export your Freestyle Renders into an SVG 
file. It can fill contours with their material color and can also 
export SVG animations. 


An example of an SVG result produced by the 
Freestyle SVG Exporter. 


Activation 


This add-on can be enabled via Preferences » Add-ons » 
Render » Freestyle SVG Exporter. The interface for the 
exporter should now be visible as a new panel in the Render 
tab. 


Reference 


Category: Render 


Panel: Properties » Render > Freestyle SVG 
Export 


Usage 


Activate Freestyle rendering and then render your scene 
with Render Image. Your render will be displayed, and the 
SVG version will be saved to the default output path 
Properties » Output > Output. 


Options 
Mode Y Freestyle SVG Export 
Option between Frame re 
. ; Frame Animation 
and Animation. Frame 
will render a single Split at Invisib.. Fill Contours 
frame, Animation will Miter Round Bevel 


bundle all rendered 
frames into a single .svg 
file. 


Freestyle SVG Export panel. 


Split at Invisible 
By default the exporter will not take invisible vertices into 
account and export them like they are visible. Some 
stroke modifiers, like Blueprint, mark vertices as invisible 
to achieve a certain effect. Enabling this option will make 
the paths split when encountering an invisible vertex, 
which leads to a better result. 


Fill Contours 
The contour of objects is filled with their material color. 


Note 


This feature is somewhat unstable - especially with 
animations. 


Stroke Cap Style 
Defines the style the stroke caps will have in the SVG 
output. 


Miter 
Corners with sharp edges. 


Round 
Corners are smoothed. 


Bevel 
Corners are beveled. 


Exportable Properties 


Reference 


Panel: Properties >» View Layers » Freestyle Line 
Style SVG Export 


Because the representation of Freestyle strokes and SVG 
path objects is fundamentally different, a one-on-one 
translation between Freestyle and SVG is not possible. The 
main shortcoming of SVG compared to Freestyle is that 
Freestyle defines style per-point, where SVG defines it per- 
path. This means that Freestyle can produce much more 
complex results that are impossible to achieve in SVG. 


There are extended options for the exporter, located at the 
specific panels of the Freestyle renderer at the View Layers 
tab of the Properties. Those options are located at the 


Freestyle Line Style SVG Export panel, at the bottom of the 
tab. 


The properties (no modifiers applied) that can be exported 
are: 


Base color 
Base alpha 
Base thickness 
Dashes 


Animations 


The exporter supports the creation of SVG animations. 
When the Mode is set to Animation, all frames from a render 
- one when rendering a frame (F12) or all when rendering an 
animation (Shift-F12) - are saved into a single file. Most 
modern browsers support the rendering of SVG animations. 


An SVG animation rendered with the exporter. 


Exporting Fills 


Fills are colored areas extracted from a Freestyle render 
result. Specifically, they are defined by a combination of the 
Contour and External Contour edge type, combined with 
some predicates. The fill result can be unexpected, when 
the SVG renderer cannot correctly render the path that the 
exporter has generated. This problem is extra apparent in 
animations. 


An example of an SVG result produced by the 
Freestyle SVG Exporter. Model by Julien Deswaef. 


Fills support holes and layering. When using layers, the 
exporter tries to render objects with the same material as 
the patch. The exporting of fills and especially the order in 
which they are layered is by no means perfect. In most 
cases, these problems can be easily solved in Inkscape or a 
text editor. 


Rigging 
These add-ons relate to rigging and armatures. 


° Rigify. 


Rigify 
Basics 


e Introduction 
o Main Features 
o Activation 
e Basic USage 
o Basic Rig Generation 
o Advanced Rig Generation 
o Library Linking 
e Bone Positioning Guide 
o Face Bones 
o Jorso Bones 
o Limbs Bones 
o Fingers Bones 
e Generated Rig Features 
o Limbs 


o Head 
o Face 


Customization 


Creating Meta-rigs 
Rig Types 


Extensions 


e Feature Sets 


Development 


Developer documentation is available on the Blender Wiki. 


Reference 

Category: Rigging 

Description: Automatic rigging from building-block 
components. 

Location: Properties » Armature, Bone, 3D 
Viewport > Tools panel, 3D Viewport > 
Add menu » Armature 

File: rigify folder 

Author: Nathan Vegdahl, Lucio Rossi, Ivan 
Cappiello, Alexander Gavrilov 

License: GPL 


Note: This add-on is bundled with Blender. 


Introduction 


Rigify helps automate the creation of character rigs. It is 
based around a building-block approach, where you build 
complete rigs out of smaller rig parts (e.g. arms, legs, 
spines, fingers...). The rig parts are currently few in number, 
but as more rig parts are added to Rigify it should become 
more and more capable of rigging a large variety of 
characters and creatures. 


Rigify also operates on the principle that once a rig is 
created, that rig should no longer need Rigify. This means 
you can always distribute rigs created with Rigify to people 
who do not have it and the rigs will still function completely. 


It is important to note that Rigify only automates the 
creation of the rig controls and bones. It does not attach the 
rig to a mesh, so you still have to do skinning etc. yourself. 


Main Features 


Modular rigging 
Rigify build blocks can be mixed together to rig any 
character you want. If you need to build a character with 
five arms and one leg, Rigify can handle it for you 
creating all the required complex controls system (FK, IK, 
and all the relative snapping tools and the UI) in few 
seconds. 


Nondisruptive re-rig 
If the generated rig doesn’t fit all the features you need 
or, for example, you decide to add something more to 
your character (like a sixth arm or a tail), you can re- 


generate your rig without losing your previously 
generated features and your animation data. 


Advanced and flexible feature set for character animation 
The included rig samples (limbs, spines, tails, fingers, 
faces...) adds to all the stretchy FK/IK features a direct 
deformation secondary layer that lets you flex, bend and 
deform the character as you like through interactive 
Bendy Bones controls. 


Shareable animation through all Rigify rigs 
Since the control system is generated by Rigify, if you 
share a meta-rig through different characters you will be 
able to share data between them even if they have 
different proportions. 


Extendable feature set 
You can save and encode your meta-rigs to a button to 
have them available at any time without recreating it by 
hand or share your meta-rigs with other people. Through 
Python scripting you can also extend Rigify with new 
Rigify-types or new rig samples by implementing your 
own feature set package. 


Ready to go 


Once you generate your rig you won’t need Rigify or any 
other add-on to use it. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 


e Click Rigging then Rigify to enable the script. 


Basic Usage 


Basic Rig Generation 


1. Add a meta-rig structure from the Add » Armature 
menu. 

2. Edit the bone positions to match the character 
geometry. 

3. In the armature properties click on the Generate Rig 
button to generate the rig. 


Add a Predefined Meta-Rig 


Reference 

Mode: Object Mode 
Menu: Add >» Armature 
Shortcut: Shift-A 


Rigify stores all the information required to generate 
complex rig controls and mechanism in more simple 
armatures called “meta-rigs”. 


The predefined meta-rigs can be found in the Add menu. 
Currently available meta-rig types are: 


e Basic Human (doesn’t include face and fingers) 
e Basic Quadruped 
e Human 

e Cat 

e Wolf 

e Horse 


e Shark 


Edit Bone Positions 


To correctly match your character, meta-rig bones must be 
moved to correct positions. This can be achieved in two 
different ways: Pose Mode or Edit Mode. 


Note 


Rigify assumes that 1 unit corresponds to 1 meter. Soa 
human is about 2 units tall. If your character is in a 
different scale and you are more familiar with modeling 
rather than rigging, it is suggested to scale it to Rigify 
dimensions before positioning the meta-rig bones. If you 
want to scale the character’s geometry, we suggest you to 
first scale up the character in Object Mode, then apply the 
geometry scale with the Apply Scale tool. 


Rigify Human Alignment Tips 


e Limbs: Keep the legs as straight as possible in the front 
view (Rigify human works better in predictable cases). 
Give the knee and the elbow a slight bend angle (Rigify 
needs to know where your knee/elbow is pointing). 


e Torso: Keep the spine as straight as possible in the front 
view (Rigify human works better in predictable cases). 
The last bone of the spine is the head. By default the 
next two bones (top to bottom) are considered the neck 
bones. It is suggested to keep the neck bones as aligned 
as possible while editing. 


e Face: Positioning face bones can be tricky if you are not 
an expert in bone editing and they are almost useless if 
you plan to make facial animation through shape keys. 
Consider removing face features from your character if 
they aren’t really needed. If you don’t need the face all 
the face bones can be deleted. All the face bones are on 
the first armature layer by default. You can select them 
by displaying only bone layer 1, selecting all of its 
content and then deleting the bones in Edit Mode to 
correctly remove the face. 


If you want to scale all the face bones at once, consider 
scaling the face master bone in Pose Mode (see Pose 
Mode matching method). The face master bone is 
placed in the same position of the head bone. To select 
it easily, hide all other bone layers. 


For more tips, see the Positioning Guide. 


Pose Mode Matching (Basic) 


Enter the meta-rig Pose Mode. Rotate, scale, and translate 
the bones in the correct position. When bones are in correct 
positions (always staying in Pose Mode) use Apply » Apply 
Pose As Rest Pose. 


Note 


Connected bones cannot be translated in Pose Mode. You 
can scale the parent bones to match the general length 
and then refine child bones scale. For more detailed 
information on armature modes please refer to the 
armatures section. 


Edit Mode Matching (Advanced) 


Some basic armature display setup is suggested before 
entering bone Edit Mode. 


With the meta-rig selected, go in the Properties and click on 
the Object tab. Scroll down to the display panel and enable 
X-ray and under Maximum Draw Type selector select Wire. 
This way the bones will always be drawn in wireframe on top 
of your geometry. 


Then, always in the Properties click on the Armatures tab 
and under display check the Axis checkbox. This way you 
the bones rotation axes will be displayed during the edit 
process. 


For more detailed information on armature display modes 
please refer to the Display panel page. 


Generating the Rig 


With the bones in the correct positions, jump back in Object 
Mode, go to the Armature tab, scroll down to the bottom 
and click on the Generate Rig button to finalize the rig 
creation. The generation process will take from few seconds 
to one minute depending on rig complexity and hardware 
specifications of your machine. If the generated rig needs 
tweaking, you can modify the meta-rig accordingly and then 
click again on the generate button. If the rig already exists, 
Rigify will simply overwrite it retaining all your modifiers and 
constraints and - where possible - all the previously 
generated features. 


For information about additional generation options, see the 
Advanced Rig_Generation section. 


Tip 


If the metarig uses the legacy face rig, you can use the 
Upgrade Face Rig button that appears above Generate Rig 
to automatically upgrade to the new modular face system. 


The upgrade will preserve compatibility with existing 
Skinning, but existing poses and animations will likely not 
be compatible due to subtle changes in control behavior. 


Note 


To make the rig overwriting work as expected, you need to 
have both the rig and the meta-rig visible before 
generating again. Rigify will try to unhide them in simple 
cases, but will abort generation if that fails. 


Warning 


As with all Python add-ons, Blender interface cannot be 
updated until the Python script execution is over. Wait until 
the rig appears to see the results. 


Binding the Geometry to the Rig 


To bind the geometry to the rig you can use your preferred 
tools. Just few things you have to know: 


e All the deforming bones are on the armature layer 30. 

e Eyes and Teeth bones of the legacy face are not 
deforming. You are supposed to bind the eyes and teeth 
geometry through Child Of constraints. 


e Usually armature deform with automatic weights do a 
really good job out of the box if you correctly place your 
bones (and there is enough topology to work with!). 


For more detailed information on armature layers, Armature 
modifier and weight painting refer to the Blender manual. 


Advanced Rig Generation 


Advanced Options Features 


By using options in the Advanced sub-panel, it is possible to: 


e Generate more than one rig per scene. 

e Update/Override a specific rig. 

e Force previously generated widget objects to be 
overwritten. 

e Choose whether to use linked duplicates for left and 
right side widgets. 

e Execute a script data-block after generation. 


Advanced Options Sub-Panel 


Advanced rig generation options are by default hidden in a 
sub-panel. Click on the Advanced line to open it. 


Some of the options will be automatically set by Rigify if 
they have no value when a rig is generated, while others are 
fully controlled by the user. 


Target Rig auto 
This option specifies the generated rig to overwrite when 
re-generating from this metarig. 


If the option is not set, Rigify will generate a new rig 
object and store it in this option. The new object will be 
named based on the name of the metarig according to 
the following rules: 


e If the name contains META, it is replaced with RIG. 
e If the name contains metarig, it is replaced with rig. 
e Otherwise, RIG- is prepended to the name. 


When overwriting an existing rig object specified by the 
option, its name is not changed, allowing it to be freely 
renamed if the default naming scheme doesn’t fit. 


Note 


When the option isn’t set, Rigify will create a brand new 
rig object even if an object with a matching name 
already exists. 


Rig Ul Script auto 


This option specifies the generated script datablock to 
overwrite when re-generating, and works in the same 
manner as Target Rig. 


The script controls the UI in the 3D Viewport that allows 
conveniently switching visible bone layers, changing 
custom properties, converting between IK and FK and so 
on. 


Widgets Collection auto 


This reference specifies the collection containing 
generated widgets, and works in the same manner as 
Target Rig. 


Force Widget Update 


If enabled, Rigify will generate new widgets every time 
the rig is re-generated. By default, it tries to reuse the 


already generated widget objects that exist in the widget 
collection, allowing them to be manually edited to fit the 
character better. 


Mirror Widgets 
When enabled, Rigify generates widgets for left and right 
side bones as linked duplicates, using negative X scale to 
flip the right side version. This enforces symmetry and 
reduces the number of meshes to adjust to fit the 
character. 


When reusing an already generated widget, Rigify 
detects if it was originally generated mirrored by 
checking object scale to avoid flipping existing controls. 
Therefore switching to mirrored widgets for an existing 
character requires deleting the right side widgets, or 
Force Widget Update. 


Run Script 
It is possible to configure Rigify to execute a Python 
script contained in a text data-block after generation in 
order to apply user-defined customizations. The script is 
executed with the generated rig active and selected in 
Object Mode. 


The simplest use of this may be adjusting properties of 
generated constraints when Rigify rig types don’t have 
any relevant meta-rig settings. That can be done by 
using the Copy Full Data Path context menu option on 
the property, pasting it into the script and making an 
assignment, e.g.: 


import bpy 


bpy.data.objects["rig"].pose.bones["MCH- 
Spine.003"].constraints[0].influence = 0.6 


Doing such changes via a script ensures they aren’t lost 
if the rig is re-generated. 


Users familiar with Rigify scripting can import Rigify 
utility modules, and access the generator instance 
through rigify.get_generator(). Yet note that, since 
generation is already finished, the only use of that is 
reading data created in the generation process. 


Library Linking 


When linking a rig into another file, you generally want to 
create a collection that includes the generated rig and the 
character mesh. You do not need to include the meta-rig or 
the widget object collection. You then link in the collection 
and run Make Library Override. 


The rig ui _template.py text data-block responsible for the rig 
UI will be automatically linked along with the rig, you don’t 
need to link it separately. However, the script will not run 
until you run it manually from the Text editor or save and 
restart Blender. 


Bone Positioning Guide 


Face Bones 


Start by identifying basic face landmarks to follow as guide 
for bones placement. 


Basic Face Landmarks. 


e Orange lines represent bones that should be placed in 
closed loops. 

e Yellow lines represent bones whose position depends on 

surrounding bone loops. 

Red lines represent outer edge bones. 

Purple lines represent bridging bones used to cover 

deforming flesh. 
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Eyes-Nose Landmarks. 


The eyes-nose loop area is split in different parts identified 
by bone names. Follow the image to place the bones. 
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Eyes-Nose Bone Positions. 
Tip 


Brow Placement 


Keeping aligned the mid bones in “brow”, “brow.b”, “lid.t”, 


“lid.t” and cheek will give better results after rig 
generation. 
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Jaw-Ear Bone Positions. 


Also the jaw-ear area is split in different parts identified by 
bone names. Follow the image to place the bones. 


Tip 
Jaw Placement 


Try to place “ear.L’ bone covering the part of the ear 
attached to the mandible (lower jaw). Do the same with 
temple bone trying to cover the part you don’t want to 


move with the jaw, this way you will also determine the 
jaw pivot position. 
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Lips Merge Point. 
Warning 


While moving the face bones it is necessary to preserve 
merge points, i.e. whenever heads or tails of two or more 
bones overlap at the same point, they should still do so 
after repositioning. Tearing a merge point apart may result 
in multiple controls being created instead of one, or even 
the generation of errors. 


* COMPRESSION AREA 


Face Stretcher Bones. 


After the main face bones are placed use the cheek bone to 
connect the eye-nose area to the jaw mouth area. Then do 
the same with the brow area. This process will automatically 
define face muscles compression areas. 


Position the eye bones in the eye pivot point facing right 
toward the face on the Y axis. The length of the eye bones 
should correspond to the radius of the eye. 
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Eyes Pivot Position. 
Tip 
Eye Pivot 


If your eye has a spherical shape you can define its pivot 
by entering Edit Mode. Select two opposite vertices on the 
center meridian - or the opposite poles - and snapping the 
cursor to selection by pressing Snap » Cursor To Selected. 
If your eye is a complete sphere and its location it’s not 
applied, then you can just use its center of mass. 


Finally position the teeth bones on your teeth geometry and 
the tongue bone chain as described in the figure. 
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Mouth and Teeth Positions. 
Tip 
Tongue 


The tongue will work better if the bones are aligned at the 
symmetry line. 


Before generating the rig ensure the face master bone is 
facing upward. 


Torso Bones 


Start by identifying on your character basic torso zones to 
follow as guide for bones placement. 


Head, chest and pelvis are rigid zones, so they require less 
bones. Having a good edge loop placement around zone 


boundaries on your model will help in having correct 
deformation after armature binding. 


Torso Landmarks. 


Starting from the side view, place the main spine bones 
trying to use one bone for the rigid areas and two for the 
flexible ones. In addition to the main spine, the torso is 
provided with additional pelvis bones (to oppose the leg 
bending), two breast controls and two shoulder bones. 


Even if the pelvis bones will not appear in the final rig as 
controls, they will contribute to deformation. 
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Torso Bones Positioning. 
Tip 
Bone Placement 


Try to keep the spine as centered as possible inside the 
mesh bounding volume, just apply a slight offset toward 
the back. In a similar way, consider the shoulder bones as 
general deformers; placing it too forward - where the collar 
bone should be - could cause undesired deformations. 


Limbs Bones 


While placing the arm bones try to start having a straight 
line that goes from the shoulder to the hand in both front 
and top view. After this is done just add a slight bend to the 
elbow. This can be easily done by going in the top view, 
entering armature Edit Mode and sliding the bone junction 
between forearm and upper_arm slightly toward the world’s 
Y axis. 
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Arm Bones Positioning. 


For the leg you can follow a similar process. Start by 
aligning the leg bones creating a straight line from the hips 
to the ankle, then place the foot and the toe accordingly. 
Remember to add a slight bend to the knee. This can be 
easily done by going in the side view, entering armature 


Edit Mode and sliding the bone junction between thigh and 
shin slightly toward the world’s Y axis. 
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Leg Bones Positioning. 


Finally align the heel bone by going in the front view and 
placing the head and tail to fill the foot size from side to 
side. Then, in the side view, align the bone at the point 
where the heel just touches the ground floor. 


Note 


From version 0.5 and above there is no more need of 
manual bone rolls alignment. The generate function will 
take care of that for you by evaluating it from bend axis; 
just insert a slight bend in your limb and it’s done! If you 


need more control on the orientation, follow the guidelines 
described in Advanced Usage. 


Fingers Bones 


Start by placing, finger by finger, all the knuckles in place. 
Tip 

Fingers Placement 

An easy and effective method to do this operation is to 
select on the mesh the corresponding edge loop in Edit 
Mode and use the Cursor to Selection snap. Then you can 


Snap the bone to the corresponding loop using the 
Selection to Cursor snap. 


KNUCKLE EDGE LOOP 


Knuckles Edge Loops and Cursor Snapping. 


Finalize the positioning by taking care of bone rolls (the X 
axis is set as bend axis). 

Tip 

Bone Roll 


Finger axis alignment can be easily be made consistent by 
selecting all the finger bones and recalculating the bone 
rolls Recalculate Roll » Global -Z Axis. 


Thumb may require more tweaking depending on your 
character’s mesh topology, usually Recalculate Roll > 
Global +Y Axis is a good starting point. 


Once your bone rolls are consistent, try generating the rig 
and scaling the finger master controls. This should cause 


the fingers to curl. If they are rotating on the wrong axis, 
change the Bend Rotation Axis parameter on the first 
finger’s parameters under Rigify Type. 


BEND AXIS 


Fingers Bend Axis. 


When the fingers are in place proceed placing the palm 
bones. 
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Palm Alignment. 
Tip 
Palm Placement 


Try to keep palm bones’ heads at a little distance between 
each other. This distance is required for Rigify to define the 
palm controls hierarchy. Palm axis alignment can be easily 
done by selecting all the palm bones and recalculating the 
bone rolls Recalculate Roll » Global -Z Axis. 


See also 


For more detailed information on bones and rolls refer to 
the Bone Structure and Bone Roll. 


Generated Rig Features 


After human rig generation a new armature named rig will 
be added to your scene. This is the character rig you have 
generated from the human meta-rig and will contain all the 
features. 


Limbs 


Each limb will have a gear widget at its base. This is the 
utility bone that contains all the sub-rig properties. The rig 
features will be displayed anyway when the affected bone is 
selected but if you are looking in the Graph editor for those 
properties’ animated values, this is most likely the bone to 
look at. 


Depending on the user defined meta-rig options, multiple 
deform bone segments will be created. Each bone can be 
controlled by tweak controls placed at the respective bone’s 
head/tail. Tweaks are subordinate to the general IK or FK 
limb position but can be moved apart, twisted and scaled 
freely, even reaching virtually impossible limb shapes. 


Rigify’s limbs have the following controls in the Sidebar 
panel: 


FK Limb Follow Slider 
When set to 1 the FK limb will not rotate with the torso 
and will retain is rotation relative to the root bone 
instead. 


IK-FK Slider 


Controls whether the limb follows IK / Rig Bake Settings 


or FK controls, blending between SR ph nn rere 
full IK at O and full FK at 1. 6 
IK<->FK Snapping Buttons / Rig Main Properties 

To snap one type of controls to FK Limb Follow 0.000 
another use the appropriate IK-FK (hand.L) 0.000 
buttons. 9 = FK->IK (hand) 

‘+ Action € Clear 
Each snap direction has buttons to 9 K->FK (hand) 
update just the current pose, bake *y Action = Clear 
the whole animation in the current Ik Stretch 1.000 
Action, or Clear keyframes instead <3} Toggle Pole : 
of snapping. The buttons dealing oun hae 


with keyframes use options from an orm ag RT 
additional panel to control the 
range of frames to bake. 


IK Stretch Slider 
Blends between the limb stretching freely at 1, or having 
its maximum length constrained at 0. 


Toggle Pole Switch 
When set to 0 the IK limb will use the rotational pole 
vector (the arrow at the base of the limb). 
Rotating/translating/scaling the arrow will control the IK 
limb base. When set to 1 the classic pole vector will be 
displayed and used to orient the IK limb. The arrow will 
continue to handle the scale and the location of the IK 
limb base. 


Similar to IK-FK Snapping, the row includes buttons to 
convert the current pose between types, or bake the 
whole action. 


IK Parent Switch 


Switches the effective parent of the main IK control, with 
different integer values corresponding to choices from a 
list. 


The row includes buttons that allow converting the 
current pose via choosing from a menu, or baking the 
whole action. 


Pole Parent Switch 


Switches the effective parent of the classic IK Pole 
control. 


Head 


Neck Follow Slider 
This slider controls the rotations isolation for the neck 
bones. When set to 0 the neck will stay oriented as the 
Torso (the big box control). When set to 1 the neck will be 
oriented as the Chest (the big circle in the shoulder 
area). 


Head Follow Slider 
This slider controls the rotations isolation for the head. 
When set to 0 the head will stay oriented as the Torso 
(the big box control). When set to 1 the head will be 
oriented as the neck. 


Face 


Mouth Lock Slider 
This slider controls the mouth opening. When set to 0 
moving/rotating the jaw bone will result in mouth 
opening, when set to 1 the lips will stay sealed while the 
jaw is moving. 


Eyes Following Slider 
This slider controls the eyelid automation. When set to 1 
the eyelids and the lower eyebrow will follow the eye 
movement giving a realistic effect to the character, when 
set to 0 no automation will happen. 


Creating Meta-rigs 


H 


. Add a single bone from the Add » Armature menu. 
. Go in armature Edit Mode and build the meta rig by 


samples or Rigify-types. 


. Define Rigify layers, bone grouping and selection sets. 
. In the armature properties click on the Generate button 


to generate the rig. 


How Rigify Works 


Rigify Meta-Rigs are split in multiple Sub-Rigs 


A meta-rig is an assembly of bone chains. A bone chain is 
identified by the Connected attribute. Bone chains can be 
further connected together by parenting them without 
using the Connected attribute (i.e. using the Keep Offset 
option while parenting). 


A custom attribute is set on the first bone of the sub-rig 
chain 


Each first bone of a bone chain has a custom attribute on 
it which is a Rigify custom property that identifies the 
sub-rig type. At rig generation time Rigify will determine 
which controls and deform bones will be created 
processing the meta-rig from the first bone to the last of 
each chain. 


Human meta-rig split by samples. 


New meta-rigs are created assembling sub-rigs samples 
Since a meta-rig is just a collection of sub-rigs, new 
meta-rigs can be built assembling sub-rigs in different 
ways. This way an infinite number of meta-rigs can be 
built from the same rigging blocks. 


Human meta-rig split by samples. 


All the mechanics, deformation bones and widget are 
created on a single click 
The meta-rig contains more information than the 
visualized bones. In fact at generation time Rigify will 
identify each sub-rig type and depending on the selected 
options will create all the sophisticated controls, 
switches, and deforming bones with a single click. 


Creating a new Meta-rig 


Add a new Armature Object 


Reference 

Mode: Object Mode 

Menu: Add » Armature » Single Bone 
Shortcut: Shift-A 


Building your own meta-rig from scratch requires an 
armature object to work with. Just add a single bone from 
the Add menu. 


Tip 


At this stage naming the newly added armature “meta-rig” 
IS a good idea. You can do it at any time (or not at all) but 
it’s suggested to do it before going on so it will always be 
clear on which armature you have to work when editing 
the meta-rig structure. 


Editing the Armature 


Now that there is an armature object to work - with the 
armature selected - enter armature Edit Mode. Building a 
meta-rig from scratch in Edit Mode can be done in two ways: 


1. Adding rig samples. 
2. Creating bone chains. 


Adding Samples (Basic) 


Adding samples in Edit Mode is a good way to start building 
a meta-rig. This way you can become familiar with the 
available building blocks and how they are meant to be 
used. To add a rig sample: 


1. Go in the armature tab. 

2. Scroll down to Rigify panel. 

3. Select a sample from the list. 

4. Click on the Add sample button. 

5. Edit the bone positions to match your character. 


For the list of available samples, see the Rig_ Types page. 
Using Rig Types (Advanced) 


1. Create your bone chains in Edit Mode. 
2. Assign the correct rig type to the first bone of each 
chain in Pose Mode. 


Note 


Each sub rig has a required number of bones as input. If 
you are unsure on how to use rig-types properties, add a 
rig sample to your armature to see how it is supposed to 
be used. 


Custom Root Bone 


If the meta-rig contains a bone called “root”, it is used as 
the root control bone instead of creating a new one. This 
allows changing the rest position of the root bone, assigning 
a custom widget, or adding custom properties to the bone. 


The custom root bone must have no parent, and use the 
basic.raw_copy sub-rig type or none. 


Layers, Bone Groups & 
Selection Sets 


Armature Layers are usually used to isolate bones. Rigify 
can take advantage of armature layer to generate extra 
features and the user interface for the final rig. Rigify layers 
are displayed in a vertical layout inside their own separate 
panel named Rigify Layer Names. 


e The first column shows the layer number. 
e The second column is a display toggle. 


This toggle controls the armature layer visibility. It has 
the same effect of enabling/disabling the layer visibility 
from the top armature layers menu. It is just redrawn 
here for a simplicity. 


e The third column sets a specific layer name to be used 
to build the rig UI of the final rig. If set, a button with the 
specified name will be created in the rig ui template to 
control the visibility of this specific armature layer. If 
layer contains at least one bone but its name field is 
empty, a button with no name will be created in the rig 
Ul. 


The fourth column defines in which UI row the layer 
button will be created. 


This numbers define the layer ordering in the UI and will 
ignore the effective layer number. If two layer have the 

Same row number their UI buttons will be created in the 
same row. 


e The fifth column is a toggle for the selection set. 


If checked a selection set with that name will be created 
and associated to the final rig. 


e The sixth column defines the Rigify Bone Grouping. 


If Rigify Bone Groups are set, the user can make the 
association between the bones on the layer and the 
specified bone group from the list. The controls on the 
final rig will inherit the bone grouping through this 
value. 


e The seventh column displays - if set - the associated 
bone group name. 


In order to use the Bone Groups in the Rigify Layer Names 
fields, Rigify Bone Groups must be set through the specific 
panel. Usually this panel is displayed just above Rigify Layer 
Names panel. 


Rigify Bone Groups are used to define bone colors on the 
final rig. The top two rows of the Rigify Bone Groups panel 
are used to define the bone colors general behavior. Usually 
color themes use a gradient of colors to define the different 
bone states: default, selected and active. When multiple 
color themes are used in the same rig, identifying which 
bone is selected or active can be tricky since each color will 
have its corresponding state. 


To override this behavior Rigify Bone Groups unifies the 
active and selected states with the same color. This is 
defined by two values: 


Unified Selected/Active Colors 
When this option is active adding a bone group in the list 
will always keep the colors consistent. When a color 
scheme is added as from a theme, the color scheme is 
loaded as is. Click on the Apply button to force the 
system to unify selected and active colors. 


Selected/Active Colors 
This two color fields define respectively Selected and 
Active colors. By default Rigify reads this colors from the 
theme defined by the user in the Blender preferences. 
This way the Selected/Active colors can always have a 
predictable and consistent behavior in the Ul. The colors 
can be customized by clicking on the relative color field. 
To reset them to the Blender current theme value just 
click on the button with the update icon. 


Bone Groups can be added and deleted as done in the 
general Bone Group panel by clicking on the + or - buttons. 
All Bone Groups can be deleted at once by clicking on the 
Specials menu. 


To add the predefined Rigify Default Bone Groups list click 
on Add Standard button. 


To add a specific theme with its own color scheme, select it 
from the list and click on the Add From Theme button. 


Rig Types 


Rig types are components used by Rigify to process specific 
parts of the meta-rig when generating the armature. They 
represent common character features, like the spine, limbs, 
fingers etc. 


Note 


The list of available rig types appears in the Bone 
properties tab when the bone is selected in Pose Mode. 
Scroll down the Properties to find Rigify Type panel. 


This documents rig types that are bundled with Rigify. 


e Basic 

o basic.copy_chain 

o basic.pivot 

© basic. raw_copy 

© basic.super_copy 
e Spines 

© spines.super_spine 
e Limbs 

© limbs.simple_ tentacle 
Limbs.super_finger 
Limbs.super_lLimb 
Limbs.arm 
Limbs .leg 
Limbs. paw 
Limbs. front_paw 
Limbs.rear_paw 
Limbs.super_palm 
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o faces.super face 


© skin.basic chain 

© skin.stretchy chain 
© skin.anchor 

© skin.glue 

© skin.transform. basic 
Ce 


o face.basic tongue 
o face.skin eye 
o face.skin jaw 


Basic 


These rig types are used to generate simple single-bone 
features, and for custom rigging done directly in the meta- 
rig. 


The single-bone rig types must be applied separately to 
every bone even within a connected chain, and can have 
connected children controlled by a different rig type. This is 
unlike chain-based rig types that usually consume the whole 
connected chain. 


basic.copy_ chain 


Copies the bone chain keeping all the parent relations within 
the chain untouched. Useful as a utility rig type for custom 
rigs. 


Requirement: A chain of at least two connected bones. 


Control (Boolean) 
When enabled control bones and widgets will be created. 


Deform (Boolean) 
When enabled deform bones will be created. 


basic.pivot 


Single-bone rig type that creates a ‘custom pivot’ control for 
rotating and scaling its child sub-rigs. 


This type of control transforms its children when rotated or 
scaled, while moving it merely changes the pivot point used 
by rotation or scaling. 


Master Control 


When enabled an extra parent control bone with a box 
widget is created to allow moving the rig. It is also 
required by all other options besides Deform Bone. 


Widget Type 
Allows selecting one of the predefined widgets to 


generate for the master control instead of the default 
cube. 


Switchable Parent 


Generates a mechanism for switching the effective 
parent of the rig based on the value of a custom 
property. 


Register Parent 


Registers the rig as a potential parent scope for its child 
Sub-rigs’ parent switches. 


Tags 
Specifies additional comma-separated tag keywords 
for the registered parent scope. They can be used by 
other rigs to filter parent choices, or for selecting the 
default parent. 


Some of the existing tags that are useful here: 


injected (special) 
The parent scope will be made available for all 
children of the parent sub-rig, rather than just this 
rig’s children. 


held object 
A control for the object held in the character’s 
hand. Preferred by finger IK. 


The injected,held object combination is perfect for 
such a control. 


Pivot Control 
Disabling this avoids generating the actual custom pivot 
control, effectively turning this rig type into a version of 
basic.super_copy with parent switching support and a 
different widget. 


Deform Bone 
When enabled a deform bone will be created. 


basic.raw_copy 


Single-bone rig type that copies the bone without the orc- 
name prefix. 


Normally all bones copied from the meta-rig are prefixed 
with orG- and placed on an invisible layer. This precludes 
their use as controls or deforming bones, which makes it 
difficult to transfer complex fully custom rigging verbatim 
from the meta-rig. 


This rig type does not add the automatic prefix, thus 
allowing an appropriate ORG-, MCH- or DEF- prefix to be 
manually included in the meta-rig bone name, or 

alternatively using no prefix to create a control bone. 


Relink Constraints 
Allows retargeting constraints belonging to the bone to 
point at bones created in the process of generating the 


rig, thus allowing custom rigging to integrate with 
generated bones. 


To use this feature, add @ and the intended target bone 
name to the constraint name, resulting in the 

...@bone name syntax. After all bones of the rig are 
generated, the constraint target bone will be replaced. If 
the new bone name is just CTRL, MCH or DEF, this will just 
replace the orc prefix in the existing target bone name. 
For the Armature constraint you can add a e suffix for 
each target, or just one @CTRL, @MCH Or @DEF suffix to update 
all. 


Parent 
If the field is not empty, applies the same name 
substitution logic to the parent of the bone. 


When this feature is enabled, the bone will not be 
automatically parented to the root bone even if it has no 
parent; enter root in the Parent field if that is necessary. 


basic.super_copy 


Single-bone rig type that simply copies the bone. Useful as 
utility rig type for adding custom features or specific deform 
bones to your rigs. 


Control (Boolean) 
When enabled a control bone and widget will be created. 


Widget (Boolean) 
When enabled a widget will be created in replacement to 
the standard. 


Widget Type (String): 


Allows selecting one of the predefined widget types to 
generate instead of the default circle. 


Deform (Boolean) 
When enabled a deform bone will be created. 


Relink Constraints 
Works the same as in the basic.raw_copy rig. In addition, 
when enabled any constraints that have names prefixed 
with CTRL: are moved to the control, and with DEF: to the 
deform bone. 


Spines 


These rigs are used to generate spine structures, including 
the head and tail. 


Spines.super_ spine 


Will create a complete bendy and stretchy b-bones spine 
system based on bone numbers of your bone chain and user 
defined options. 


Requirement: A chain of at least three connected bones 
(base system). 


| © spines.super_spine | super_spine 


Spine required bones. 


Pivot Position (integer) 
Defines the pivot position for torso and hips. 


Head (Boolean) 


When checked neck and head systems will be added to 
your spine rig. 


Neck Position (integer) 
Defines the bone where the neck system starts. The 
last bone will always be the head system. If neck 
position is the last bone of the chain, then only the 
head system will be created ignoring the neck. 


Tail (Boolean) 
When checked tail system will be added to your spine rig. 


Tail Position (integer) 
Defines the bone where the tail system starts. The 
next bone will always be the hips system. 


* spines.super_spine 


Spine default bones. 


Spine with tail bones. 


Limbs 


These rig types handle generation of different kind of limbs 
and their features, like fingers. 


Limbs.simple_ tentacle 


Will create a bendy and stretchy b-bones tentacle chain or 
automatic bendy and stretchy finger controls. 


Requirement: A chain of at least two connected bones. 


Automation Axis (X, Y, Z, None) 
Enables the automation on the selected axis. Multiple 
axis or none can be selected holding Shift-LMB. When 
enabled the controls of the last bones will copy the 
rotations from the previous ones. The option is accessible 
in the controls of the final rig as a Copy Rotation 
constraint and can be disabled even after rig is 
generated, or at animation time. 


Assign Tweak Layers 
If enabled, allows placing the Tweak controls on different 
layers from the main controls. 


Limbs.super_finger 


Will create a bendy and stretchy chain or automatic bendy 
and stretchy finger depending on a master control bone. 


Requirement: A chain of at least two connected bones. 


Bend Rotation Axis (Automatic, X, Y, Z, -X, -Y, -Z) 
Defines the automatic rotation axis to be linked to the 
scale of the master bone. 


B-Bone Segments (integer) 


Defines the number of b-bone segments each tweak 
control will be split into. 


IK Control 


Generates a very simple IK mechanism with only one 
control. 


IK starts its work with the shape of the finger defined by 
FK controls and adjusts it to make the fingertip touch the 
IK control. It is designed as a tool to temporarily keep the 
fingertip locked to a surface it touches, rather than a fully 
featured posing system. 


Assign Tweak Layers 


If enabled, allows placing the Tweak controls on different 
layers from the main controls. 


Note 


Rotation Axis (Bend Rotation Axis in the case of 
limbs.super finger) affects the roll of the generated bones. 
Automatic mode recalculates the generated bones roll 
while any of the Manual modes copy the roll of the meta- 
rig bones. 


Limbs.super_1limb 


A backwards compatibility wrapper around limbs.arnm, 
limbs.leg and limbs. paw. 


Limbs.arm 


Will create a full featured bendy and stretchy arm 
depending on the user-defined options. 


Requirement: A chain of three connected bones (upper_arm, 
forearm, hand). 


e limbs.super_limb 


Arm ¢ 


Arm required bones. 


IK Wrist Pivot 
Generates an extra child of the hand IK control that 
rotates around the tail of the hand bone. 


Rotation Axis (Automatic, X, Z) 
Defines the bend axis for the IK chain. FK chains will have 
a totally free degree of rotation on all axes. 


Limb Segments (integer) 
Defines the number of additional tweak controls each 
limb bone will have on the final rig. 


B-Bone Segments (integer) 
Defines the number of b-bone segments each tweak 
control will be split into. 


Custom IK Pivot 
Generates an extra control for the end of the IK limb that 
allows rotating it around an arbitrarily placed pivot. 


Assign FK Layers 
If enabled, allows placing the FK chain on different layers 
from the IK bones. 


Assign Tweak Layers 
If enabled, allows placing the Tweak controls on different 
layers from the IK bones. 


Limbs.leg 


Will create a full featured bendy and stretchy leg depending 
on the user-defined options. 


Requirement: A chain of four connected bones (thigh, shin, 
foot, toe) with one unconnected child of the foot to be used 
as the heel pivot. 


Leg required bones. 


Foot Pivot (Ankle, Toe, Ankle & Toe) 
Specifies where to put the pivot location of the main IK 
control, or whether to generate an additional pivot 
control at the base of the toe. 


Separate IK Toe 
Specifies that two separate toe controls should be 
generated for IK and FK instead of sharing one bone. This 
is necessary to get fully correct IK-FK snapping in all 
possible poses. 


Rotation Axis (Automatic, X, Z) 
Defines the bend axis for the IK chain. FK chains will have 
a totally free degree of rotation on all axes. 


Limb Segments (integer) 
Defines the number of additional tweak controls each 
limb bone will have on the final rig. 


B-Bone Segments (integer) 


Defines the number of b-bone segments each tweak 
control will be split into. 


Custom IK Pivot 
Generates an extra control for the end of the IK limb that 
allows rotating it around an arbitrarily placed pivot. 


Assign FK Layers 
If enabled, allows placing the FK chain on different layers 
from the IK bones. 


Assign Tweak Layers 
If enabled, allows placing the Tweak controls on different 
layers from the IK bones. 


Limbs. paw 


Will create a full featured bendy and stretchy paw 
depending on the user-defined options. 


Requirement: A chain of four or five connected bones (thigh, 
shin, paw, optional digit, toe). 


e limbs.super_limb 


Front/Rear paw required bones. 


Rotation Axis (Automatic, X, Z) 
Defines the bend axis for the IK chain. FK chains will have 
a totally free degree of rotation on all axes. 


Limb Segments (integer) 
Defines the number of additional tweak controls each 
limb bone will have on the final rig. 


B-Bone Segments (integer) 
Defines the number of b-bone segments each tweak 
control will be split into. 


Custom IK Pivot 
Generates an extra control for the end of the IK limb that 
allows rotating it around an arbitrarily placed pivot. 


Assign FK Layers 
If enabled, allows placing the FK chain on different layers 
from the IK bones. 


Assign Tweak Layers 
If enabled, allows placing the Tweak controls on different 
layers from the IK bones. 


Limbs. front_paw 


Derivative of limbs.paw with extended IK suitable for use in 
front paws. The additional IK limits the degree of change in 
the angle between shin and paw bones (2nd and 3rd) as the 
main IK control moves and rotates. 


For best results, the shin bone should not be parallel to 
either thigh or paw in rest pose, i.e. there should be some 
degree of bend in all joints of the paw. 


Heel IK Influence 
Influence of the extended IK. At full rotating the main IK 
control or digit bone would not affect the rotation of the 
paw bone, while lower values provide some blending. 


Limbs.rear_paw 


Derivative of limbs.paw with extended IK suitable for use in 
rear paws. The additional IK tries to maintain thigh and paw 
bones (1st and 3rd) in a nearly parallel orientation as the 
main IK control moves and rotates. 


For best results, thigh and paw bones should start nearly 
parallel in the rest pose. 


Limbs.super_palm 


Will create a palm system based on the distance between 
palm bones. 


Requirement: At least two bones child of the same parent. 
The property has to be set on the inner palm bones (think it 
as index’s metacarpus), the rig control will appear on the 
last palm bone (think it as pinky’s metacarpus). 


Both Sides 
Generates controls on both sides of the palm, with 
influence on inner bones blended between them. 


Primary Rotation Axis (X, Z) 
Defines the automatic rotation axis to be used on the 
palm bones. 


Faces 


faces.super_ face 


Will create a face system based on the bones child to the 
parent that has the property set on it. 


Requirement: All the face bones bundled in the 
faces.super_ face Sample had to be present and child of the 
master bone that has the Rigify-type face property set. 


Note 


This rig type is being deprecated in favor of a new modular 
skin and face rigging system. 


Skin 


These rigs implement a flexible system for rigging skin 
using multiple interacting B-Bone chains. This is developed 
as the base for a new modular Rigify face rig. These are the 
main ideas of the system: 


Generic B-Bone Chain 
One core idea of the system is that most of the 
deformation should be implemented using a standard 
powerful B-Bone chain rig. These chains support 
advanced behavior by interacting with other rig 
components. This is in contrast to having multiple 
domain-specific rigs that each generate their own deform 
chains. 


The implementation provides two versions of the chain 
rig: Skin.basic_chain merely attaches B-Bones to the 
controls with no automation added to the controls 
themselves. The skin.stretchy_chain rig in addition 
interpolates motion of the end (and an optional middle) 
controls to the other controls of the chain. 


Automatic Control Merging 
The deformation part of the system consists of chains of 
one or more B-Bones connecting control points (nodes). 
Whenever controls for two chains would completely 
overlap, they are automatically merged. 


For each merged control, one of the chains is selected as 
the owner, based on heuristic factors like parent depth 
from root, presence of .T/.B .L/.R Symmetry markers, and 
even alphabetical order as the last resort. This can be 


overridden by an explicit priority setting in cases when it 
guesses wrong. 


The owner and its parents determine additional 
automation that is placed on the control. As a special 
case, if a control is merged with its .T/.B .L/.R symmetry 
counterparts (detected purely by naming), the 
automation from all of the symmetry siblings of the 
owner is averaged. 


Parent Controllers 
Rather than simply using the parent meta-rig bone (ORG) 
as parent for controls and chain mechanisms, the new 
system includes an interface for parent rigs. It explicitly 
provide parent bones and generate control parent 
automation mechanisms for their child chain controls by 
inheriting from the appropriate base and overriding 
methods. 


This allows implementing rigs that integrate and manage 
their child chains in intelligent ways in order to add extra 
automation specific to certain areas. The base skin 
system includes one simple example skin.transform.basic 
rig, which translates its child control points according to 
its control bone transformation. 


Custom Rigging 
Finally, the new system provides ways to integrate with 
custom automation directly included in the meta-rig via 
two extra rig components. 


The skin.anchor rig generates a single control with 
inherited constraints etc., similar to basic.super copy. 
However, it also integrates into the skin system as a zero 
length chain with highest priority. This allows overriding 
the normal behavior by providing a control point under 


full control of the user, which other chains would 
automatically attach to. 


The skin.glue rig on the other hand will attach itself to 
the control that is generated at its position (it is an error 
if there is none). It can be used to read the position of the 
control from custom rigging in the meta-rig, or inject 
constraints into the control bone. It is possible to also 
detect the control at the tail of the glue bone and use it 
as target in the constraints, thus copying transformation 
between the controls. 


skin.basic_ chain 


This is the basic chain rig, which bridges controls with B- 
Bones but does not add any automation to the controls 
themselves. 


When controls are merely moved, the chains behave as if 
using standard automatic handles, but rotating and 
optionally scaling the controls will adjust the result. 


B-Bone Segments 
Specifies the number of segments to use. Setting this to 
1 disables all advanced behavior and merely bridges the 
points with a Stretch To bone. 


Merge Parent Rotation and Scale 


This can be enabled to let the chain respond to rotation 
and scale induced by parents of controls owned by other 
chains that this chain’s control merged into. 


Use Handle Scale 


Enables using control scale to drive scale and/or easing 
of the B-Bone. 


Connect With Mirror 
Specifies whether the ends of the chain should smoothly 
connect when merging controls with its .T/.B .L/.R 
symmetry counterpart. The relevant option must be 
enabled on both chains to work. 


Connect Matching Ends 
Specifies whether the end of the chain should connect to 
the opposite end of a different chain when merging 
controls. Thus forming a continuous smooth chain in the 
same direction. The relevant options must be enabled on 
both chains. 


Sharpen Corner 
Specifies whether the rig should generate a mechanism 
to form a sharp corner at the relevant connected end, 
depending on the angle formed by adjacent control 
locations. When the control angle becomes sharper than 
the specified value, ease starts reducing from 1 to 0. 


Orientation 


Specifies that the controls should be oriented the same 
as the selected bone, rather than being aligned to the 
chain. 


Copy To Selected 
Copy to selected rigs that have the same option. Thus 
allowing to indiscriminately selecting bones without 
assigning unnecessary values. 


Chain Priority 


Allows overriding the heuristic used to select the primary 
owner when merging controls. 


skin.stretchy chain 


This rig extends the basic chain with automation that 
propagates movement of the start and end, and an optional 
middle control, to other controls. This results in stretching 
the whole chain when moving one of the ends, rather than 
just the immediately adjacent B-Bones. 


Middle Control Position 
Specifies the position of the middle control within the 
chain; disabled when zero. 


Falloff 
Specifies the influence falloff curves of the start, middle 
and end controls. Zero results in linear falloff, increasing 
widens the influence, and -10 disables the influence 
propagation from that control completely. 


Spherical Falloff 
Toggle buttons to change the shape of the falloff curve 
from a power curve that at falloff 1 forms a parabola \(1 - 
x*{2~f}\) to a curve forming a circle \((1 - 
X*{2°F})* {2% {-FF F\). 


Falloff Along Chain Curve 
Computes the falloff curve along the length of the chain, 
instead of projecting on the straight line connecting its 
start and end points. 


Propagate Twist 
Specifies whether twist of the chain should be 
propagated to control points between main controls. 


Propagate Scale 
Specifies whether perpendicular scaling of the chain 
should be propagated to control points between main 
controls. 


Propagate to Controls 


Allows other chains to see propagated twist and scale via 
Merge Parent Rotation and Scale when their controls are 
merged into this chain, instead of it being completely 
local to this chain. 


Primary Control Layers 
Optionally specifies layers for the end controls. 


Secondary Control Layers 
Optionally specifies layers for the middle control, falling 
back to Primary Control Layers if not set. 


The main controls with active falloff have the effect of 
Merge Parent Rotation and Scale automatically enabled just 
for them. 


skin.anchor 


This rig effectively acts as a zero-length chain with highest 
priority, ensuring that it becomes the owner when merging 
controls with other chains. And also allowing one to input 
custom automation influence into the skin system. 


All constraints on the meta-rig bone are moved to the 
created control. 


Generate Deform Bone 
Creates a deformation bone parented to the control. 


Suppress Control 
Makes the control a hidden mechanism bone to hide it 
from the user. 


Widget Type 
Selects which widget to generate for the control. 


Relink Constraints 
Operates the same as in basic.raw_copy, except all 
constraints are moved from ORG to the control bone. 


Orientation 
Specifies the bone used to orient the control, like for 
other chains. 


skin.glue 


This rig is in concept similar to skin.anchor, but instead of 
overriding controls, it is used to read or adjust the state of 
controls generated by other rigs. The head of the bone must 
overlap a control of another skin rig. 


The rig sets up its ORG bone to read the state of the control, 
while moving all constraints that were originally on the bone 
to the control. 


Glue Mode 
Specifies how the ORG bone is connected to the skin 
control. 


Child Of Control 
Makes the ORG bone a child of the control bone. 


Mirror Of Control 
Makes the ORG bone a sibling of the control with a 
Copy Transforms constraint from the control. The 
resulting local space transformation is the same as 
control’s local space. 


Mirror With Parents 
Parents the ORG bone to the parent automation a 
control owned by the glue rig would have had, while 


making it follow the actual control. This includes both 
direct and parent-induced motion of the control into 
the local space transformation of the bone. 


Deformation Bridge 
Other than adding glue constraints to the control, the 
rig acts aS a one Segment basic deform chain. This is 
convenient when a pair of controls need to be bridged 
both with glue and a deform bone. 


Relink Constraints 
Operates the same as in basic.raw_copy, except all 
constraints are moved from ORG to the control bone. 


Use Tail Target 
Relinks TARGET or any constraints with an empty target 
bone and no relink specification to reference the control 
located at the tail of the glue bone. 


Target Local With Parents 
Switches the tail target to operate similarly to Mirror With 
Parents. 


Add Constraint 
Allows to add a typical glue constraints with specific 
Influence, as if it were at the start of the ORG bone 
constraint stack. 


skin. transform. basic 


This rig provides a simplistic parent controller, which uses 
regular translation, rotation, or scale to modify locations but 
not orientations or scale of its child chain controls. 


Generate Control 


Specifies whether to generate a visible control, or use the 
transformation of the ORG bone as a part of more 
complex and specific rig setup. 


Face 


These rig types implement components of a modular face. 


face.basic tongue 


Generates a simple tongue, extracted from the original 
PitchiPoy super face rig. 


B-Bone Segments (integer) 
Defines the number of b-bone segments each tweak 
control will be split into. 


Primary Control Layers 
Optionally specifies layers for the main control. 


face.skin eye 


Implements a skin system parent controller that manages 
two skin chains for the top and bottom eyelids in addition to 
generating the eye rotation mechanism. 


The rig must have two child skin chains with names tagged 

with .T and .B symmetry to mark the top and bottom eyelid, 
which are connected at their ends forming eye corners. The 
chains are rigged to follow the surface of the eye and twist 

to its normal. 


In addition, it creates target controls for aiming the eye, 
including a master control shared by all eyes under the 
same parent rig. The eyelids are rigged to follow the 
movement of the eyeball with adjustable influence. 


Eyeball and Iris Deforms 
Generates deform bones for the eyeball and the iris, the 
latter copying XZ scale from the eye target control. The 
iris is located at the tail of the ORG bone. 


Eyelid Detach Option 
Generates a slider to disable the mechanism that keeps 
eyelid controls stuck to the surface of the eye. 


Split Eyelid Follow Slider 
Generates two separate sliders for controlling the 
influence of the eye rotation on X and Z eyelid motion. 


Eyelids Follow Default 
Depending on Split Eyelid Follow Slider, specifies the 
default values for the split follow sliders, or fixed factors 
to be multiplied with the single common follow influence 
Slider value. 


face.skin_ jaw 


Implements a skin system parent controller that manages 
one or more loops of mouth skin chains in response to the 
movement of jaw and mouth controls. 


The rig must have one or more child chain loops, each 
formed by four skin chains tagged with .T/.B and .L/.R 
symmetrical names. 


The lip loops are sorted into layers based on the distance 
from corners to the common center and rigged with blended 
influence of the jaw and the master mouth control. Other 
child rigs become children of the jaw. 


Bottom Lip Influence 


Specifies the influence of the jaw on the inner bottom lip 
with mouth lock disabled. 


Locked Influence 
Specifies the influence of the jaw on both lips of locked 
mouth. 


Secondary Influence Falloff 
Specifies the factor by which influence fades away with 
each successive lip loop (for bottom lip loops the blend 
moves away from inner bottom lip to full jaw influence). 


Feature Sets 


Rigify allows third party developers to implement sub-add- 
ons, called Feature Sets, which can provide new Meta-Rigs 
and Rig_Types. Similar to regular add-ons, they can be 
installed from zip-files through Rigify settings. 


These are some examples of Feature Sets currently 
provided by past and current Rigify developers: 


Cessen’s Rigify Extensions 
This feature set provides the original Rigify rigs by 
Nathan Vegdahl, minimally ported and repackaged to 
work without switching Rigify to legacy mode. Note that 
their names were changed, so meta-rigs designed for 
legacy mode aren’t directly compatible. 


Experimental Rigs by Alexander Gavrilov 
Rig experiments, some of which might be included in 
Rigify in the future. Examples include limbs with an extra 
IK system based at knee/elbow, a spline based tentacle, 
and more. 


Cloud Rig 
This major conversion feature set by Demeter Dzadik 
implements the rig used by the Blender Animation Studio 
using the Rigify framework. 


You can install these packages by clicking Clone » Download 
ZIP, and then install the downloaded file through Rigify 
settings. 


Developer documentation is available on the Blender Wiki. 


Sequencer 


These add-ons add features to the Video Sequencer. 


e Power Sequencer 
e Storypencil 


Power Sequencer 


Power Sequencer is an add-on to help you edit your videos 
faster in the Video Sequencer. It adds many features to help 
you cut, trim, select, concatenate, or add transitions 
between sequences. 


Activation 


e Open Blender and go to the Edit menu and select 
Preferences. 

e In the Blender Preferences window, click on the the Add- 
ons tab on the left. 

e In the search bar in the top-right, type “Power 

Sequencer”. 

Click the checkbox to the left of Sequencer: Power 

Sequencer to activate the add-on. 


Usage 


You can find the add-on’s full documentation on the author’s 
website: 


e Getting_started 
e Features reference 


Reference 

Category: Sequencer 

Description: Video editing tools for content creators. 
Location: Video Sequencer 


File: power_sequencer folder 


Author: Nathan Lovato 
Note: This add-on is bundled with Blender. 


Storypencil 


Storypencil is an add-on that adds tools to help the 
storyboarding workflow using the video sequencer. It adds 
many features to help adding, editing and rendering linked 
scenes. 


Activation 


e Open Blender and go to Edit Menu, Preferences, then 
Add-ons. 
e Search for Storypencil, and activate the add-on. 


Description 


After activating the add-on, it will place buttons on the video 
sequencer header to control the linked Scenes Strips: Edit, 
New and Render. 


In the video Sequencer sidebar you will find a Storypencil 
tab with all the Settings for the add-on. 


Usage 


With the 2D Animation Template in Draw Mode, you can use 
the menu located in the 3D Viewport >» Draw > Setup 
Storyboard Session and the add-on will take care to set up 
all the general settings and create the workspaces and 
Scenes needed for the storyboard session. 


Use the main buttons on the video sequencer header to 
add, edit and render Scene Strips. 


New 


Add a new Scene Strip to the active channel based on the 
Base Scene selected in the add-on settings. The name of the 
new Scene Strip will use the prefix and suffix stablished on 
the settings. 


Edit 


Opens the linked source scene under the timeline cursor in 
the video sequencer. There are two modes for editing source 
scenes, you can control the behavior by toggling the 
checkbox “Open in new window” next to the button. 


New Window mode 


Storypencil will open the source scene in a new window 
keeping their timelines synchronized. When you finish 
editing the source scene you can close the opened window 
or keep it opened and control the timeline in the video 
sequencer to change to another scene. 


This method is best suited when using multiple monitors. 
Switching mode 


Storypencil will open the source scene switching to the 
proper Workspace at the same video sequencer cursor 
position. When you finish editing the source scene you can 
return to the video Sequencer using the Back button on the 
Dope Sheet header in the source scene Workspace. 


This method is best suited when using only one monitor. 


Important 


There is still a known issue when the Add-on is used 
together with a scene pinned to a workspace. 
Synchronization between scenes may fail. 


Render 


Render all or only selected scene strips, depending on the 
Add-on Render Strips settings. 


Settings 


New Scenes 


Name Prefix 
Prefix that will be added to the name of new Scene 
Strips. 


Name Suffix 
Suffix that will be added to the name of new Scene 
Strips. 


Frames 
Duration in frames for the new Scene Strips. 


Base Scene 
The Scene used as base for Scene Strips. In this Base 
Scene you can setup cameras, Grease Pencil objects, 
background objects, etc. to avoid start from scratch 
every time. 


Render Strips 


If the render format is Movie the add-on will render one 
Movie clip per Scene strip using the video sequencer render 
settings. All rendered Movies will be imported (if Import 
Rendered Strips setting is enabled) as Movie clips on the 
selected channel. 


If the render format is Image the add-on will render one 
image on each keyframe found in the source scene of the 
Scene strip using the video sequencer render settings. All 
rendered Images will be imported (if Import Rendered Strips 
setting is enabled) as Image Strips on the selected channel, 
the length used for the imported Image Clip will correspond 
to the gap between keyframes. 


Output Path 
Directory name where rendered video or images will be 
saved. 


Render Only Selected Strips 
When enabled, only the selected Scene Strips will be 
rendered. 


File Format 
Select the File Format to render the Scene Strips. 


Container 
Output file container to use. 


Audio Codec 
FFmpeg audio codec to use. 


Import Rendered Strips 
When enabled, The Movie clips or images generated will 
be imported after rendered. 


Channel 
The Channel to use for Movie clips or images imported 
after rendered. 


Image Steps 
If greater than 0, when rendering images sets the 
number of images to generate between keyframes. 


Image Numbering 
Sets the Numbering format for the generated images to 
use. 


Folder by Strip 
When enabled, saves the images to the Output Path 
inside different folders with the Scene Strip name. 


General 


VSE Workspace 
Workspace to use for video editing. 


VSE Scene 
Scene to use as the main video editing scene. 


Drawing Workspace 
Workspace to use for edit the source scenes. 


Reference 

Category: Sequencer 

Description: Storyboard tools. 

Location: Video Sequencer 

File: Storypencil folder 

Author: Antonio Vazquez, Matias Mendiola, 


Daniel Martinez Lara, Rodrigo Blaas 
Note: This add-on is bundled with Blender. 


System 


Important 


Work In Progress 


These add-ons relate to showing information about objects 
and scenes. 


Scene Information 
Blender ID Authentication 
Demo Mode 

Property Chart 

Manage UI Translations 


Scene Information 


A visual overview of your scene and it’s contents. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 


e Click System then Scene Information to enable the 
Script. 


Interface 


Located in the Properties » Scene » Blend Info panel. 


Description 

e To Do 
Reference 
Category: System 
Description: Show information about the blend-file. 
Location: Properties » Scene » Blend Info panel 
File: system_scene_information.py 
Author: uselessdreamer 
License: GPL 


Note: This add-on is bundled with Blender. 


Blender ID Authentication 


This add-on allows you to authenticate your Blender with 
your Blender ID account. This authentication can then be 
used by other add-ons, such as the Blender Cloud add-on. 


Installation 


e Sign up for an account at the Blender ID site if you don’t 
have an account yet. 

e Open Blender and go to Preferences then the Add-ons 

tab. 

Click System then Blender ID authentication to enable 

the script. 

e Log in with your Blender ID and password. You only have 
to do this once. 


Your password is never saved on your machine, just an 
access token. It is stored next to your Blender configuration 
files, in: 


e Linux: 
$HOME/. config/blender/3.4/config/blender id 
e macOS: 


$HOME/Library/Application 
Support/Blender/3.4/config/blender id 


e Windows: 


%APPDATA%\Blender Foundation\Blender\3.4\config\blender id 


Description 


e To Do 

Reference 

Category: System 

Description: Stores your Blender ID credentials for 
usage with other add-ons. 

Location: Preferences » Add-on tab 

File: blender id folder 

Author: Sybren A. Stuvel, Francesco Siddi, and 
Inés Almeida 

License: GPLv2+ 


Note: This add-on is bundled with Blender. 


Demo Mode 


Todo. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click System then Demo Mode to enable the script. 


Configuration 


This is done from File » Demo Mode (Setup) in the File 
menu, from here you can select a directory which is 
searched recursively for blend-files to loop over. 


There are options as to what to do with each file at the 
moment the main options are to render or play an 
animation with options as to how many cycles to play, time 
to wait after render is done. 


Automatic Configuration 


The Auto option selects between Render and Play option 
based on the window layout’s use of image/node editors. If 
you are happy to use these settings on all files, you can 
leave the Run Immediately option enabled and confirm. 


Adjusting the Configuration 


If you want to set options per file, you can disable Run 
Immediately, during setup and select demo. py text data- 
block. This file has one line per file and settings can be 
edited and saved with the blend-file. When demo. py is present 
you only have to go to File » Demo Mode (Start). 


Attributes 


These keyword arguments show up in generated demo. py, 
e.g: 


dict(anim cycles=2, anim_render=False, anim screen _switch=0.0, 
anim time max=8.0, anim time min=4.0, 
display render=4.0, file='foobar.blend', mode='AUTO'), 


e anim_cycles - Number of times to play the animation. 

e anim render - Render entire animation (applies to 
mode='RENDER' Only). 

e anim screen switch - Time between switching screens (in 
seconds) or 0 to disable. 

e anim time max - Maximum number of seconds to show the 
animation for (in case the end frame is very high for no 
reason). 

e anim time min - Minimum number of seconds to show the 
animation for (for small loops). 

e display_render - Time to display the rendered image 
before moving on (in seconds). 

e file - The filepath for the blend-file. 

e mode — AUTO / PLAY / RENDER - what to do on load. 


Portable Configuration 
Once you setup a demo.py you may want to move it toa 


different system. In this case the paths might not match up, 
if so update the search path variable to point to the path on 


the new system. You can also set the search path to use the 
directory of the current blend-file: 


search path = "//" 


Usage 


Once the demo starts it will play, render and load different 
files in the same Blender instance. Since its using a modal 
operator you can still use with Blender while the demo runs. 


If you want to stop Demo Mode, you can press Esc and 
continue using Blender. To enable again there are three 
buttons at the right hand side of the file menu to navigate 
Prev/Pause/Next. 


Limitations 


e One file can’t play an animation then render, you need 
to copy the line in demo.py and set one mode to RENDER 
the other to PLAY. 


Reference 

Category: System 

Description: Demo Mode lets you select multiple 
blend-files and loop over them. 

Location: File » Demo menu 

File: system _demo_ mode folder 

Author: Campbell Barton 

License: GPL 


Note: This add-on is bundled with Blender. 


Property Chart 


When selecting an object you will see a new panel in the 3D 
Viewport’s Sidebar. In that panel you can edit the properties 
of selected objects. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 


e Click System then Property Chart to enable the script. 


Description 
e To Do 

Reference 

Category: System 

Description: Edit arbitrary selected properties for 
objects/sequence strips of the same 
type. 

Location: 3D Viewport > Sidebar > Item tab 

File: system_property_chart.py 

Author: Campbell Barton (ideasman42) 

License: GPL 


Note: This add-on is bundled with Blender. 


Manage UI Translations 
Todo 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click System then Manage UI translations to enable the 
Script. 


Description 


See Blender translation how-to in the Wiki. 


Reference 

Category: System 

Description: Allows managing UI translations directly 
from within Blender (update main po- 
files, update scripts’ translations, etc.). 

Location: Topbar » File menu, Text editor, any UI 
control 

File: ui_translate folder 

Author: Bastien Montagne 


Note: This add-on is bundled with Blender. 


UV 


Important 


Work In Progress 


These add-ons relate to the UV editor and UV editing. 


e Magic UV 


Magic UV 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 
e Click UV then Magic UV to enable the script. 


Interface 


Located in the 3D Viewport >» Sidebar » Edit and UV Editor > 
Sidebar > Magic UV. 


Instructions 


Copy/Paste UV 
Transfer UV 
Flip/Rotate UV 
Mirror UV 

Move UV 

World Scale UV 
Preserve UV Aspect 
Texture Lock 
Texture Wrap 

UV Sculpt 

Unwrap Constraint 
Texture Projection 
UVW 

Align UV 
Smooth UV 

Select UV 


Pack UV (Extension) 
Clip UV 

Align UV Cursor 
UV_Cursor Location 
UV Bounding Box 
UV Inspection 


Copy/Paste UV 


3D Viewport (Edit) 


Reference 

Editor: 3D Viewport 

Mode: Edit 

Menu: UV > Copy/Paste UV 

Panel: Sidebar >» Magic UV > Copy/Paste UV » 


Copy/Paste UV 


Copy and paste UV coordinates among same/different 
object’s faces in 3D View. Copy/Paste UV sometimes fails to 
paste UV correctly because of the incorrect UV index. 
Instead, you can try Transfer UV which you can copy and 
paste based on the topology. 


Target UV Map 


Default: Copy/paste UV maps currently 
displayed. 

All: Copy/Paste all UV maps. 

New: Allocate new UV map and paste to it. 


Copy/Paste Mode 
Selection Sequence: 


provides a way to specify the ordering 
of copied/pasted faces by face 
selection. 


Seams 
If enabled, you can also copy/paste seams. 


Strategy 
Provides a way to decide copy/paste UV repeatedly if a 
number of copied faces is differs from pasted faces. 


Tip 


You can flip or rotate UV by changing Flip Copied UV 
property or Rotate Copied UV property. 


Usage 


1. Click check box Copy/Paste UV to show Copy/Paste UV 
menu. 

. Select faces whose UV you want to copy. 

. Click Copy » (Target UV Map). 

. Select faces whoe UV you want to paste. 

. Click Paste > (Target UV Map). 
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3D Viewport (Object) 


Reference 

Editor: 3D Viewport 

Mode: Object 

Menu: Object >» Copy/Paste UV 


Panel: Sidebar >» Magic UV > Copy/Paste UV 


Copy and paste UV coordinates among same topology 
objects. 


Copy/Target UV Map 


[Default]: Copy/paste UV maps currently 
displayed. 
[All]: Copy/Paste all UV maps. 
[New]: Allocate new UV map and paste to it. 
Seams 


If enabled, you can also copy/paste seams. 


Usage 


1. Select object whose UV you want to copy. 
2. Click Copy > (Target UV Map). 

3. Select objects whose UV you want to paste. 
4. Click Paste > (Target UV Map). 


Tip 


You can paste UV to the multiple objects. 


UV Editor (Face) 


Reference 

Editor: UV Editor 

Menu: UV > Copy/Paste UV 

Panel: Sidebar >» Magic UV > Copy/Paste UV » 


Face 


Copy and paste UV coordinates among same/different 
object’s faces in UV Editor. 


Usage 


1. Select UVs you want to copy. 
2. Click Copy. 

3. Select UVs you want to paste. 
4. Click Paste. 


Note 


You must select UVs which consist closed loop (i.e. face). 


UV Editor (Island) 


Reference 

Editor: UV Editor 

Menu: UV > Copy/Paste UV 

Panel: Sidebar >» Magic UV > Copy/Paste UV » 


Island 


Copy and paste UV coordinates based on the UV islands. 


Unique Target 
If enabled, paste to the target uniquely. 


Usage 


1. Select UV islands you want to copy. 
2. Click Copy. 

3. Select UV islands you want to paste. 
4. Click Paste. 


Tip 


Selection of UV island can easily be done by using the 
island selection mode. 


Transfer UV 


Reference 

Editor: 3D Viewport 

Mode: Edit 

Menu: UV > Transfer UV 

Panel: Sidebar >» Magic UV > Copy/Paste UV » 


Transfer UV 


Copy and paste UV coordinates based on the mesh’s 
topology. Transfer UV can solve the Copy/Paste UV issue 
raised when the meshes don’t have same UV indices. 
However, Transfer UV also can not solve the issue raised 
when you try the meshes which don’t have same topology. 


Invert Normals 
If enabled, you can copy/paste to the mirrored mesh. 


Seams 
If enabled, you can also copy/paste seams. 


Usage 


1. Click check box Transfer UV to show Transfer UV menu. 

2. Select 2 adjacent faces of the mesh whose UV you want 
to copy. 

3. Click Copy. 

4. Select 2 adjacent faces of the mesh whose UV you want 
to paste. 

5. Click Paste. 


Note 


e Copied/Pasted mesh must have the same number of 
faces. 

e Transfer UV ignore the hidden faces. 

e You can paste UV to the multiple meshes. 


Flip/Rotate UV 


Reference 

Editor: 3D Viewport 

Mode: Edit 

Menu: UV >» Flip/Rotate UV 

Panel: Sidebar >» Magic UV » UV Manipulation > 


Flip/Rotate UV 


Flip or rotate UV. 


Seams 
If enabled, you can also flip/rotate seams. 


Usage 


1. Click check box Flip/Rotate UV to show Flip/Rotate UV 
menu. 

2. Select faces whose UV you want to flip or rotate. 

3. Click Flip/Rotate. 

4. Change value Flip UV or Rotate UV. 


Mirror UV 


Reference 


Editor: 3D Viewport 


Mode: Edit 

Menu: UV > Mirror UV 

Panel: Sidebar >» Magic UV » UV Manipulation > 
Mirror UV 


Make mirrored UV. 


Error 

Changes the error threshold for mirror. 
Origin 

Specifies the origin of the mirror operation. 


Usage 


1. Click check box Mirror UV to show Mirror UV menu. 
2. Select faces you want to refer. 
3. Choose the axis of the mirror direction. 


4. Click Mirror. 
Move UV 
Reference 
Editor: 3D Viewport 
Mode: Edit 
Menu: UV > Move UV 
Panel: Sidebar >» Magic UV >» UV Manipulation > 


Move UV 


Move UV with a mouse in the 3D Viewport. 


Usage 


. Click check box Move UV to show Move UV menu. 

. Select vertices/edges/faces whose UV you want to 
move. 

. Click Start. 

. Press Mouse Left Button to start moving UV. 

. You can move UV with mouse. 

. Press Mouse Left Button to stop moving UV. 
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If you want to cancel moving UV, press RMB. 


World Scale UV 


Reference 

Editor: 3D Viewport 

Mode: Edit 

Menu: UV > World Scale UV 

Panel: Sidebar >» Magic UV » UV Manipulation > 


World Scale UV 
Measure and set texel density. 
Texture 


Texture to be used for the size calculation of density. 


[Average]: Average size of textures assigned to 
the selected object. 

[Max]: Max size of textures assigned to the 
selected object. 

[Min]: Min size of textures assigned to the 


selected object. 
(Texture Name): 
Size of selected texture. 


Origin 


Changes the UV origin after applying texel density. 


Area Calculation Method 
Method to calculate mesh area, UV area and density. 


Only Selected 
If enabled, measure/apply only to the selected faces. 


Mode: Manual 


Usage 


1. Click check box World Scale UV to show World Scale UV 
menu. 

2. Select mode Manual. 

3. Change value Texture Size referred as virtual texture 
size. 

4. Change value Density referred as target texel density. 

5. Select face you want to apply texel density. 

6. Click Apply. 


Mode: Same Density 


Usage 


1. Click check box World Scale UV to show World Scale UV 
menu. 

. Select mode Same Density. 

. Select face you want to measure a texel density. 

. Click Measure. 

. You can see the target texel density. 

. Select face you want to apply texel density. 

. Click Apply. 
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Mode: Scaling Density 


Usage 


. Click check box World Scale UV to show World Scale UV 


menu. 


. Select mode Scaling Density. 

. Select face you want to measure a texel density. 

. Click Measure. 

. You can see the measured texel density. 

. Change value Scaling Factor for the scale factor of the 


texel density. 


. Select face you want to apply texel density. 
. Click Apply. 


Mode: Proportional to Mesh 


Usage 


. Click check box World Scale UV to show World Scale UV 


menu. 


. Select mode Proportional to Mesh. 

. Select face you want to measure a texel density. 

. Click Measure. 

. You can see the measured mesh area, UV area and 


density. 


. Select face you want to apply texel density. 
. Click Apply. 


Preserve UV Aspect 


Reference 

Editor: 3D Viewport 

Menu: UVs > Preserve UV 

Panel: Sidebar >» Magic UV » UV Manipulation > 


Preserve UV Aspect 


Change assigned texture with preserving UV aspect. 


Origin 
Changes the UV origin after changing texture. 


Usage 


1. Click check box Preserve UV Aspect to show Preserve UV 
Aspect menu. 

2. Select face you want to change texture. 

3. Select texture you want to assign. 

4. Click Change Image. 


Texture Lock 


Reference 

Editor: 3D Viewport 

Mode: Edit 

Menu: UV > Texture Lock 

Panel: Sidebar >» Edit » UV Manipulation > 


Texture Lock 
Preserve UV while you edit the mesh. 
Normal Mode 
Connect 


If enabled, you can keep UV connection by changing 
other face’s UV. 


Usage 


1. Click check box Texture Lock to show Texture Lock 
menu. 


2. Select vertices/edges/faces which you want to preserve 
UV. 

3. Click Lock. 

4. Transform vertices/edges/faces as you like. 

5. Click Unlock, you can return to the UV before locking. 


Interactive Mode 


Usage 


1. Click check box Texture Lock to show Texture Lock 
menu. 

2. Select vertices/edges/faces which you want to preserve 
UV. 

3. Click Lock. 

4. Transform vertices/edges/faces while preserving UV. 

5. Click Unlock. 


Texture Wrap 


Reference 

Editor: 3D Viewport 

Mode: Edit 

Menu: UV > Texture Wrap 

Panel: Sidebar » Edit » UV Manipulation > 


Texture Wrap 


Set texture coordinate along to the mesh structure. 


Set and Refer 
If enabled, you don’t need to click Refer after Set as long 
as you refer same face. 


Selection Sequence 


If enabled, you can select multiple faces and apply Set at 
once. The application order follows the selection 
sequence. 


Usage 


1. Click check box Texture Wrap to show Texture Wrap 
menu. 

2. Select a face whose UV you want to refer as initial 
position. 

3. Click Refer. 

4. Select an adjacent face whose UV you want to set. 

5. Click Set. 


UV Sculpt 

Reference 

Editor: 3D Viewport 

Mode: Edit 

Menu: UV > UV Sculpt 

Panel: Sidebar >» Edit » UV Manipulation » UV 


Sculpt 


UV Sculpt in the 3D Viewport. Same features are supported 
as the UV sculpt in UV Editor. 


Radius 
Provides a way to change the brush radius. 


Strength 
Provides a way to change the effectiveness. 


Tools 


Grab: Move UV along to the mouse 
movement while you press Mouse Left 
Button. 


Relax: Relax UV while you press Mouse Left 
Button. 
Method 
Provides a way to change the relax 
method. 


Pinch: Pinch UV while you press Mouse Left 
Button. 
Invert 
If enabled, the direction of pinch will 
be inverted. 


Show Brush 
If enabled, display the brush’s effective range while 
sculpting. 


Usage 


1. Click check box UV Sculpt to show UV Sculpt menu. 
2. Select faces whose UV you want to sculpt. 

3. Click Enable. 

4. Sculpt UV as you like (See detail each tool’s usage). 
5. Click Disable. 


Unwrap Constraint 


Reference 

Editor: 3D Viewport 

Mode: Edit 

Menu: UV > Unwrap Constraint 


Panel: 


Sidebar » Edit » UV Mapping >» Unwrap 
Constraint 


Unwrap UV with an axis fixed. 


Usage 


1. Click check box Unwrap Constraint to show Unwrap 
Constraint menu. 

2. Select faces whose UV you want to unwrap. 

3. Enable or disable U-Constraint property and V-constraint 
property to fix axis while unwrapping. 

4. Click Unwrap. 


Texture Projection 


Reference 

Editor: 3D Viewport 

Mode: Edit 

Menu: UV > Texture Projection 

Panel: Sidebar » Edit » UV Mapping > Texture 


Projection 


Project the texture to the mesh while displaying texture 
image in 3D View. 


Transparency 
Provides a way to change transparency of the displayed 
texture. 


Adjust Window 
If enabled, size of the displayed texture is adjusted to the 
window. 


Scaling, Rotation, Translation 
Provide a way to apply the affine transformation to the 
displayed texture. Available when Adjust Window is 
disabled. 


Texture Aspect Ratio 
If enabled, keep the original aspect of the displayed 
texture. 


Assign UV Map 
If enabled, assign new UV map when no UV is assigned to 
the mesh. 


Usage 


1. Click check box Texture Projection to show Texture 
Projection menu. 

2. Select faces whose UV you want to apply Texture 
Projection. 

3. Select a texture to be projected. 

4. Click Enable to display the texture. 

5. Adjust texture size and the mesh location to decide the 
location of projection. 

6. Click Project to project texture to UV. 

7. Click Disable. 


UVW 

Reference 

Editor: 3D Viewport 
Mode: Edit 

Menu: UV > UVWW 


Panel: Sidebar » Edit » UV Mapping » UVW 


UVW mapping. 


Assign UV Map 
If enabled, assign new UV map when no UV is assigned to 
the mesh. 


Force Axis 
Specifies the axis to apply force mapping. 


Usage 


1. Click check box UVW to show UVW menu. 

2. Select faces you want to apply UVW mapping. 

3. Click Box if you apply Box mapping, or click Best Planner 
if you apply Best Planner mapping. 


Align UV 

Reference 

Editor: UV Editor 

Menu: UVs > Align UV 

Panel: Sidebar >» Magic UV » UV Manipulation > 
Align UV 

Align 

Align UV. 

Circle 


Selects all the outermost UVs and aligns them to a round 
shape. 


Straighten 


Selects the endmost UVs and aligns them to a straight 
line between begin UV and end UV. 


XY-axis 
Selects the endmost UVs and aligns them to a straight 
line along to X or Y axis. 


Align Location 
In case of XY-axis alignment, you can change the location 
(Middle, Right/Bottom, Left/Top) after UV alignment. 


Transmission 
Align UVs with vertical direction. 


Select 
The aligned UVs will be selected after operation. 


Vertical 
Align UVs to vertical direction with using the influence of 
mesh vertex location. 


Horizontal 
Align UVs to horizontal direction with using influence of 
mesh vertex location. 


Mesh Influence 
Provides a way to change the influence of mesh 
structure. 


Usage 


1. Click check box Align UV to show Align UV menu. 

2. Select UVs you want to align (see details below). 

3. Click Circle or Straighten or XY-axis depending on your 
purpose. 


Snap 


Snap UV coordinates to the specified location. 


Snap Method 


Point: Snap UV coordinates to the location 
specified by Target Point. 
Edge: Snap UV coordinates to the location 


specified by Target Edge. 


Snap: Point 
Group 
Vertex: All selected vertices will snap to Target 
Point. 
Face: Center of all selected faces will snap to 
Target Point. 
UV Island: Center of all selected islands will snap 
to Target Point. 
Usage 
1. Click check box Align UV to show Align UV menu. 
2. Select snap method Point. 
3. Set Target Point where UV coordinate will snap to. 
4. Set snap Group (See below for details). 
5. Select vertices or faces or UV islands which you want to 
snap. 
Snap: Edge 
Group 
Edge: Selected edge will snap to the center of 


Target Edge. 
Face: 


All edges belonging to faces which are 
included in selected edge will snap to 
the center of Target Edge. 

UV Island: All edges belonging to UV islands which 
are included in selected edge will snap 
to the center of Target Edge. 


Usage 


1. Click check box Align UV to show Align UV menu 
2. Select snap method Edge. 

3. Set Target Edge where UV edge will snap to. 

4. Set snap Group (See below for details). 

5. Select edges which you want to snap. 


Smooth UV 

Reference 

Editor: UV Editor 

Menu: UVs » Smooth UV 

Panel: Sidebar >» Magic UV » UV Manipulation » 
Smooth UV 

Smooth UV. 


Transmission 
If enabled, smooth UVs which are located on vertical 
direction of selected UV. 


Select 
If enabled, the smoothed UVs are selected. 


Mesh Influence 


Provides a way to change the influence of mesh 
structure. 


Usage 


1. Click check box Smooth UV to show Smooth UV menu. 

2. Select UVs you want to smooth (The endmost UVs must 
be selected). 

3. Click Smooth. 


Select UV 

Reference 

Editor: UV Editor 

Menu: UVs >» Select UV 

Panel: Sidebar >» Magic UV » UV Manipulation > 


Select UV 


Select UV under the specific condition. 


Overlapped 
Selects all overlapped UVs. 


Flipped 
Selects all flipped UVs. 


Same Polygon Threshold 
Provides a way to set a threshold for judging the same 
polygons. 


Selection Method 
Specifies how to select the faces. 


Sync Mesh Selection 
Select the mesh’s faces as well as UV’s faces. 


Zoom Selected UV 
Zoom to the selected UV in 3D Viewport. 


Usage 


1. Click check box Select UV to show Select UV menu. 
2. Click Overlapped or Flipped depending on your purpose 
(see details below). 


Pack UV (Extension) 


Reference 

Editor: UV Editor 

Menu: UVs >» Pack UV 

Panel: Sidebar >» Magic UV » UV Manipulation > 


Pack UV (Extension) 


Apply island packing and integrate islands which have same 
shape. 


Allowable Center Deviation 
Provides a way to specify the center deviation that 
regards as the same island. 


Allowable Size Deviation 
Provides a way to specify the size deviation that regards 
as the same island. 


Accurate Island Copy 
If enabled, copy islands topologically in island integration 
phase. 


Stride 


Move coordinates amount of UV islands after island 
integration. 


Apply Pack UV 
If enabled, apply Blender intrinsic Pack UV operation. 


Usage 


1. Click check box Pack UV (Extension) to show Pack UV 
(Extension) menu. 

2. Select faces whose UV you want to pack. 

3. Click Pack UV. 


Clip UV 

Reference 

Editor: UV Editor 

Menu: UVs > Clip UV 

Panel: Sidebar >» Magic UV » UV Manipulation > 


Clip UV 


Clip UV coordinate to the specified range. 


Range 
Specifies the clipping range. 


Usage 


1. Click check box Clip UV to show Clip UV menu. 
2. Select faces you want to clip UV coordinates. 
3. Click Clip UV. 


Align UV Cursor 


Reference 


Editor: UV Editor 
Menu: UVs » Align UV Cursor 
Panel: Sidebar >» Magic UV » Editor 


Enhancement » Align UV Cursor 


Align UV cursor (2D Cursor in UV Editor). 


Align Method 
Texture: The UV cursor aligns to the selected 
texture. 
UV: The UV cursor aligns to the d UV 


(includes non-selected UV). 
UV (Selected): The UV cursor aligns to the displayed 
UV (only selected UV). 


Usage 


1. Click check box Align UV Cursor to show Align UV Cursor 
menu. 

2. Select Texture or UV or UV (Selected) depending on your 
purpose (See details below). 

3. Click the position button (You can choose the position 
from 9 buttons). 


UV Cursor Location 


Reference 
Editor: UV Editor 
Panel: Sidebar >» Magic UV » Editor 


Enhancement >» UV Cursor Location 


Set and display UV Cursor (2D Cursor in UV Editor) location. 


Usage 


1. Click check box UV Cursor Location to show UV Cursor 
Location menu. 


2. UV cursor location is displayed, and you can set the new 


location as you like. 


UV Bounding Box 


Reference 

Editor: UV Editor 

Menu: UVs >» UV Bounding Box 
Panel: Sidebar >» Magic UV » Editor 


Enhancement » UV Bounding Box 


Transform UV with Bounding Box like a Photoshop/GIMP’s 
Bounding Box. 


Uniform Scaling 
If enabled, you can transform uniformly. 


Boundary 
Specifies the boundary of the bounding box. 


Usage 


1. Click check box UV Bounding Box to show UV Bounding 


Box menu. 
2. Click Show to show the bounding box. 


3. Transform UV with the bounding box as you like (You can 


transform UV same as Photoshop/Gimp). 
4. Click Hide. 


UV Inspection 


Reference 


Editor: UV Editor 
Menu: UVs > Inspect UV 
Panel: Sidebar >» Magic UV » Editor 


Enhancement » UV Inspection 


Inspect UV 


Inspect UV and help you to find which UV is on the abnormal 
condition. 


Overlapped 
The overlapped part/face is enhanced. 
Flipped 
The flipped part/face is enhanced. 
Mode 
Part: Enhance only to the overlapped/flipped 
part. 
Face: Enhance the overlapped/flipped face. 


Same Polygon Threshold 
Provides a way to set a threshold for judging the same 
polygons. 


Display View3D 


Display overlapped/flipped faces on View3D as well as UV 
Editor. 


Usage 


1. Click check box UV Inspection to show UV Inspection 
menu. 


2. Click Show to enhance the part on which is under 
specific condition. 
3. Click Update if you want to update to the latest status. 


4. Click Hide. 


Paint UV island 


Paint UV island with random color. 


Usage 


1. Click check box UV Inspection to show UV Inspection 


menu. 


2. Click Paint UV island. 


Other Resources 


The supplemental documentation (e.g. FAQ) and early 
release can be found in Magic UV’s Github repository. 


Reference 


Category: 
Description: 


Location: 
File: 


Author: 


License: 
Note: 


UV 

UV tool set. See add-ons preferences for 
details. 

3D Viewport > Sidebar >» Edit and UV 
Editor -> Sidebar —> Magic UV 
magic_uv folder 

Nutti, Mifth, Jace Priester, kgeogeo, 
mem, imdjs, Keith (Wahooney) Boshoff, 
McBuff, MaxRobinot, Alexander Milovsky 
GPL 3+ 

This add-on is bundled with Blender. 


Video Tools 


Important 


Work In Progress 


ToDo. 


e Refine Tracking Solution 


Refine Tracking Solution 


When solving for camera motion, narrowing down the solve 
error by hand can be a really frustrating task. Setting the 
track weight according to the reprojection error solve this 
issue for camera motion tracking. This add-on automatically 
sets the weight of all tracks according to the error in a single 
Click. 


Basically this allow you to choose the wanted solution error 
and get it within a single click, even with poor tracks 
(stemming from for example the automatic detected 
feature). 


It is perfectly suited for automatically tracked movies, with 
many tracks (motion flow like solving). Even a bad track 
may have a good influence with the correct weight. 


Activation 


e Open Blender and go to Preferences then the Add-ons 
tab. 

e Click Video Tools then Refine tracking solution to enable 
the script. 


Usage 


1. Start to solve your motion as usually. 
2. Choose your target solution error, e.g: 0.3. 
3. Refine your camera motion path solution. 


Reference 


Category: 


Description: 


Location: 


File: 
Author: 
Note: 


Video Tools 

Refine motion solution by setting track 
weight according to reprojection error. 
Clip Editor >» Tools >» Solve > Refine 
Solution 

Space clip editor refine solution.py 
Stephen Leger 

This add-on is bundled with Blender. 


Advanced 


This chapter covers advanced use (topics which may not be 
required for typical usage). 


Command Line 

Scripting & Extending Blender 
Application Templates 
Keymap Customization 
Working_Limits 

Operators 


Blender’s Directory Layout 
Appendices 


Command Line 


Introduction 

e Launching from the Command Line 
o Linux 
° macOS 
o Windows 

« Command Line Arguments 

« Command Line Rendering 


Introduction 


The Console Window, also called a Terminal, is an operating 
system text window that displays messages about Blender’s 
operations, status, and internal errors. 


When Blender is manually started from a terminal, Blender 
output is shown in the Console Window it is started from. 


Use Cases: 


e For rendering animation. 

e For automation and batch processing which require 
launching Blender with different arguments. 

e For Python development, to see the output of the print() 
function. 

e If Blender exits unexpectedly, the messages may 
indicate the cause or error. 

e When troubleshooting, to see the output of --debug 
messages. 


See: Launching from the Command Line for specific 
instructions on launching Blender from the command line. 


Tip 
Closing the Blender Console Window 


Closing the Console Window will also close Blender, losing 
any unsaved work. 


Launching from the 
Command Line 


Linux 
Quick Start 


Open a terminal, then go to the directory where Blender is 
installed, and run Blender like this: 


cd <blender installation directory> 
./blender 


If you have Blender installed in your PATH (usually when 
Blender is installed through a distribution package), you can 
Simply run: 


blender 


Details 


Depending on your desktop environment setup, a Blender 
ICON may appear on your desktop or an entry for Blender is 
added to your menu after you install Blender. 


Many desktop environments support the ability to “Run in 
terminal”. 


mera KDE Menu Editor v,aA®@ 


File Edit Settings Help 


Save fe Newltem = NewSubmenu — New Separator “\ Move Up \ Move Down &% Cut > 


@ Inkscape (Vector Graphics Editor) 3 General Advanced 
® Krita (Digital Painting) 
B Luminance HDR (HDR imaging tool) Work path: in| 
& skanlite (Image Scanning Applicat... 
od aes {B) Run in terminal 
® Dia (Diagram Editor) 
@ Geegie (Image Viewer) Terminal options: 
# GNU Image Manipulation Program... 
© Gwenview (KDE Image Viewer) = 
te imagemagick Wieplay ate) {|_| Run as a different user 
[2 KSnapshot (Screen Capture Progra... 
@ LibreOffice Draw (Drawing Program) 


WB Okular (Document Viewer) 


Current shortcut key: f None a 
~ More Applications 

> @ Internet 

Ly MRM nauitimadia Cd 


Configuring the KDE menu icon to start Blender from 
a terminal. 


This screenshot shows Blender started from a Linux Terminal 
and the resulting text output written to it: 


sybren : blender — Konsole 


File Edit View Bookmarks Settings Help 


sybren@ws-sybren ~ 

% blender 

Cannot connect to server socket err = No such file or directory 

Cannot connect to server request channel 

jack server is not running or cannot be started 

JackShmReadWritePtr: :~JackShmReadWritePtr - Init not done for 4294967295, skipping unlock 
JackShmReadwWritePtr: :~JackShmReadwWritePtr - Init not done for 4294967295, skipping unlock 
AL lib: (WW) ALCjackBackendFactory_init: jack_client_open() failed, 0x11 

AL lib: (WW) alc_initconfig: Failed to initialize backend "jack" 


a sybren : blender 


Starting Blender from a Linux terminal window. 


macOS 
Quick Start 


Open the terminal application, and run the executable 
within the app bundle, with commands like this: 


cd /Applications/Blender.app/Contents/Mac0OS 
./Blender 


If you need to do this often, you can add this directory to 
your PATH. 


For that you can run the following procedure: 


. Open up a Terminal. 

. Run the following command: sudo nano /etc/paths. 

. Enter your password, when prompted. 

. Go to the bottom of the file, and enter 
/Applications/Blender.app/Contents/MacOS. 

. Enter ctri-x to quit. 

6. Enter y to save the modified buffer. 
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If you then open a new terminal, the following command will 
work: 


Blender 


Details 


macOS uses “files” with the .app extension called 
applications. These files are actually folders that appear as 
files in Finder. In order to run Blender you will have to 


specify that path to the Blender executable inside this 
folder, to get all output printed to the terminal. You can start 
a terminal from Applications » Utilities. The path to the 
executable in the .app folder is 
./Blender.app/Contents/Mac0S/Blender. 


If you have Blender installed in the Applications folder, the 
following command can be used: 


/Applications/Blender.app/Contents/MacOS/Blender 


_jj user — bash 113x18 


Last login: Sun Oct 14 10:59:42 on ttys@05 
hostname:~ user$ /Applications/blender-2.64/blender.app/Contents/MacOS/blender 
ndof: 3Dx driver not found 


found bundled python: /Applications/blender-2.64/blender.app/Contents/Mac0S/2.64/python 


Starting Blender from a macOS console window. 


Windows 
Quick Start 


Open the Command Prompt, go to the directory where 
Blender is installed, and then run Blender: 


cd c:\<blender installation directory> 
blender 


You can also add the Blender folder to your system PATH So 
that you do not have to cd to it each time. 


Details 


When Blender is started on a Microsoft Windows operating 
system, the Console Window (called the Command Prompt) 
is first created as a separate window on the desktop. The 
main Blender window will also appear and the Console 
Window will then be toggled off. To display the console 
again, go to Window » Toggle System Console. 


To start Blender from the command line you need to open 
an instance of Command Prompt. To do this, type O0SKey-R 
then type cmd; this will open the Command Prompt window. 
You then need to find the path to the Blender executable. If 
you installed Blender via the installer then it can be found 
here: 


C:\Program Files\Blender Foundation\Blender\blender.exe 


G8 Command Prompt 


c:\blender>blender 
: C:\Users\faron\AppData\Roaming\Blender Foundat ion\Blender\2 .??\confi 
len 


found bundled python: c:\blender\2.?7?\python 
read blend: C:\tmpNUincent .blend 


Blender quit 


c:\blender> 


Blender’s Console Window on Microsoft Windows. 


The screenshot shows the Blender Console Window on 
Microsoft Windows directly after starting Blender and then a 


Short while later after opening a file along with the relevant 
messages. 


Command Line Arguments 


Blender 3.4 Usage: blender [args ...] [file] [args ...] 


Render Options 


-b, --background 
Run in background (often used for Ul-less rendering). 


-a, --render-anim 
Render frames from start to end (inclusive). 


-S, --scene <name> 
Set the active scene <name> for rendering. 


-f, --render-frame <frame> 
Render frame <frame> and Save it. 


e +<frame> Start frame relative, -<frame> end frame 
relative. 

e Acomma separated list of frames can also be used 
(NO spaces). 

e Arange of frames can be expressed using .. 
separator between the first and last frames 
(inclusive). 


-Ss, --frame-start <frame> 


Set start to frame <frame>, Supports +/- for relative frames 
too. 


-e, --frame-end <frame> 
Set end to frame <frame>, Supports +/- for relative frames 
too. 


-j, --frame-jump <frames> 
Set number of frames to step forward after each 
rendered frame. 


-O, --render-output <path> 
Set the render path and file name. Use // at the start of 
the path to render relative to the blend-file. 


The # characters are replaced by the frame number, and 
used to define zero padding. 


e animation ## test.png becOMeS animation 01 test.png 
e test-######.png DeECOMES test-000001.png 
When the filename does not contain #, The suffix #### is 
added to the filename. 


The frame number will be added at the end of the 
filename, eg: 


blender -b animation.blend -o //render_ -F PNG -x 1 -a 


//render_ becomes //render ####, writing frames as 
//render_ 0001.png 


-E, --engine <engine> 
Specify the render engine. Use -E help to list available 
engines. 


-t, --threads <threads> 


Use amount of <threads> for rendering and other 
operations [1-64], 0 for systems processor count. 


Format Options 


-F, --render-format <format> 


Set the render format. Valid options are: TGA RAWTGA JPEG 
IRIS IRIZ AVIRAW AVIJPEG PNG BMP 


Formats that can be compiled into Blender, not available 
on all systems: HDR TIFF OPEN EXR OPEN EXR MULTILAYER MPEG 
CINEON DPX DDS JP2 WEBP 


-x, --use-extension <bool> 
Set option to add the file extension to the end of the file. 


Animation Playback Options 


-a <options> <file(s)> 
Instead of showing Blender’s user interface, this runs 
Blender as an animation player, to view movies and 
image sequences rendered in Blender (ignored if -b is 
Set). 


Playback Arguments: 


-p <SX> <Sy> 
Open with lower left corner at <sx>, <sy>. 


-m 


Read from disk (Do not buffer). 


-f <fps> <fps-base> 
Specify FPS to start with. 


-j <frame> 
Set frame step to <frame>. 


-s <frame> 
Play from <frame>. 


-e <frame> 


Play until <frame>. 


-c <cache_memory> 
Amount of memory in megabytes to allow for caching 
images during playback. Zero disables (clamping to a 
fixed number of frames instead). 


Window Options 


-w, --window-border 
Force opening with borders. 


-W, --window- fullscreen 
Force opening in fullscreen mode. 


-p, --window-geometry <sx> <sy> <w> <h> 
Open with lower left corner at <sx>, <sy> and width and 
height as <w>, <h>. 


-M, --window-maximized 
Force opening maximized. 


-con, --start-console 
Start with the console window open (ignored if -b is set), 
(Windows only). 


--no-native-pixels 
Do not use native pixel size, for high resolution displays 
(MacBook Retina). 


- -no-window- focus 
Open behind other windows and without taking focus. 


Python Options 


-y, --enable-autoexec 
Enable automatic Python script execution (default). 


-Y, --disable-autoexec 
Disable automatic Python script execution (pydrivers & 
startup scripts). 


-P, --python <filepath> 
Run the given Python script file. 


--python-text <name> 
Run the given Python script text block. 


--python-expr <expression> 
Run the given expression as a Python script. 


--python-console 
Run Blender with an interactive console. 


--python-exit-code <code> 
Set the exit-code in [0..255] to exit if a Python exception 
is raised (only for scripts executed from the command 
line), zero disables. 


--python-use-system-env 
Allow Python to use system environment variables such 
aS PYTHONPATH and the user site-packages directory. 


--addons <addon(s)> 
Comma separated list (no spaces) of add-ons to enable in 
addition to any default add-ons. 


Logging Options 


-- log <match> 


Enable logging categories, taking a single comma 
separated argument. Multiple categories can be matched 
using a .* suffix, SO --log "wm.*" logs every kind of 
window-manager message. Sub-string can be matched 
using a * prefix and suffix, SO --log "*undo*" logs every 
kind of undo-related message. Use “*” prefix to ignore, 
SO --log "*,*wm.operator.*" logs all except for 
wm.operators.* Use “*” to log everything. 


--log-level <level> 


Set the logging verbosity level (higher for more details) 
defaults to 1, use -1 to log all levels. 


-- Log-show-basename 


Only show file name in output (not the leading path). 


-- log-show-backtrace 


Show a back trace for each log message (debug builds 
only). 


-- Log-show-timestamp 
Show a timestamp for each log message in seconds since 
Start. 


--log-file <filepath> 
Set a file to output the log to. 


Debug Options 


-d, --debug 
Turn debugging on. 


e Enables memory error detection 
e Disables mouse grab (to interact with a debugger in 
some cases) 


e Keeps Python’s sys.stdin rather than setting it to 
None 


--debug-value <value> 


Set debug value of <value> on startup. 


--debug-events 


Enable debug messages for the event system. 


--debug- ffmpeg 


Enable debug messages from FFmpeg library. 


--debug-handlers 


Enable debug messages for event handling. 


- -debug- lLibmv 


Enable debug messages from libmv library. 


--debug-cycles 


Enable debug messages from Cycles. 


- -debug-memory 


Enable fully guarded memory allocation and debugging. 


--debug-jobs 


Enable time profiling for background jobs. 


--debug-python 


Enable debug messages for Python. 


--debug-depsgraph 


Enable all debug messages from dependency graph. 


- -debug-depsgraph-eval 


Enable debug messages from dependency graph related 
on evaluation. 


--debug-depsgraph-build 


Enable debug messages from dependency graph related 
on graph construction. 


--debug-depsgraph-tag 


Enable debug messages from dependency graph related 
on tagging. 


- -debug-depsgraph-no-threads 


Switch dependency graph to a single threaded 
evaluation. 


--debug-depsgraph-time 


Enable debug messages from dependency graph related 
on timing. 


--debug-depsgraph-pretty 


Enable colors for dependency graph debug messages. 


- -debug-depsgraph-uuid 


Verify validness of session-wide identifiers assigned to ID 
datablocks. 


--debug-ghost 


Enable debug messages for Ghost (Linux only). 


- -debug-wintab 


Enable debug messages for Wintab. 


- -debug-gpu 


Enable GPU debug context and information for OpenGL 
4.3+. 


- -debug-gpu- force-workarounds 


Enable workarounds for typical GPU issues and disable all 
GPU extensions. 


- -debug-gpu-disable-ssbo 


Disable usage of shader storage buffer objects. 


- -debug-wm 


Enable debug messages for the window manager, shows 
all operators in search, shows keymap errors. 


--debug-xr 


Enable debug messages for virtual reality contexts. 
Enables the OpenXR API validation layer, (OpenXR) 
debug messages and general information prints. 


--debug-xr-time 


Enable debug messages for virtual reality frame 
rendering times. 


--debug-all 


Enable all debug messages. 


--debug-io 


Enable debug messages for I/O (Collada, ...). 


--debug-fpe 


Enable floating-point exceptions. 


--debug-exit-on-error 


Immediately exit when internal errors are detected. 


--disable-crash-handler 


Disable the crash handler. 


--disable-abort-handler 


Disable the abort handler. 


--verbose <verbose> 


Set the logging verbosity level for debug messages that 
Support it. 


Misc Options 


--open-last 
Open the most recently opened blend file, instead of the 
default startup file. 


--app-template <template> 
Set the application template (matching the directory 
name), use default for none. 


--factory-startup 
Skip reading the startup.blend in the users home 
directory. 


--enable-event-simulate 
Enable event simulation testing feature 
bpy.types.Window.event simulate. 


--env-system-datafiles 
Set the BLENDER SYSTEM DATAFILES environment variable. 


--env-system-scripts 
Set the BLENDER SYSTEM SCRIPTS environment variable. 


--env-system-python 
Set the BLENDER SYSTEM PYTHON environment variable. 


-noaudio 
Force sound system to None. 


-setaudio 
Force sound system to a specific device. None SDL OpenAL 
CoreAudio JACK PulseAudio WASAPI. 


-h, --help 
Print this help text and exit. 


/? 
Print this help text and exit (Windows only). 


-R 
Register blend-file extension, then exit (Windows only). 


-V 
Silently register blend-file extension, then exit (Windows 
only). 

-v, --version 


Print Blender version and exit. 


End option processing, following arguments passed 
unchanged. Access via Python’s sys.argv. 


Other Options 


--debug-freestyle 
Enable debug messages for Freestyle. 


--gpu-backend 
Force to use a Specific GPU backend. Valid options: 


Argument Parsing 


Arguments must be separated by white space, eg: 


blender -ba test.blend 


...Will exit since -ba is an unknown argument. 


Argument Order 


Arguments are executed in the order they are given. eg: 


blender --background test.blend --render-frame 1 --render- 
output ‘/tmp' 


...Will not render to /tmp because --render-frame 1 renders 
before the output path is set. 


blender --background --render-output /tmp test.blend --render- 
frame 1 


...Will not render to /tmp because loading the blend-file 
overwrites the render output that was set. 


blender --background test.blend --render-output /tmp --render- 
frame 1 


...works as expected. 


Environment Variables 


BLENDER_USER_ RESOURCES: 
Top level directory for user files. (other 
BLENDER USER * variables override when 
set). 
BLENDER_USER_ CONFIG: 
Directory for user configuration files. 
BLENDER_USER SCRIPTS: 
Directory for user scripts. 
BLENDER_USER _DATAFILES: 
Directory for user data files (icons, 
translations, ..). 
BLENDER SYSTEM RESOURCES: 
Top level directory for system files. (other 
BLENDER SYSTEM * variables override when 
set). 
BLENDER_SYSTEM SCRIPTS: 


Directory for system wide scripts. 
BLENDER_SYSTEM DATAFILES: 

Directory for system wide data files. 
BLENDER_SYSTEM PYTHON: 

Directory for system Python libraries. 


OCIO: Path to override the OpenColorlO config 
file. 
TEMP: Store temporary files here. 


TMP: or $TMPDIR Store temporary files here. 


Command Line Rendering 


In some situations we want to increase the render speed, 
access Blender remotely to render something or build 
scripts that use the command line. 


One advantage of using the command line is that we do not 
need a graphical display (no need for X server on Linux for 
example) and consequently we can render via a remote 
Shell (typically SSH). 


e See Command Line Arguments for a full list of 
arguments (for example to specify which scene to 
render, the end frame number, etc.), or simply run: 

e See Command Line Launching for specific instructions 
on launching Blender from the command line. 


blender --help 
Note 
Arguments are executed in the order they are given! 


The following command will not work, since the output and 
extension are set after Blender is told to render: 


blender -b file.blend -a -x 1 -o //render 
The following command will behave as expected: 
blender -b file.blend -x 1 -o //render -a 


Always position -f or -a as the last arguments. 


Single Image 
blender -b file.blend -f 10 


-b 
Render in the background (without Ul). 


file.blend 
Path to the blend-file to render. 


-f 10 
Render only the 10th frame. 


blender -b file.blend -o /project/renders/frame ##### -F 
OPEN EXR -f -2 


-o /project/renders/frame ##### 
Path of where to save the rendered image, using five 
padded zeros for the frame number. 


1 
nh 


OPEN _EXR 
Override the image format specified in the blend-file and 
save to an OpenEXR image. 


=f =2 
Render only the second last frame. 


Warning 


Arguments are case sensitive! -F and -f are not the same. 


Animation 


blender -b file.blend -a 


-a 
Render the whole animation using all the settings saved 
in the blend-file. 


blender -b file.blend -E CYCLES -s 10 -e 500 -t 2 -a 


-E CYCLES 
Use the “Cycles Render” engine. For a list of available 
render engines, run blender -E help. 


-s 10 -e 500 
Set the start frame to 10 and the end frame to 500. 


=i 2 
Use only two threads. 


Cycles 


In addition to the options above, which apply to all render 
engines, Cycles has additional options to further control its 
behavior. 


blender -b file.blend -f 20 -- --cycles-device CPU 
Note 


Unlike the generic options, the Cycles-specific ones must 
be passed on the end of the command line, following a 
double dash. 


--cycles-device CPU 
Override the device that is used to render frames. 
Currently supported options are CPU, CUDA, OPTIX, HIP, 
ONEAPI, and METAL. Additionally, you can append +cPu to 
any GPU type for hybrid rendering. 


--cycles-print-stats 
Show detailed statistics about memory and time usage 
for Cycles renders on the console. 
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Introduction 


Python is an interpreted, interactive, object-oriented 
programming language. It incorporates modules, 
exceptions, dynamic typing, very high-level dynamic data 
types, and classes. Python combines remarkable power with 
very clear syntax. 


Python scripts are a versatile way to extend Blender 
functionality. Most areas of Blender can be scripted, 
including animation, rendering, import and export, object 
creation and automating repetitive tasks. 


To interact with Blender, scripts can make use of the tightly 


General Information 


Links that are useful while writing scripts: 


e Python.org - General information about Python. 

e Blender Python API - Official AP! documentation. Use 
this for referencing while writing scripts. 

e API Introduction - A short introduction to get you started 
with the API. Contains examples. 


Links that deal with distributing your scripts: 


e Sharing scripts - Information on how to share your 
scripts and get them included in the official Blender 
distribution. 

Creating_Add-ons - Add-ons are used to encapsulate and 
distribute scripts. 


e Add-ons project - Project to maintain a central 
repository of extensions to Blender. 


Getting Started 


Manual links 


The following links take you from the basics to the more 
advanced concepts of Python scripting for Blender. 


e Text Editor 
e Python Console 
e Info Editor 


External links 


Here are external links containing a lot of good information 
to start learning how to write scripts for Blender: 


e Python APL Quickstart 

e CG Cookie: Blender 2.8 Python Scripting Superpowers 
for Non-Programmers 

e Olav3D Tutorials: 3D Programming for Beginners Using 
Python 

e Blender Artists: Python Support Forum 


Extending Blender 


Add-ons 


Add-ons are scripts that enable Blender to gain extra 
functionality; they can be enabled from the Preferences. 


Outside of the Blender executable, there are hundreds of 
add-ons written by many people: 


e Officially supported add-ons are bundled with Blender. 

e Other Testing add-ons are included in development 
builds of Blender but not official releases. Many of them 
work reliably and are very useful but are not yet 
ensured to be stable for release. 


See also 


See Add-ons for documentation on add-ons included with 
Blender. 


Scripts 


Apart from add-ons, there are several other types of scripts 
that extend Blender’s functionality: 


Modules: Utility libraries for import into other 
scripts. 

Presets: Settings for Blender’s tools and key 
configurations. 

Startup: These files are imported when starting 


Blender. They define most of Blender’s UI, 
as well as some additional core operators. 


Custom Scripts: 
In contrast to add-ons, they are typically 
intended for one-time execution via the 


Text Editor. 
Saving your own Scripts 


File Location 


All scripts are loaded from the scripts folder of the local, 
system and user paths. 


You can setup an additional search path for scripts in File 
Paths Preferences » File Paths. 


Installation 


Add-ons are conveniently installed through Blender in the 
Preferences. Click the /nstal/... button and select the .py or 
.zip file. 


To manually install scripts or add-ons, place them in the 
addons, modules, presets, Or startup directory according to their 
type. See the description above. 


You can also run scripts by loading them in the Text Editor. 


Scripting & Security 


The ability to include Python scripts within blend-files is 
valuable for advanced tasks such as rigging and 
automation. However, it poses a security risk since Python 
does not restrict what a script can do. Therefore, you should 
only run scripts from sources you know and trust. Automatic 
execution is disabled by default; however, some blend-files 
need this to function properly. 


When a blend-file tries to execute a script and is not 
allowed, a dialog will appear. In it, you can choose to Allow 
Execution or to Ignore the scripts. 


tomatic execution of Python scripts in this file v 
lead to unexpected beh 


Permanent! llow ex 


Allow Execution Ignore 


An Auto-run warning in the Info editor’s header. 


Scripts in Blend-Files 


Auto Execution 


Here are the different ways blend-files may automatically 
run scripts. 


Registered Text-Blocks 


A text data-block can have its Register option enabled 
which means it will load on start. 


Animation Drivers 
Python expressions can be used to Drive values and are 
often used in more advanced rigs and animations. 


Manual Execution 


There are other ways scripts in a blend-file may execute 
that require user interaction (therefore will run even when 
auto execution is off), but you should be aware that this is 
the case since it is not necessarily obvious. 


e Running a script in the Text editor. 
e Rendering with Freestyle, because Freestyle uses scripts 
to control line styles. 


Controlling Script Execution 


Blender provides a number of ways to control whether 
scripts from a blend-file are allowed to automatically 
execute. 


First, the File Browser has the option Trusted Source which 
you can use on a case-by-case basis to control auto 
execution. Since you may forget to set this, or may open a 
file without going through the File Browser, you can change 
the default (described next). 


Setting Defaults 


In the Preferences, there is the toggle to Auto Run Python 
Scripts. This means the Trusted Source option in the File 


Browser will be enabled by default, and scripts can run 
when blend-files are loaded without using the File Browser. 
Once enabled you have the option to exclude certain 
directories; a typical configuration would be to trust all 
paths except for the download directory. 


v Auto Run Python Scripts 


The Auto Run Python Scripts checkbox. 


Command Line 


You may want to perform batch rendering or some other 
task from the command line, running Blender without an 
interface. In this case, the Preferences are still used but you 
may want to override them: 


e Enable with -y or --enable-autoexec 
e Disable with -yY or --disable-autoexec 


Example 


To render an animation in background mode, allowing 
drivers and other scripts to run: 


blender --background --enable-autoexec my movie.blend --render- 
anim 


Note 


These command-line arguments can be used to start a 
regular Blender instance and will still override the 
Preferences. 


Add-on Tutorial 


Intended Audience 


This tutorial is designed to help technical artists or 
developers learn to extend Blender. An understanding of the 
basics of Python is expected for those working through this 
tutorial. 


Prerequisites 


Before going through the tutorial you should... 


e« Be familiar with the basics of working in Blender. 

e Know how to run a script in Blender’s Text editor. 

e Have an understanding of Python primitive types 
(integer, Boolean, string, list, tuple, dictionary, and set). 
Be familiar with the concept of Python modules. 

Have a basic understanding of classes (object 
orientation) in Python. 


Suggested reading before starting this tutorial. 


e Dive Into Python sections (1, 2, 3, 4, and 7). 
e Blender API Quickstart to help become familiar with 
Blender/Python basics. 


To best troubleshoot any error message Python prints while 


writing scripts, you run Blender from a terminal. See Use 
The Terminal. 


Tip 


You can enable Developer Extras in the preferences to 
enable features that make developing add-ons easier. 


Documentation Links 


While going through the tutorial, you may want to look into 
our reference documentation. 


e Blender API Overview: This document is rather detailed 
but helpful if you want to Know more on a topic. 

e bpy.context API reference - Handy to have a list of 
available items your script may operate on. 


operators, these docs give details and more examples of 
operators. 


What is an Add-on? 


An add-on is simply a Python module with some additional 
requirements so Blender can display it in a list with useful 
information. 


To give an example, here is the simplest possible add-on: 


bl_info = { 
"name": "My Test Add-on", 
"blender": (2, 80, 0), 
"category": "Object", 


def register(): 
print("Hello World") 

def unregister(): 
print("Goodbye World") 


bl_info 


is a dictionary containing add-on metadata such as the 
title, version and author to be displayed in the 
Preferences add-on list. It also specifies the minimum 
Blender version required to run the script; older versions 
won't display the add-on in the list. 


register 
is a function which only runs when enabling the add-on, 
this means the module can be loaded without activating 
the add-on. 


unregister 
is a function to unload anything setup by register, this is 
called when the add-on is disabled. 


Notice this add-on does not do anything related to Blender 
(the blender_api:bpy module is not imported for example). 


This is a contrived example of an add-on that serves to 
illustrate the point that the base requirements of an add-on 
are simple. 


An add-on will typically register operators, panels, menu 
items, etc, but it’s worth noting that any script can do this, 
when executed from the Text editor or even the interactive 
console - there is nothing inherently different about an add- 
on that allows it to integrate with Blender, such functionality 
is just provided by the blender_api:bpy module for any script 
to access. 


So an add-on is just a way to encapsulate a Python module 
in a way a user can easily utilize. 


Note 


Running this script within the Text editor won’t print 
anything, to see the output it must be installed through 


the Preferences. Messages will be printed when enabling 
and disabling. 


Your First Add-on 


The simplest possible add-on above is useful as an example 
but not much else. This next add-on is simple but shows 
how to integrate a script into Blender using an Operator 
which is the typical way to define a tool accessed from 
menus, buttons and keyboard shortcuts. 


For the first example we will make a script that simply 
moves all objects in a scene. 


Write the Script 


Add the following script to the Text editor in Blender: 
import bpy 
scene = bpy.context.scene 


for obj in scene.objects: 
obj. location.x += 1.0 


Click the Run Script button, all objects in the active scene 
are moved by 1.0 unit. 


Write the Add-on (Simple) 


This add-on takes the body of the script above, and adds it 
to an operator’s execute() function. 


bl_info = { 
"name": "Move X Axis", 
"blender": (2, 80, 0), 


"category": "Object", 
} 


import bpy 


class ObjectMoveX(bpy.types.Operator): 


"""My Object Moving Script""" # Use this as a tooltip 
for menu items and buttons. 

bl_idname = "“object.move x" # Unique identifier for 
buttons and menu items to reference. 

bl_ label = "Move X by One" # Display name in the 
interface. 


bl options = {'REGISTER', 'UNDO'} # Enable undo for the 
operator. 


def execute(self, context): # execute() is called 
when running the operator. 


# The original script 

scene = context.scene 

for obj in scene.objects: 
obj.location.x += 1.0 


return {'FINISHED' } # Lets Blender know the 
operator finished successfully. 


def menu _func(self, context): 
self.layout.operator(ObjectMovex.bl idname) 


def register(): 
bpy.utils.register class (0ObjectMovex) 
bpy.types.VIEW3D MT object.append(menu func) # Adds the 
new operator to an existing menu. 


def unregister(): 
bpy.utils.unregister class (0bjectMovex) 


# This allows you to run the script directly from Blender's 
Text editor 
# to test the add-on without having to install it. 


if name ==" main_": 
register() 


Note 


bl_info is split across multiple lines, this is just a style 
convention used to more easily add items. 


Note 


Rather than using bpy.context.scene, we use the 
context.scene argument passed to execute(). In most cases 
these will be the same. However in some cases, operators 
will be passed a custom context so script authors should 
prefer the context argument passed to operators. 


To test the script, you can copy and paste it into Blender’s 
Text editor and run it. This will execute the script directly 
and call register immediately. 


However running the script won’t move any objects. For 
this, you need to execute the newly registered operator. 


Operator Search menu. 


Open the Operator Search menu and type in “Move X by 
One” (the bl label), then Return. 


The objects should move as before. 


Keep this add-on open in Blender for the next step - 
Installing. 


Install the Add-on 


Once you have your add-on within in Blender’s Text editor, 
you will want to be able to install it so it can be enabled in 
the Preferences to load on startup. 


Even though the add-on above is a test, let’s go through the 
steps anyway so you know how to do it for later. 


To install the Blender text as an add-on, you will first have to 
Save it on drive. Take care to obey the naming restrictions 
that apply to Python modules and end with a .py extension. 


Once the file is on drive, you can install it as you would for 
an add-on downloaded online. 


Open the Preferences » Add-ons » Install... and select the 
file. 


Now the add-on will be listed and you can enable it by 
pressing the checkbox, if you want it to be enabled on 
restart, press Save as Default. The operator can be run in 
the same way as described in the previous section. 


When the add-on is enabled, Blender executes the code and 
runs the register() function. When the add-on is disabled, 
Blender runs the unregister() function. 


Note 


The destination of the add-on depends on your Blender 
configuration. When installing an add-on the source and 
destination paths are printed in the console. You can also 
find add-on path locations by running this in the Python 
Console: 


import addon_utils 
print(addon utils.paths()) 


More is written on this topic here: Directory Layout. 


Your Second Add-on 


For our second add-on, we will focus on object instancing - 
this is - to make linked copies of an object in a similar way 
to what you may have seen with the Array modifier. 


Write the Script 


As before, first we will start with a script, develop it, then 
convert it into an add-on. 


import bpy 
from bpy import context 


# Get the current scene 
scene = context.scene 


# Get the 3D cursor location 
cursor = scene.cursor. location 


# Get the active object (assume we have one) 
obj = context.active object 


# Now make a copy of the object 
obj new = obj.copy() 


# The new object has to be added to a collection in the scene 
scene.collection.objects.link(obj new) 


# Now we can place the object 
obj new. location = cursor 


Now try copying this script into Blender and run it on the 
default Cube. Make sure you click to move the 3D cursor 
before running as the duplicate will appear at the cursor’s 
location. 


After running, notice that when you go into Edit Mode to 
change the Cube - all of the copies change. In Blender, this 
is known as Linked Duplicates. 


Next, we’re going to do this in a loop, to make an array of 
objects between the active object and the cursor. 


import bpy 
from bpy import context 


scene = context.scene 
cursor = scene.cursor. location 
obj = context.active object 


# Use a fixed value for now, eventually make this user 
adjustable 
total = 10 


# Add ‘total' objects into the scene 

for i in range(total): 
obj new = obj.copy() 
scene.collection.objects.link(obj_ new) 


# Now place the object in between the cursor 
# and the active object based on '‘i' 
factor = i / total 


obj _new.location = (obj.location * factor) + (cursor * (1.0 
- factor) ) 


Try running this script with the active object and the cursor 
Spaced apart to see the result. 


With this script you’ll notice we’re doing some math with the 
object location and cursor, this works because both are 3D 
mathutils.Vector instances, a convenient class provided by 
the mathutils module which allows vectors to be multiplied 
by numbers and matrices. 


If you are interested in this area, read into mathutils.Vector - 
there are many handy utility functions such as getting the 
angle between vectors, cross product, dot products as well 
as more advanced functions in mathutils.geometry Such as 
Bézier spline interpolation and ray-triangle intersection. 


For now we will focus on making this script an add-on, but 
it’s good to know that this 3D math module is available and 
can help you with more advanced functionality later on. 


Write the Add-on 


The first step is to convert the script as-is into an add-on: 


bl_info = { 
"name": "Cursor Array", 
"blender": (2, 80, 0), 
"category": "Object", 

} 


import bpy 


class ObjectCursorArray(bpy.types.Operator) : 
"""Object Cursor Array""" 
bl_idname = "object.cursor_ array" 


bl_ label = "Cursor Array" 
bl options = {'REGISTER', ‘UNDO'} 


def execute(self, context): 
scene = context.scene 
cursor = scene.cursor. location 
obj = context.active object 


total = 10 


for i in range(total): 
obj new = obj.copy() 
scene.collection.objects.link(obj_ new) 


factor = i / total 
obj new.location = (obj.location * factor) + 
(cursor * (1.0 - factor) ) 


return {'FINISHED'} 


def register(): 
bpy.utils.register class(ObjectCursorArray) 


def unregister(): 
bpy.utils.unregister class(ObjectCursorArray) 


if name ==" main | 
register() 


Everything here has been covered in the previous steps, you 
may want to try run the add-on still and consider what could 
be done to make it more useful. 


The two of the most obvious missing things are - having the 
total fixed at 10, and having to access the operator with 
Search is not very convenient. 


Both these additions are explained next, with the final script 
afterwards. 


Operator Property 


There are a variety of property types that are used for tool 
settings, common property types include: int, float, vector, 
color, Boolean and string. 


These properties are handled differently to typical Python 
class attributes because Blender needs to display them in 
the interface, store their settings in keymaps and keep 
settings for reuse. 


While this is handled in a fairly Pythonic way, be mindful 
that you are in fact defining tool settings that are loaded 
into Blender and accessed by other parts of Blender, outside 
of Python. 


To get rid of the literal 10 for total, we’ll use an operator 
property. Operator properties are defined via bpy.props 
module, this is added to the class body: 


# moved assignment from execute() to the body of the class... 
total: bpy.props.IntProperty(name="Steps", default=2, min=1, 
max=100) 


# and this is accessed on the class 
# instance within the execute() function as... 
self.total 


Blender when the class is registered so they display as 
buttons in the user interface. There are many arguments 
you can pass to properties to set limits, change the default 
and display a tooltip. 


See also 


This document doesn’t go into details about using other 
property types. However, the link above includes examples 
of more advanced property usage. 


Menu Item 


Add-ons can add to the user interface of existing panels, 
headers and menus defined in Python. 


For this example we’ll add to an existing menu. 


(1) Cube 


@ Object Mode + 


[> 


Menu Identifier. 


To find the identifier of a menu, first enable Python Tooltips 
in the preferences. Then you can hover your mouse over the 
menu item and the identifier is displayed. 


The method used for adding a menu item is to append a 
draw function into an existing class: 


def menu func(self, context): 
self. layout.operator(ObjectCursorArray.bl idname) 


def register(): 


bpy.utils.register class(ObjectCursorArray) 
bpy.types.VIEW3D MT object.append(menu_ func) 


Keymap 


In Blender, add-ons have their own keymaps so as not to 
interfere with Blender’s built-in keymaps. 


which references our newly added operator, using Shift- 
Ctri-T as the key shortcut to activate it. 


# store keymaps here to access after registration 
addon keymaps = [] 


def register(): 


# handle the keymap 

wm = bpy.context.window manager 

km = wm.keyconfigs.addon.keymaps.new(name='Object Mode', 
space _type='EMPTY' ) 


kmi = km. keymap items.new(ObjectCursorArray.bl idname, 'T', 
'PRESS', ctrl=True, shift=True) 
kmi.properties.total = 4 


addon keymaps.append((km, kmi) ) 


def unregister(): 


# handle the keymap 

for km, kmi in addon keymaps: 
km.keymap items. remove(km1) 

addon keymaps.clear() 


Notice how the keymap item can have a total setting 
different than the default set by the operator, this allows 
you to have multiple keys accessing the same operator with 
different settings. 


Note 


While Shift-Ctrl-T is not a default Blender key shortcut, it 
is hard to make sure add-ons will not overwrite each 
other’s keymaps. Thus at least take care when assigning 
keys that they do not conflict with important functionality 
of Blender (see also Is Key Free). 


For API documentation on the functions listed above, see: 


e bpy.types.KeyMaps.new() 


e bpy.types.KeyMap 


e bpy.types.KeyMapItems.new() 


e bpy.types.KeyMapItem 


Bringing It All Together 


bl_info = { 
"name": "Cursor Array", 
‘plender:: (25. 30; 0), 
"category": "Object", 

} 


import bpy 


class ObjectCursorArray(bpy.types.Operator) : 
"""Object Cursor Array""" 
bl_idname = "object.cursor_ array" 
bl_ label = "Cursor Array" 
bl options = {'REGISTER', ‘UNDO'} 


total: bpy.props.IntProperty(name="Steps", default=2, 
min=1, max=100) 


def execute(self, context): 
scene = context.scene 
cursor = scene.cursor. location 
obj = context.active object 


for i in range(self.total): 
obj new = obj.copy() 
scene.collection.objects.link(obj_ new) 


factor = i / self.total 
obj new.location = (obj.location * factor) + 
(cursor * (1.0 - factor) ) 


return {'FINISHED'} 


def menu func(self, context): 
self.layout.operator(ObjectCursorArray.bl_ idname) 


# store keymaps here to access after registration 
addon keymaps = [] 


def register(): 
bpy.utils.register class(ObjectCursorArray) 
bpy.types.VIEW3D MT object.append(menu_ func) 


# handle the keymap 
wm = bpy.context.window manager 
# Note that in background mode (no GUI available), 
keyconfigs are not available either, 
# so we have to check this to avoid nasty errors in 
background case. 
kc = wm.keyconfigs.addon 
if kc: 
km = wm.keyconfigs.addon.keymaps .new(name='Object 
Mode', space _type='EMPTY' ) 
kmi = km. keymap items.new(ObjectCursorArray.bl idname, 
'T', 'PRESS', ctrl=True, shift=True) 
kmi.properties.total = 4 
addon keymaps.append((km, kmi) ) 


def unregister(): 

# Note: when unregistering, it's usually good practice to 
do it in reverse order you registered. 

# Can avoid strange issues like keymap still referring to 
operators already unregistered... 

# handle the keymap 


for km, kmi in addon keymaps: 
km.keymap items. remove(km1i) 
addon keymaps.clear() 


bpy.utils.unregister class(ObjectCursorArray) 


bpy.types.VIEW3D MT object. remove(menu_ func) 


if name ==" main_": 
register() 


Delete 


Delete Global 


Cursor Array 


In the menu. 


Run the script (or save it and add it through the Preferences 
like before) and it will appear in the Object menu. 


Operator Property. 


After selecting it from the menu, you can choose how many 
instances of the cube you want create. 


Note 


Directly executing the script multiple times will add the 
menu each time too. While not useful behavior, there is 
nothing to worry about since add-ons will not register 
themselves multiple times when enabled through the 
Preferences. 


Conclusions 


Add-ons can encapsulate certain functionality neatly for 
writing tools to improve your workflow or for writing utilities 
for others to use. 


While there are limits to what Python can do within Blender, 
there is certainly a lot that can be achieved without having 
to dive into Blender’s C/C++ code. 


The example given in the tutorial is limited, but shows the 
Blender API used for common tasks that you can expand on 
to write your own tools. 


Further Reading 


Blender comes with commented templates which are 
accessible from the Text editor’s header. If you have specific 
areas you want to see example code for, this is a good place 
to start. 


Here are some sites you might like to check on after 
completing this tutorial. 


Blender/Python API Overview - For more background 
details on Blender/Python integration. 

How to Think Like a Computer Scientist - Great info for 
those who are still learning Python. 

Blender Development (Wiki) - Blender Development, 
general information and helpful links. 


DevTalk - Forum where people ask Python development 


questions. 


Application Templates 


Usage 


Application templates are a feature that allows you to define 
a re-usable configuration that can be selected to replace the 
default configuration, without requiring a separate Blender 
installation or overwriting your personal settings. 


Application templates can be selected from the splash 
screen or File » New submenu. When there are no templates 
found the menu will not be displayed on the splash screen. 


New application templates can be installed from the Blender 
Menu. If you would like to keep the current application 
template active on restarting Blender, save your 
preferences. 


Motivation 


In some cases it’s not enough to write a single script or add- 
on, and expect someone to replace their preferences and 
startup file, install scripts and change their keymap. 


The goal of application templates is to support switching to 
a customized configuration without disrupting your existing 
settings and installation. This means people can build their 
own applications on top of Blender that can be easily 
distributed. 


Details 


An application template may define its own: 


Startup File 
The default file to load with this template. 


Preferences 
Only certain preferences from a template are used: 


e Themes. 
e Add-ons. 
e Keymaps. 
e Viewport lighting. 
Splash Screen 
Templates may provide their own splash screen image. 


Python Scripts 
While templates have access to the same functionality as 
any other scripts, typical operations include: 


e Modifying and replacing parts of the user interface. 

e Defining new menus, keymaps and tools. 

e Defining a custom add-on path for template specific 
add-ons. 


Templates also have their own user configuration, so saving 


a startup file while using a template won’t overwrite your 
default startup file. 


Directory Layout 


Templates may be located in one of two locations within the 
scripts directory. 


Template locations: 


{BLENDER USER SCRIPTS}/startup/bl app templates user 


{BLENDER SYSTEM SCRIPTS}/startup/bl app templates system 
User configuration is stored in a subdirectory: 
Without a template: 


./config/startup. blend 
./config/userpref.blend 


With a template: 


./config/{APP_TEMPLATE ID}/startup.blend 
./config/{APP_TEMPLATE ID}/userpref.blend 


See Blender’s Directory Layout for details on script and 
configuration locations. 


Hint 
Troubleshooting Paths 


When creating an application template, you may run into 
issues where paths are not being found. To investigate this 
you can log output of all of Blender’s path look-ups. 


Example command line arguments that load Blender with 
a custom application template (replace my app template with 
the name of your own template): 


blender --log "bke.appdir.*" --log-level -1 --app-template 
my app template 


You can then check the paths where attempts to access 
my app template are made. 


Command Line Access 


Using the command-line arguments you can setup a 
launcher that opens Blender with a specific app template: 


blender --app-template my template 


Template Contents 


Each of the following files can be used for application 
templates but are optional. 


startup.blend 
Factory startup file to use for this template. 


userpref.blend 
Factory preferences file to use for this template. When 
omitted preferences are shared with the default Blender 
configuration. 


(As noted previously, this is only used for a subset of 
preferences). 


splash.png 
Splash screen to override Blender’s default artwork (not 
including header text). Note, this image must be a 
1000x500 image. 


init__.py 
A Python script which must contain register and 
unregister functions. 


Note 


Bundled blend-files startup.blend and userpref.blend are 
considered Factory Settings and are never overwritten. 


The user may save their own startup/preferences while 
using this template which will be stored in their user 
configuration, but only when the template includes its own 
userpref.blend file. 


The original template settings can be loaded using: Load 
Template Factory Settings from the file menu in much the 
same way Load Factory Settings works. 


Template Scripts 


While app templates can use Python scripts, they simply 
have access to the same APIs available for add-ons and any 
other scripts. 


As noted above, you may optionally have an init .pyin 
your app template. This has the following advantages: 


e Changes can be made to the startup or preferences, 
without having to distribute a blend-file. 


e Changes can be made dynamically. 


You could for example - configure the template to check 
the number of processors, operating system and 
memory, then set values based on this. 


e You may enable add-ons associated with your template. 


On activation a register function is called, unregister is called 
when another template is selected. 


As these only run once, any changes to defaults must be 
made via handler. Two handlers you are likely to use are: 


e bpy.app.handlers.load factory preferences post 
e bpy.app.handlers.load factory startup post 


These allow you to define your own “factory settings”, which 
the user may change, just as Blender has it’s own defaults 
when first launched. 


This is an example _ init__.py file which defines defaults for 
an app template to use. 


import bpy 
from bpy.app.handlers import persistent 


@persistent 

def load handler for preferences( ): 
print("Changing Preference Defaults!") 
from bpy import context 


prefs = context.preferences 
prefs.use preferences save = False 


kc = context.window manager.keyconfigs["blender" ] 
kc_prefs = kc.preferences 
if kc_prefs is not None: 
kc_prefs.select_ mouse = 'RIGHT' 
kc prefs.spacebar action = ‘SEARCH’ 
kc_prefs.use pie click drag = True 


view = prefs.view 
view.header_align = ‘BOTTOM’ 


@persistent 
def load handler for startup(_ ): 
print("Changing Startup Defaults!") 


# Use smooth faces. 
for mesh in bpy.data.meshes: 
for poly in mesh.polygons: 
poly.use smooth = True 


# Use material preview shading. 
for screen in bpy.data.screens: 
for area in screen.areas: 
for space in area.spaces: 
if space.type == 'VIEW 3D': 
space.shading.type = 'MATERIAL' 
space.shading.use scene lights = True 


def register(): 
print("Registering to Change Defaults") 


bpy.app.handlers.load factory preferences post.append(load hand 
ler_for_preferences) 


bpy.app.handlers.load factory startup post.append(load handler _ 
for startup) 


def unregister(): 
print("Unregistering to Change Defaults") 


bpy.app.handlers.load factory preferences post.remove(load hand 
ler_for_preferences) 


bpy.app.handlers.load factory startup post. remove(load handler _ 
for startup) 


Keymap Customization 
Keys 


Available Keys 


When customizing keymaps it’s useful to use keys which 
won't conflict with Blender’s default keymap. 


Here are keys which aren’t used and aren’t likely to be used 
in the future. 


F-Keys (F5 - F8) 
These F-keys (including modifier combination) have been 
intentionally kept free for users to bind their own keys to. 


OSKey (alSo Known as the Windows-Key, Cmd Or Super) 
Blender doesn’t use this key for any bindings. 


macOS is an exception, where cmd replaces Ctrl except in 
cases it would conflict with the system’s key bindings. 


Modifier Double Click 
Binding modifier keys as primary keys is supported, to 
avoid conflicts with regular usage you can bind them to 
double click. 


Multi-Action Keys 


Click/Drag 


It’s possible to configure a single key to perform multiple 
operations using Click event instead of Press. Then you may 
bind Drag to a separate action. 


This is useful for mixing actions where one uses a drag 
event, e.g: Toggle a setting using with Tab, drag to opena 
pie menu showing all options related to the setting. 


This is used in the default keymap in the 3D Viewport, Alt - 
MMB dragging in different directions rotates the view. 


Common Operations 


This section lists useful generic operations which can be 
used. 


Key Bindings for Pop-Ups 


Menus and panels can be assigned key shortcuts, even if 
they’re only accessible from submenus elsewhere. 


Open a Pop-up Menu (wm.call_menu) 
Open any menu on key press. 


Open a Pie Menu (wm.call_menu_pie) 
Open any pie menu on key press. 


Open a Panel (wm.call_panel) 
Open a pop-up panel (also Known as a pop-over). 


Menu & Panel Identifiers 


To find the name of a menu, enable the preference Interface > 
Display » Python Tooltips. 


Then hover the cursor over the popover button or menu 
item. For submenus you will need to use the back arrow to 
prevent the submenu from opening and gaining focus. 


Key Bindings for Properties 


There are many properties you might want to bind a key 
with. To avoid having to define operators for each property, 
there are generic operators for this purpose: 


Operators for adjusting properties begin with wm.context_. 
Some of these include: 


e wm.context_toggle toggle a Boolean property. 
e wm.context cycle enum cycle an enum property forwards or 


backwards. 

e wm.context_menu_ enum Show a pop-up menu for an enum 
property. 

e wm.context_ pie enum Show a pie menu for an enum 
property. 


e wm.context scale float scale a number (used for 
increasing / decreasing brush size for example). 

e wm.context_ toggle enum toggle between two options of an 
enum. 

e wm.context_modal_ mouse moving the cursor to interactively 
change a value. 


See bpy.ops.wm for a complete list. 


Each of these operators has a data _ path setting to reference 
the property to change. 


To find the data path, basic Python knowledge is needed. 


For example, you can use the Python Console to access a 
Boolean property you wish to map to a key: 


bpy.context.object.show_name 


To bind this to a key, add a new keymap item using the 
operator wm.context_toggle with data path set to 
object.show_name (notice the bpy.context prefix is implicit). 


See bpy.context for other context attributes. 


The Python API documentation can be used to find 
properties or you may use the Python Console’s auto- 
complete to inspect available properties. 


Working Limits 


Space 


While object positions, vertex locations are not clamped, 
larger values become increasingly imprecise. To get an idea 
of the precision you can work with using different scales. 
Here’s a table of scales and their associated accuracy: 


10: 1/1,048,576 
100: 1/131,072* 
1,000: 1/16,384% 
10,000: 1/1,024th 
100,000: 1/128 
1,000,000: 1/16th 

Hint 


For a rough rule of thumb, values within -5,000/+5,000 are 
typically reliable (range of 10,000). Internally single 
precision floating-point calculations are used. 


Time 


The maximum number of frames for each scene is currently 
1,048,574, and allows for continuous shots for durations of: 


24 fps: 12 hours, 8 minutes. 
25 fps: 11 hours, 39 minutes. 
30 fps: 9 hours, 42 minutes. 


60 fps: 4 hours, 51 minutes. 
Note 


In practice, a finished work is typically composed of output 
from many scenes. So this limit does not prevent you from 
creating longer works. 


Text Fields 


Fixed strings are used internally, and while it is not useful to 
list all limits, here are some common limits. Used for data- 
block names, modifiers, vertex groups, UV layers... 


directory: 767 
file-name: 255 
file-path: 1023 
identifier: 63 
Note 


Multi-byte encoding means some Unicode characters use 
more than a single ASCII character. 


Operators 
Operator Cheat Sheet 


Reference 
Menu: Help >» Operator Cheat Sheet 
Context: Enable Developer Extras 


Creates a text file in the Text Editor that gives a list of all 
operators and their default values in Python syntax, along 
with the generated docs. This is a good way to get an 
overview of all Blender’s operators. 


See also 


Blender’s API documentation 


System Operators 


Reload Scripts 


Reference 
Mode: All Modes 
Menu: Topbar > Blender >» System >» Reload 


Scripts 


Reloads all scripts found in the scripts data folder; any 
changes that have been made in the Text Editor will be lost! 


Memory Statistics 


Reference 


Mode: 


- -debug-memory 
Menu: 


Topbar > Blender >» System » Memory 
Statistics 


This operator which can be found by searching “Memory 
Statistics” with the Operator Search will print useful 


information about memory objects, their size and user 
count. 


Important 


To fully use this operator run Blender from the console with 
--debug-memory. 


Debug Menu 

Reference 

Mode: All Modes 

Menu: Topbar > Blender >» System >» Debug 
Menu 


This operator brings up a menu to set Blender into a certain 
debug mode. 


See the source code for a description of what each value 
does. 


Tip 


Developers can search the code for G.debug_value to find 
other possible uses for this operator. 


Note 


Additional debug options are available by launching 
Blender in debug mode or setting bpy.app.debug = True. 


Redraw Timer 


Reference 
Mode: All Modes 
Menu: Topbar > Blender > System » Redraw 


Timer 


This operator brings up a menu with a list of tests to 


benchmark UI render times along with undo/redo functions. 


Clean Up Space-Data 


Reference 
Mode: All Modes 
Menu: Topbar > Blender > System > Clean Up 


Space-data 


Removes unused settings for invisible editors. 


Blender’s Directory Layout 


This page documents the different directories used by 
Blender (which can be helpful for troubleshooting). 


There are three different directories Blender may use, their 
exact locations are platform dependent. 


LOCAL: Location of configuration and run-time 
data (for self-contained bundle). 

USER: Location of configuration files (typically in 
the user’s home directory). 

SYSTEM: Location of run-time data for system wide 


installation (may be read-only). 


For system installations both SYSTEM and USER directories 
are needed. 


For locally extracted Blender distributions, the user 
configuration and run-time data are kept in the same 
subdirectory, allowing multiple Blender versions to run 
without conflict, ignoring the USER and SYSTEM files. This 
requires you to create a folder named config in the LOCAL 
directory. 


Platform Dependent Paths 


Here are the default locations for each system: 


Linux 


LOCAL: /3.4/ 


USER: $HOME/. config/blender/3.4/ 
SYSTEM: /usr/share/blender/3.4/ 


Note 


The path ./3.4/ is relative to the Blender executable and is 
used for self-contained bundles distributed by official 
blender.org builds. 


Note 
The USER path will use $xDG CONFIG HOME if it is set: 


$XDG CONFIG HOME/blender/3.4/ 


macOS 

LOCAL: ./3.4/ 

USER: /Users/$USER/Library/Application 
Support/Blender/3.4/ 

SYSTEM: /Library/Application Support/Blender/3.4/ 

Note 


macOS stores the Blender binary in 
./Blender.app/Contents/Mac0S/Blender. The local path to data 


and config is: 


./Blender.app/Contents/Resources/3.4/ 


Windows 


LOCAL: \3.4\ 


USER: %USERPROFILE%\AppData\Roaming\Blender 
Foundation\Blender\3.4\ 


SYSTEM: %USERPROFILE%\AppData\Roaming\Blender 
Foundation\Blender\3.4\ 
Note 


For installations from the Window’s Store, the USER and 
SYSTEM directories are inside a special folder resembling: 
%USERPROFILE%\AppData\Local\Packages\BlenderFoundation.Blende 
r<HASH>\LocalCache\Roaming\Blender Foundation\Blender where 
“HASH” is a string specific to each instillation. 


Path Layout 


This is the path layout which is used within the directories 
described above. 


Where ./config/startup.blend could be 
~/.blender/|BLENDER VERSION|/config/startup.blend for example. 


./autosave/ ... 
Autosave blend-file location. (Windows only, temp 


directory used for other systems.) 
Search order: LOCAL, USER. 


‘fCOWTLOS oie 
Defaults & session info. 


Search order: LOCAL, USER. 


./config/startup.blend 


Default file to load on startup. 


./config/userpref.blend 
Default preferences to load on startup. 


./config/bookmarks.txt 
File Browser bookmarks. 


./config/recent-files.txt 
Recent file menu list. 


./datafiles/ ... 
Runtime files. 


Search order: LOCAL, USER, SYSTEM. 


./datafiles/locale/{language}/ 
Static precompiled language files for UI translation. 


./scripts/ ... 
Python scripts for the user interface and tools. 


Search order: LOCAL, USER, SYSTEM. 


./scripts/addons/*.py 

Python add-ons which may be enabled in the Preferences 
include import/export format support, render engine 
integration and many handy utilities. 


./scripts/addons/modules/*. py 
Modules for add-ons to use (added to Python’s sys.path). 


./scripts/addons contrib/*.py 
Another add-ons directory which is used for community 
maintained add-ons (must be manually created). 


./scripts/addons contrib/modules/*.py 


Modules for addons contrib to use (added to Python’s 
sys.path). 


./scripts/modules/*. py 
Python modules containing our core API and utility 
functions for other scripts to import (added to Python’s 
sys.path). 


./scripts/startup/*.py 
Scripts which are automatically imported on startup. 


./scripts/presets/{preset}/*. py 


Presets used for storing user-defined settings for cloth, 
render formats, etc. 


./scripts/templates py/*.py 


Example scripts which can be accessed from Text Editor 
>» Templates >» Python. 


./scripts/templates osl/*.osl 


Example OSL shaders which can be accessed from Text 
Editor » Templates » Open Shading Language. 


./python/ ... 
Bundled Python distribution. 


Search order: LOCAL, SYSTEM. 


Local Cache Directory 


The cache directory is used to store persistent chaches 
locally. Currently it is only used for the indexing of Asset 
Libraries. The operating system is not expected to clear this 
automatically. 


The following path will be used: 


Linux: $XDG_ CACHE HOME/blender/ if 
$XDG CACHE HOME is set, otherwise 
e $HOME/. cache/blender/ 
e macOS: /Library/Chaches/Blender/ 
Windows: %SUSERPROFILE%\AppData\Local\Blender 
e Foundation\Blender\Cache\ 


Temporary Directory 


The temporary directory is used to store various files at run- 
time (including render layers, physics cache, copy-paste 
buffer and crash logs). 


The temporary directory is selected based on the following 
priority: 


e User Preference (see File Paths). 

e Environment variables (TEMP on Windows, TMP & TMP_DIR 
on other platforms). 

e The /tmp/ directory. 


Overriding Default Directories 


It’s possible to override the default USER and SYSTEM 
directories using environment variables. 


While this shouldn’t be needed for typical usage, some 
specialized use cases may take advantage of this, such as: 


e Using a shared network drives for specific paths. 


e Isolating an instance from the default user files to 
prevent automated tasks from accessing user 
configuration. 


See Environment Variables for details. 


Appendices 


This chapter covers far more detailed explanations about 


some Blender tools (which may not be required for typical 
usage). 


e Rotation Modes 


Rotation Modes 


Blender lets you define rotations in several ways. Each one 
of them has a series of advantages and drawbacks; there is 
no best rotation mode, as each one is suitable for specific 
cases. 


In all of these modes, positive angle values mean counter- 
clockwise rotation direction, while negative values define 
clockwise rotation. 


Though you can rotate elements using the global or local 
transform orientations, these axes are not suitable to define 
rotations, as the effect of each of them cannot be isolated 
from the other two. 


Take, for instance, any three values for X, Y and Z rotation. 
Perform each one of these using global or local axes. 
Depending on the order in which you perform these, you will 
end up with different final orientations. So proper rotation 
coordinate systems are needed. 


Euler Modes 


The axes system used for performing Euler rotations is the 
so called Euler gimbal. A gimbal is a particular set of three 
axes. The special thing about this is that the axes have a 
hierarchical relationship between them: one of the axes is at 
the top of the hierarchy, and has one of the other two axes 
as its immediate child; at the same time, this child axis is 
the parent of the remaining axis, the one at the very bottom 
of the hierarchy. 


Which axis is on top, which one in the middle and which at 
the bottom, depends on the particular Euler gimbal: there 
are six types of them, as there are six possible 
combinations: XYZ, XZY, YXZ, YZX, ZXY and ZYX Euler 
rotation modes. These modes are named using the letters of 
the axes in order, starting from the axis at the bottom of the 
hierarchy, and finishing with the one on top. 


The main problem of these systems comes when they lose 
their relative perpendicularity. And this happens when the 
axis in the middle rotates, causing the axis at the bottom to 
rotate with it. It keeps getting worse when this bottom axis 
approaches 90° (or equivalent angles). In that case, it will 
remain aligned with the axis on top of the hierarchy. In that 
moment we have just lost one axis of rotation. This can 
cause discontinuous interpolations when animating. This 
particular loss of axis is Known as the “gimbal lock”. 


Hint 


The actual configuration of the gimbal axes can be seen in 
the 3D Viewport by enabling the Rotate object gizmo and 
setting it to Gimbal (from the gizmos button in the 
header). At the same time, rotation mode should be set to 
any of the Euler modes for the active object. 


Now you can perform a rotation around the axis in the 
middle (e.g. in XYZ Euler mode that is the Y axis), and see 
how easy it is to end up having a gimbal with just two 
axes. In the specific case of the XYZ Euler mode with 
gimbal lock, a rotation around the X axis will have the 
same effect as rotating around the Z axis, meaning, in 
practice, that no X axis rotations can be performed. 


One advantage of this mode is that animation curves are 
easy to understand and edit. However, special attention 
must be done when the middle axis approaches values close 
to 90° (or equivalent angles). 


Axis Angle Mode 


This mode lets us define an axis (X, Y, Z) and a rotation 
angle (W) around that axis. 


If we define the rotation using interactive rotations (with the 
rotation gizmo), the values of X, Y and Z will not exceed 1.0 
in absolute value, and W will be comprised between 0 and 
180 degrees. 


If you wish to define rotations above 180° (e.g. to define 
multiple revolutions), you will need to edit the W value 
directly, but as soon as you perform an interactive rotation, 
that value will be adjusted again. Same thing goes for axis 
values. 


This system is suitable for elements revolving around a fixed 
axis, or to animate one of the elements at a time (either the 
axis or the angle). The problem might come when animating 
(interpolating) both components at the same time: axis and 

angle. The resulting effect might not be as expected. 


The Gimbal gizmo in this rotation mode shows a set of three 
orthogonal axes in which the Z axis goes along the defined 
rotation axis, i.e. it points towards the direction defined by 
the (X, Y, Z) point. 


The axis-angle system is free from gimbal lock, but 
animation curves in this mode are not intuitive at all when 


animating axis and angle at the same time, in which case 
they are difficult to understand and edit. 


Quaternion Mode 


In this mode, rotations are also defined by four values (X, Y, 
Z and W). X, Y and Z also define an axis, and W an angle, 
but it does it quite differently from axis-angle. The important 
thing here is the relation between all four values. 


To describe it in an intuitive way, let’s take the effect of the 
X coordinate: what it does is to rotate the element around 
the X axis up to 180 degrees. The same goes for Y and Z. 
The effect of W is to avoid those rotations and leave the 
element with zero rotation. The final orientation is a 
combination of these four effects. 


As the relation between components is what defines the 
final orientation, multiplying or dividing all four numbers by 
a constant value will yield the very same rotation. 


This mode is ideal for interpolating between any pair of 
orientations. It doesn’t suffer from gimbal lock or any 
interpolation undesired effect. The only drawback is that 
you cannot interpolate between two orientations that are at 
a distance greater than than 180°, as the animation will 
take the shortest path between them. Thus to animate a 
revolving element you must set up many intermediate 
keyframes, 180° from each other at most. 


The Gimbal gizmo in this mode is equivalent to the Local 
one, and doesn’t have any special meaning. 


The animation curves in this mode are not intuitive, so they 
are also difficult to understand and edit. 


More about Quaternions 


This section is not really useful for 3D artists, but it can be 
suitable for the curious or the scientist. 


Quaternions are a number system extending the complex 
numbers. They represent a four component vector, whose 
components are called, in Blender, X, Y, Z and W. When 
rotating interactively in quaternion mode, the so called 
norm (length) of the quaternion will remain constant. By 
definition, the norm of a quaternion equals 1.0 (that’s a 
normalized quaternion). When you select the quaternion 
mode in Blender, the XYZW components describe a 
normalized quaternion. 


Note 
The norm of a quaternion q is defined mathematically as: 


\[\lvert q \rvert = \sqrt{X*2 + Y*2 + Z*2 + W%*2}\] 


However, if one of the quaternion components is locked 
during the interactive transformation using the proper lock 
button, the norm will not remain unchanged, as that blocked 
component will not be able to adjust itself to keep the unit 
norm. 


Hint 


Interactive rotations with the gizmo don’t change the norm 
of the current quaternion. Editing a single XYZW 
component individually you can change the norm. To make 
the norm 1.0 again you can switch to any rotation mode 
and back again into quaternion. 


The rotation components of a quaternion keep a tight 
relation with those of axis-angle. To find a correspondence, 
first of all we must deal with the normalized version of the 
quaternion, that is, one whose norm equals 1.0. To 
normalize a quaternion, just divide each one of its 
components by its norm. As we have seen before, dividing 
all four values by the same number gives the same 
orientation. 


Once we have calculated the components of the normalized 
quaternion, the relation with the axis-angle components is 
as follows: 


e X, Y and Z mean exactly the same as in axis-angle: they 
just define an axis around which the rotation takes 
place. 

e W can be used to retrieve the actual rotation around the 
defined angle. The following formula applies (provided 
that the quaternion is normalized): \(W = \cos(\frac{a} 
{2})\), where a is actually the rotation angle we are 
looking for. That is: \(a = 2 \arccos{W}\). 


Other Considerations 


In axis-angle and quaternion modes we can lock rotations in 
interactive modes in a per component basis, instead of 
doing it by axis. To do so we can activate this locking ability 
using the lock buttons next to the corresponding Rotation 
transform buttons. 


Regarding rotation animations, all keyframes must be 
defined in the same rotation mode, which must be the 
selected rotation mode for the object throughout the entire 
animation. 


Troubleshooting 


Startup 

3D Viewport 
Graphics Hardware 
Crashes 

Python Errors 
Recovering Data 


Compatibility 


Some applications which integrate themselves into your 
system can cause problem’s with Blender. 


Here is a list of known compatibility issues. 


Startup 


Blender 


There are some common causes for problems when using 
Blender. If you cannot find a solution to your problem here, 
try asking the community for help. 


If Blender crashes on startup, there are a few things to 
check for: 


e« See if your computer meets the minimum requirements. 
e Confirm that your graphics card is supported and that 
the drivers are up to date. 


Known causes listed below. 


Common Startup Messages 


The Blender Console Window can display many different 
types of status and error messages. Some messages simply 
inform the user what Blender is doing, but have no real 
impact on Blender’s ability to function. Other messages can 
indicate serious errors that will most likely prevent Blender 
carrying out a particular task and may even make Blender 
non-responsive or shut down completely. The Blender 
Console Window messages Can also originate internally from 
within the Blender code or from external sources such as 
Python scripts. 


found bundled python: {DIR} 


This message indicates that Blender was able to find the 
Python library for the Python interpreter embedded 
within Blender. If this folder is missing or unable to be 
found, it is likely that an error will occur, and this 
message will not appear. 


Read prefs: {DIR}/userpref.blend 
The user preferences use this path. 


3D Viewport 


Rendering 


Depth Buffer Glitches 


Sometimes when setting a large clipping_range will allow 
you to see both near and far objects, but reduces the depth 
precision resulting in artifacts. 


Model with Model with Mesh with 

no clipping clipping artifacts in 

artifacts. artifacts. Edit Mode. 
To avoid this: 


e Increase the near clipping when working on large 
scenes. 

e Decrease the far clipping when objects are not viewed 
at a distance. 


When perspective is disabled only the far Clip End is used, 
very high values can still result in artifacts. This is not 
specific to Blender, all graphics applications have these 
same limitations. 


Objects Invisible in Camera View 


If you have a large scene, viewing it through Camera View 
may not display all of the objects in the scene. One 
possibility may be that the clipping distance of the camera 
is too low. The camera will only show objects that fall within 
the clipping range. 


Performance 


Slow Rendering 


There are a couple of reasons why you may be experiencing 
a slow viewport. 


Old Hardware 
Sometimes your hardware, mainly your graphics card, 
may be too slow to keep up with your model. 


Upgrade Graphics Driver 
In some cases, slow selection is resolved by using 
updated drivers. 


Slow Selection 


Blender uses OpenGL for selection, some graphics card 
drivers are slow at performing this operation. 


This becomes especially problematic on dense geometry. 
Possible Solutions: 


GPU Depth Picking (Preferences) 
See Preferences » Viewport > Selection. 


This option is enabled by default, disabling it may give a 
better performance at the cost of selection accuracy. 


Upgrade Graphics Driver 
In some cases, slow selection is resolved by using 
updated drivers. /t is generally good to use recent drivers 
when using 3D software. 


Select Centers (Workaround) 
In Object Mode, holding ctrt while selecting uses the 
object center point. While this can be useful on its own, it 
has the side effect of not relying on OpenGL selection. 


Change Display Mode (Workaround) 
Using Wireframe display mode can be used to more 
quickly select different objects. 


Note 


Obviously, the workarounds listed here are not long term 
solutions, but it is handy to know if you are stuck using a 
system with poor OpenGL support. 


Ultimately, if none of these options work out it may be 
worth upgrading your hardware. 


Navigation 


Lost in Space 


When navigating your scene, you may accidentally navigate 
away from your scene and find yourself with a blank 
viewport. There are two ways to fix this: 


1. Select an object in the Outliner, then zoom to that 


2. 


object with View >» Frame Selected or NumpadPeriod. 


Use Home to fit all objects into the 3D Viewport. 


Invisible Limit Zooming In 


Sometimes when navigating you may be trying to zoom in 
but it seems that you have hit a limit to how far you can 
zoom. This is because Blender uses a central point to orbit 
around. 


In practice this is good for modeling an object which you 
rotate about a lot to see from all sides (think of a potter 
using a wheel). However, this makes it awkward to explore a 
scene or model an object from the ‘inside’, for example. 


Solutions 


Use View Dolly. 

Use Walk/Fly Navigation. 

Use Auto Depth and Zoom to Mouse Position. These 
tools will make sure the distance is always the value 
under the mouse cursor, 

Use Zoom Region as it alSo resets the center point when 
zooming. 

Center the view around the mouse cursor Alt-MMB. This 
will take the position under the cursor and make it your 
viewpoint center. 


configuring_peripherals for more information. 


Tools 


Invalid Selection 


There are times when selection fails under some 
configurations, often this is noticeable in mesh Edit Mode, 
selecting vertices/edges/faces where random elements are 
selected. 


Internally Blender uses OpenGL for selection, so the 
graphics card driver relies on giving correct results. 


Possible Solutions: 


Disable Multisampling 
This is by far the most common cause of selection issues. 


There are known problems with some graphics cards 
when using multisampling. 


You can disable this option by turning multisampling off 
in your graphics card driver options. 


Change Anti-Aliasing Sample Settings 


Depending on your OpenGL configuration, some specific 
sample settings may work while others fail. 


Unfortunately finding working configuration involves trial 
& error testing. 


Upgrade Graphics Driver 


As with any OpenGL-related issues, using recent drivers 
can resolve problems. 


However, it should be noted that this is a fairly common 
problem and remains unresolved with many drivers. 


Graphics Hardware 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


Windows 


e Windows - Nvidia 

e Windows - AMD 

e Windows - Intel 

e Windows - Other GPU 


Linux 


e Linux - Nvidia 

e Linux - AMD 

e Linux - Intel 

e Linux - Other GPU 


macOS 


macOS - Nvidia 
macOS - AMD 
macOS - Intel 
macOS - Other GPU 


Windows - Nvidia 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On Windows drivers are provided by the graphics card 
manufacturer (Nvidia). Windows update automatically 
installs graphics drivers, or your computer manufacturer 
may provide its own version of the graphics drivers. 


However, these are not always the latest version or may 
have been corrupted in some way. We recommend to always 
use the official drivers. 


Download Latest Nvidia Drivers 


Laptops 


Laptops often have two GPUs for power saving purposes. 
One slower onboard GPU (typically Intel) and one faster 
dedicated GPU for a better performance (AMD or Nvidia). 


For the best performance the dedicated GPU should be used 
for Blender. Which GPU to use for which application can be 
configured in your graphics driver settings. 


If there is a graphics glitch or crash specific to the onboard 
GPU, then using the dedicated GPU can help avoid that. Or 
vice versa, if the dedicated GPU causes issues, then using 

the onboard graphics can help. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


Update your graphics drivers (see above). 

On laptops, make sure you are using a dedicated GPU 

(see above). 

e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 

made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 


See Invalid Selection, Disable Anti-Aliasing. 


Virtual Machines 


Running Blender inside a virtual machine is known to have 
problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help >» Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


Windows - AMD 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On Windows drivers are provided by the graphics card 
manufacturer (AMD). Windows update automatically installs 
graphics drivers, or your computer manufacturer may 
provide its own version of the graphics drivers. 


However, these are not always the latest version or may 
have been corrupted in some way. We recommend to always 
use the official drivers. 


Download Latest AMD Drivers 


Laptops 


Laptops often have two GPUs for power saving purposes. 
One slower onboard GPU (typically Intel) and one faster 
dedicated GPU for a better performance (AMD or Nvidia). 


For the best performance the dedicated GPU should be used 
for Blender. Which GPU to use for which application can be 
configured in your graphics driver settings. 


If there is a graphics glitch or crash specific to the onboard 
GPU, then using the dedicated GPU can help avoid that. Or 
vice versa, if the dedicated GPU causes issues, then using 

the onboard graphics can help. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


Update your graphics drivers (see above). 

On laptops, make sure you are using a dedicated GPU 

(see above). 

e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 

made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 


See Invalid Selection, Disable Anti-Aliasing. 


Virtual Machines 


Running Blender inside a virtual machine is known to have 
problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help >» Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


Windows - Intel 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On Windows drivers are provided by the graphics card 
manufacturer (Intel). Windows update automatically installs 
graphics drivers, or your computer manufacturer may 
provide its own version of the graphics drivers. 


However, these are not always the latest version or may 
have been corrupted in some way. We recommend to always 
use the official drivers. 


Download Latest Intel Drivers 


Laptops 


Laptops often have two GPUs for power saving purposes. 
One slower onboard GPU (typically Intel) and one faster 
dedicated GPU for a better performance (AMD or Nvidia). 


For the best performance the dedicated GPU should be used 
for Blender. Which GPU to use for which application can be 
configured in your graphics driver settings. 


If there is a graphics glitch or crash specific to the onboard 
GPU, then using the dedicated GPU can help avoid that. Or 
vice versa, if the dedicated GPU causes issues, then using 

the onboard graphics can help. 


Compatibility 


In some cases Blender may crash on startup. Running 
Blender in compatibility mode can help in fixing this issue. 
To enable compatibility mode, RmB on the Blender executable 
and select Properties » Compatibility and enable Run this 
program in compatibility mode. Confirm the changes with 


Apply. 
Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


Update your graphics drivers (see above). 

On laptops, make sure you are using a dedicated GPU 

(see above). 

e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 

made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 
See Invalid Selection, Disable Anti-Aliasing. 
Virtual Machines 


Running Blender inside a virtual machine is known to have 
problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help >» Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


Windows - Other GPU 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On Windows drivers are provided by the graphics card 
manufacturer. Windows update automatically installs 
graphics drivers, or your computer manufacturer may 
provide its own version of the graphics drivers. 


Laptops 


Laptops often have two GPUs for power saving purposes. 
One slower onboard GPU (typically Intel) and one faster 
dedicated GPU for a better performance (AMD or Nvidia). 


For the best performance the dedicated GPU should be used 
for Blender. Which GPU to use for which application can be 
configured in your graphics driver settings. 


If there is a graphics glitch or crash specific to the onboard 
GPU, then using the dedicated GPU can help avoid that. Or 
vice versa, if the dedicated GPU causes issues, then using 

the onboard graphics can help. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


e Update your graphics drivers (see above). 
e On laptops, make sure you are using a dedicated GPU 
(see above). 


e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 
made any changes there. 


Render Errors 
See Eevee and Cycles documentation respectively. 
Wrong Selection in 3D Viewport 


See Invalid Selection, Disable Anti-Aliasing. 


Virtual Machines 


Running Blender inside a virtual machine is known to have 
problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help > Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


Linux - Nvidia 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On Linux, graphics drivers are usually installed as a package 
by your Linux distribution. Installing the latest drivers is 
typically done by upgrading packages or the distribution as 
a whole. Some distributions provide multiple packages for 
multiple drivers versions, giving you the choice to install 
newer versions. 


For Nvidia there are open source (Nouveau) and closed 
source (by Nvidia) graphics drivers. Blender functions best 
with the closed source drivers as they are more optimized 
and complete. Linux graphics drivers can be downloaded 
from Nvidia’s website, however in most cases the ones from 
your Linux distribution are fine and make things easier. 
Manually downloading drivers is mostly useful to get the 
very latest version, for example for a GPU that was only 
recently released. 


NVidia Website 


Laptops 


Laptops often have two GPUs for power saving purposes. 
One slower onboard GPU (typically Intel) and one faster 
dedicated GPU for a better performance (AMD or Nvidia). 


For the best performance the dedicated GPU should be used 
for Blender. Which GPU to use for which application can be 
configured in your graphics driver settings. 


If there is a graphics glitch or crash specific to the onboard 
GPU, then using the dedicated GPU can help avoid that. Or 
vice versa, if the dedicated GPU causes issues, then using 

the onboard graphics can help. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


Update your graphics drivers (see above). 

On laptops, make sure you are using a dedicated GPU 

(see above). 

e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 

made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 


See Invalid Selection, Disable Anti-Aliasing. 


Virtual Machines 


Running Blender inside a virtual machine is known to have 
problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help > Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


Linux - AMD 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On Linux, graphics drivers are usually installed as a package 
by your Linux distribution. Installing the latest drivers is 
typically done by upgrading packages or the distribution as 
a whole. Some distributions provide multiple packages for 
multiple drivers versions, giving you the choice to install 
newer versions. 


AMD drivers are open source, except for the OpenCL 
Support which is available as part of Pro drivers. Installing 
packages through your Linux distribution is usually best. 
AMD also provides graphics drivers for download on their 
website if you need the latest version. 


AMD Drivers and Support Website 


Laptops 


Laptops often have two GPUs for power saving purposes. 
One slower onboard GPU (typically Intel) and one faster 
dedicated GPU for a better performance (AMD or Nvidia). 


For the best performance the dedicated GPU should be used 
for Blender. Which GPU to use for which application can be 
configured in your graphics driver settings. 


If there is a graphics glitch or crash specific to the onboard 
GPU, then using the dedicated GPU can help avoid that. Or 
vice versa, if the dedicated GPU causes issues, then using 

the onboard graphics can help. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


Update your graphics drivers (see above). 

On laptops, make sure you are using a dedicated GPU 

(see above). 

e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 

made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 


See Invalid Selection, Disable Anti-Aliasing. 


Virtual Machines 


Running Blender inside a virtual machine is known to have 
problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help > Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


Linux - Intel 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On Linux, graphics drivers are usually installed as a package 
by your Linux distribution. Installing the latest drivers is 
typically done by upgrading packages or the distribution as 
a whole. Some distributions provide multiple packages for 
multiple drivers versions, giving you the choice to install 
newer versions. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 


run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


e Update your graphics drivers (see above). 

e On laptops, make sure you are using a dedicated GPU 
(see above). 

e Try lowering quality settings in Preferences >» System > 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 
made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 
See Invalid Selection, Disable Anti-Aliasing. 


Virtual Machines 


Running Blender inside a virtual machine is known to have 
problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help > Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


Linux - Other GPU 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On Linux, graphics drivers are usually installed as a package 
by your Linux distribution. Installing the latest drivers is 
typically done by upgrading packages or the distribution as 
a whole. Some distributions provide multiple packages for 
multiple drivers versions, giving you the choice to install 
newer versions. 


Laptops 


Laptops often have two GPUs for power saving purposes. 
One slower onboard GPU (typically Intel) and one faster 
dedicated GPU for a better performance (AMD or Nvidia). 


For the best performance the dedicated GPU should be used 
for Blender. Which GPU to use for which application can be 
configured in your graphics driver settings. 


If there is a graphics glitch or crash specific to the onboard 
GPU, then using the dedicated GPU can help avoid that. Or 
vice versa, if the dedicated GPU causes issues, then using 

the onboard graphics can help. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


e Update your graphics drivers (see above). 
e On laptops, make sure you are using a dedicated GPU 
(see above). 


e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 
made any changes there. 


Render Errors 
See Eevee and Cycles documentation respectively. 
Wrong Selection in 3D Viewport 


See Invalid Selection, Disable Anti-Aliasing. 


Virtual Machines 


Running Blender inside a virtual machine is known to have 
problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help > Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


macOS - Nvidia 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On macOS graphics drivers are built into the operating 
system and the only way to get newer drivers is to upgrade 
macOS as a whole to the latest version. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


Update your graphics drivers (see above). 

On laptops, make sure you are using a dedicated GPU 

(see above). 

e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 

made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 

See Invalid Selection, Disable Anti-Aliasing. 

Virtual Machines 

Running Blender inside a virtual machine is known to have 


problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help >» Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


macOS - AMD 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On macOS graphics drivers are built into the operating 
system and the only way to get newer drivers is to upgrade 
macOS as a whole to the latest version. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


Update your graphics drivers (see above). 

On laptops, make sure you are using a dedicated GPU 

(see above). 

e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 

made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 

See Invalid Selection, Disable Anti-Aliasing. 

Virtual Machines 

Running Blender inside a virtual machine is known to have 


problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help >» Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


macOS - Intel 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On macOS graphics drivers are built into the operating 
system and the only way to get newer drivers is to upgrade 
macOS as a whole to the latest version. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


Update your graphics drivers (see above). 

On laptops, make sure you are using a dedicated GPU 

(see above). 

e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 

made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 

See Invalid Selection, Disable Anti-Aliasing. 

Virtual Machines 

Running Blender inside a virtual machine is known to have 


problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help >» Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


macOS - Other GPU 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


On macOS graphics drivers are built into the operating 
system and the only way to get newer drivers is to upgrade 
macOS as a whole to the latest version. 


Common Problems 


Unsupported Graphics Driver Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


Update your graphics drivers (see above). 

On laptops, make sure you are using a dedicated GPU 

(see above). 

e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 

made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 

See Invalid Selection, Disable Anti-Aliasing. 

Virtual Machines 

Running Blender inside a virtual machine is known to have 


problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help >» Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


Crashes 


The most common causes of Blender crashes: 


e Running out of memory. 
e Issues with graphics hardware or drivers. 
e Bugs in Blender. 


Firstly, you may be able to recover your work with File > 
Recover > Auto Save.... 


To prevent the problem from happening again, you can 
check that the graphics drivers are up to date (Graphics 
Hardware), upgrade your machine’s hardware (the RAM or 
graphics card), and disable some options that are more 
memory intensive: 


e Reduce undo steps Preferences >» System >» Memory & 
Limits » Undo Steps. 

e Using multisample anti-aliasing also increases the 
memory usage and makes the display slower. 

e On Linux, the Window Manager (KDE and Gnome for 
example) may be using hardware accelerated effects 
(e.g. window shadows and transparency) that are using 
up the memory that Blender needs. Try disabling the 
desktop effects or switch to a lightweight Window 
Manager. 


To check memory usage by Blender: 


e On Windows, use Task Manager and sort by Memory. 

e On macOS, use Activity Monitor.app and open Memory 
tab. Alternatively, run top -o MEM. 

e On Linux, run top -o %MEM. 


Crash Log 


When Blender crashes, it writes out a text file which 
contains information that may help identify the cause of the 
crash. Usually, this file is written in the Temporary Directory 
directory. 


This file contains a log of tools used up until the crash as 
well as some other debug information. When reporting bugs 
about crashes it can be helpful to attach this file to your 
reports, especially when others are unable to reproduce the 
crash. 


Windows 


On acrash, a file is written based on the name of the 
currently loaded blend-file, so test.blend will create a file 
called test.crash.txt. 


Batch scripts are provided in Blender installation directory 
which may be run to obtain the Blender debug log and 
system info text files: 


e blender debug log.cmd is uSed in most cases. 

e blender debug gpu.cmd and blender debug gpu workaround. cmd 
log GPU-related errors. 

e blender factory startup.cmd starts Blender with default 
settings which is recommended for debugging. 


If the crash happens in Blender module, stack trace is also 
written to a file named blender.crash.txt. The path to that file 
can be found at the end of blender debug log. txt file. 


macOS 


After crash, macOS Crash Reporter shows a window with 
backtrace after some time, or when Blender is opened 
again. Copy the text in the crash report and save it in a text 
file. That file should be attached to the bug report while 
following other bug reporting guidelines. 


Some .crash files can also be found in 
~/Library/Logs/DiagnosticReports/ with the name of format: 
Blender _YYYY-MM-DD-HHMMSS MACNAME.crash. If a report is present 
corresponding to the time of crash, that file can also provide 
hints about cause of the crash. Alternatively, Console.app 
can be used to navigate all “User Reports” (see sidebar in 
the app). 


Linux 


On acrash, a file named blender.crash.txt iS written in /tmp 
directory. 


Note 


More logs can be obtained by running Blender from 
Command Line and using --factory-startup --debug-all 
flags. See Launching from the Command Line and 
Command Line Arguments. 


Python Errors 


Precompiled Libraries 


While not common practice, Python add-ons can be 
distributed with their own precompiled libraries. Unlike 
regular Python scripts, these are not portable between 
different platforms. 


It is possible the library is incompatible with your Blender 
installation (attempting to load a library built for a different 
version of Python, or loading a 32-bit library on a 64-bit 
system). 


If the add-on contains .pyd or .so files, check that the 
distribution is compatible with your operating system. 


Platform Specific 


Windows 
Mixed Python Libraries (DLLs) 
If Python is raising errors or you have an add-on that just 


fails when enabled with an error, e.g: ... is not a valid 
Win32 application.. 


py. tine > in <module 
rig, shape. util, weights 
py". line 13, in <module> 


n\lib\xmlrpe\client.py". line 134. in Gmodule> 


", line 16,Ain <module> 


oundat ion\Blender\2.76\python\lib\socket.py". line 49 in <module> 


cket 
: DLL load failed:}%1 is not a valid Win32 application. 


A Python traceback. 


This may be caused by some inconsistency in the Python 
libraries. While Blender comes with its own bundled Python 
interpreter, duplicate, incompatible libraries can cause 
problems. 


To find out which Python Library caused the Problem check 
the error message. 


This is normally reported somewhere around the bottom line 
of the traceback. With the error above you see the problem 
is caused while trying to import socket. This corresponds to 
either a file named _socket.py OF socket. pyd. 


To help troubleshoot this problem, the following script can 
be pasted into the Text editor and run to check for duplicate 
libraries in your search path. (The output will show in 
Command Line Window.) 


import os 
import sys 


# Change this based on the library you wish to test 
test lib = " socket.pyd" 


def GetSystemDirectory(): 
from ctypes import windll, create string buffer, sizeof 
GetSystemDirectory = windLlL.kernel32.GetSystemDirectoryA 


buffer = create string buffer(260) 
GetSystemDirectory(buffer, sizeof(buffer) ) 
return os. fsdecode(buffer.value) 


def library search paths(): 
return ( 
# Windows search paths 
os.path.dirname(sys.argv[0]), 
os.getcwd(), 
GetSystemDirectory(), 
os.environ["WINDIR"], # GetWindowsDirectory 
*os.environ["PATH"].split(";"), 


# regular Python search paths 
*sys.path, 
) 


def check library duplicate(libname) : 
paths = [p for p in library search paths() 
if os.path.exists(os.path.join(p, libname) ) ] 


print("Library %r found in %d locations:" % (libname, 
len(paths) ) ) 
for p in paths: 
print("- %r" % p) 


check_library_duplicate(test_ lib) 


Recovering Data 


Computer crashes, power outages, or simply forgetting to 
Save can result in the loss or corruption of your work. You 
can use Blender’s Auto Save feature to reduce the chance of 
losing files when such events occur. 


There are options to save a backup of your files like Auto 
Save that saves your file automatically over time, and Save 
on Quit, which saves your blend-file automatically when you 
exit Blender. In addition to these functions being enabled by 
default, the Save on Quit functionality cannot be disabled. 


Note 


For your actions, there are options like Undo, Redo and an 
Undo History, used to roll back from mistakes under 
normal operation, or return back to a specific action. See 
Undo & Redo. 


Recovering Save Versions 


By default Blender keeps an additional backup when saving 
files. So saving renames the previously saved file with a 
.blend1 extension instead of overwriting it. 


This file can be used to revert to a previous state. 


See Save Versions to configure the number of versions kept. 


Recovering Auto Saves 


Last Session 


Reference 


Menu: File » Recover > Last Session 


The Recover Last Session will open the quit.blend file that is 
saved into the Temporary Directory when you quit Blender 
under normal operation (see Blender Session). Note that 
files in your temporary directory may be deleted when you 
reboot your computer (depending on your system 
configuration). 


Auto Save 


Reference 


Menu: File » Recover > Auto Save 


The Recover Auto Save allows you to open the Auto Saved 
file. You will have to navigate to your Temporary Directory. 
The Auto Saved files are named using a random number 
and have a blend extension. 


See Auto Save Preferences to configure auto-save. 


Trusted Source 
When enabled, Python scripts and drivers that may be 
included in the file will be run automatically. Enable this 
only if you created the file yourself, or you trust that the 
person who gave it to you did not include any malicious 
code with it. See Python Security to configure default 
trust options. 


Tip 


Enable the detailed list view when browsing auto-saved 
files to show which is the most recent. 


Render Window Help Back to Previous 
2S 
/tmp/ 


32554 autosave.blend 


» 


2% mask 29497 autosave.blend 12-Jun-19 


622 KiB 
552 KiB 
626 KiB 
409 KiB 
464 KiB 
10.5 MiB 


2 32554 autosave.blend 124un-19 
% quit.blend 124un-19 
%z loc_from_z_rot.blend 07-Jun-19 
2% untitled.blend 06-Jun-19 
2% 920.blend 06-Jun-19 


File Browser displaying a vertical list. 


Warning 


When recovering an Auto Saved file, any changes made 
since the last Auto Save will be lost. Only one Auto Saved 
file exists for each .blend file, i.e. Blender does not keep 
older versions. Therefor, you will only be able to restore 
the most recent Auto Save file. 


Glossary 


This page lists definitions for terms used in Blender and this 
manual. 


Action Safe 


Area of the screen visible on most devices. Place content 
inside it to ensure it does not get cut off. 


Active 


When many items are selected, the last selected item 
will be the active one. Used in situations where the 
interface only shows options for one item at a time. 


See also selection states. 


Aliasing 
Rendering artifacts in the form of jagged lines. 


Alpha Channel 


Additional channel in an image for transparency. 


Straight Alpha 


Method where RGBA channels are stored as (R, G, B, 
A) channels, with the RGB channels unaffected by the 
alpha channel. This is the alpha type used by paint 
programs such as Photoshop or Gimp, and used in 
common file formats like PNG, BMP or Targa. So, 
image textures or output for the web are usually 
straight alpha. 


Premultiplied Alpha 


Method where RGBA channels are stored as (R x A, G 
x A, B x A, A), with the alpha multiplied into the RGB 
channel. 


This is the natural output of render engines, with the 
RGB channels representing the amount of light that 
comes toward the viewer, and alpha representing how 
much of the light from the background is blocked. The 
OpenEXR file format uses this alpha type. So, 
intermediate files for rendering and compositing are 
often stored as premultiplied alpha. 


Conversion (Straight/Premultiplied) 
Alpha 
Conversion between the two alpha types is nota 
simple operation and can involve data loss, as both 
alpha types can represent data that the other cannot, 
though it is often subtle. 


Straight alpha can be considered to be an RGB color 
image with a separate alpha mask. In areas where this 
mask is fully transparent, there can still be colors in 
the RGB channels. On conversion to premultiplied 
alpha, this mask is applied and the colors in such 
areas become black and are lost. 


Premultiplied alpha, on the other hand, can represent 
renders that are both emitting light and letting 
through light from the background. For example, a 
transparent fire render might be emitting light, but 
also letting through all light from objects behind it. On 
converting to straight alpha, this effect is lost. 


Channel Packed 


A separate image map is stored for each color and 
alpha channel. Channel packing is commonly used by 
game engines to save memory and to optimize 
memory access. 


Ambient Light 


The light that comes from the surrounding environment 
as a whole. 


Ambient Occlusion 


A ratio of how much Ambient Light a surface point would 
be likely to receive. If a surface point is under a foot or 
table, it will end up much darker than the top of 
someone's head or the tabletop. 


Animation 
Simulation of motion. 


Anti-Aliasing 
Is the technique of minimizing Aliasing, by e.g. rendering 
multiple samples per pixel. 


Armature 


An Object consisting of Bones. Used to Rig characters, 
props, etc. 


Asset 


Curated data-blocks that are meant for reuse, usually 
contained in an Asset Library. See also Asset Libraries. 


Note that there are other meanings of the word “asset” - 
sometimes this is used more generically, and refers to 
any “useful thing”, like images, models, materials, and 
more. 


Asset Catalog 


Container for assets, similar to what a directory is for 
files. See also Asset Catalogs. 


Asset Library 


Directory on drive, registered in the list of asset libraries 
in the preferences. See also Asset Libraries and Current 
File Asset Library. 


Asset Metadata 


Asset-related information, such as its catalog, 
description, author, preview, and tags. See Asset Details 
Region. 


Axis 
A reference line which defines coordinates along one 
cardinal direction in n-dimensional space. 


Axis Angle 


Rotation method where X, Y, and Z correspond to the 
axis definition, while W corresponds to the angle around 
that axis, in radians. 


Baking 
The process of computing and storing the result of a 
potentially time-consuming calculation so as to avoid 
needing to calculate it again. 


Bevel 
The operation to chamfer or bevel edges of an object. 
Bézier 
A computer graphics technique for generating and 
representing curves. 


Bit Depth 


The exponent value (with base two) for how many colors 
can be represented within a single color channel. A 
higher bit depth will allow more possible colors, reducing 
banding, and increasing precision. Yet a higher bit depth 
will increase memory usage exponentially. 


Blend Modes 
Color Blend Modes 


Methods for blending two colors together. 


See also Blend Modes on GIMP docs. 


Blender Session 
Session 


The timespan of a Blender instance. The session begins 
with starting an instance of Blender and ends with 
closing it. 


In some cases, loading a new file may be considered 
beginning a new session. If so, the documentation should 
mention that. 


Bone 


The building block of an Armature. Made up of a Head, 
Tail and Roll Angle which define a set of local axes anda 
point of rotation at the Head. 


Boolean 
A type of logic dealing with binary true/false states. 


See also Boolean Modifier. 


Bounding Box 


The box that encloses the shape of an object. The box is 
aligned with the local space of the object. 


Bump Mapping 
Technique for simulating slight variations in surface 
height using a grayscale “heightmap” texture. 


BVH 
Bounding Volume Hierarchy 
A hierarchical structure of geometric objects. 


See also Bounding Volume Hierarchy on Wikipedia. 


Caustics 


The optical phenomenon of light concentration focused 
by specular reflections or refracting objects. In example 
observable on light passing through a glass of water onto 
a table or the pattern at the bottom of a swimming pool. 


In rendering this refers to diffuse reflected light paths 
after a glossy or refraction bounce. 


See also Caustics on Wikipedia. 


Child 
An Object that is affected by its Parent. 


Chroma 
Chrominance 


In general, a resulting image color decomposition, where 
its (L or Y) luminance channel is separated. There are two 
different contexts whereas this term is used: 


Video Systems 


Refers to the general color decomposition resulting in 
Y (Luminance) and C (Chrominance) channels, 
whereas the chrominance is represented by: U = ( 
Blue minus Luminance ) and V = ( Red minus 
Luminance ). 


Matte Compositing 
Refers to a point in the color gamut surrounded by a 
mixture of a determined spectrum of its RGB 
neighboring colors. This point is called Chroma key 
and this key (a chosen color) is used to create an 
Alpha Mask. The total amount of gamut space for this 
chrominance point is defined by users in a circular or 
square-shaped format. 


Chromaticities 


The coordinates of the Primaries on the CIE 1931 xy 
chromaticity diagram. 


Clamp 
Clamping 
Limits a variable to a range. The values over or under the 


range are set to the constant values of the range’s 
minimum or maximum. 


Collection 
A device for organizing objects. See also Collections. 


Color Gamut 
A gamut traditionally refers to the volume of color a 
particular color model/space can cover. In many 
instances, it is illustrated via a 2D model using CIE Yxy 
coordinates. 


Color Model 


A mechanism for representing colors as numbers. 


RGB 


An additive system where three primaries; red, green, 
and blue are combined to make other colors. 


HSV 
Three values often considered as more intuitive 
(human perception) than the RGB system. In this 
model, colors are represented as Hue, Saturation, and 
Value. 


HSL 


Similar to HSV except the colors are represented as 
Hue, Saturation, and Luminance. 


YUV 


Luminance-Chrominance standard used in 
broadcasting analog PAL (European) video. 


YCbCr 
Luminance-ChannelBlue-ChannelRed component 
video for digital broadcast use, whose standards have 
been updated for HDTV and commonly referred to as 
the HDMI format for component video. 


Color Space 


A coordinate system in which a vector represent a color 
value. This way the color space defines three things: 


e The exact color of each of the Primaries 
e The White Point 
e A transfer function 


The color spaces supported by Blender depend on the 
active OCIO config. The default supported color spaces 
are described in detail here: Default OpenColorlO 
Configuration 


sRGB 
A color space that uses the Rec .709 Primaries anda 
D65 white point, and 2.2 gamma correction value as 
the transfer function. 


Concave Face 


Face in which one vertex is inside a triangle formed by 
other vertices of the face. 


See also Convex and concave polygons on Wikipedia. 


Constraint 
A way of controlling one Object with data from another. 


Convex Face 


Face where, if lines were drawn from each vertex to 
every other vertex, all lines would remain in the face. 
Opposite of a Concave Face. 


Coplanar 


Refers to any set of elements that are all aligned to the 
same 2D plane in 3D space. 


Crease 


Property of an Edge. Used to define the sharpness of 
edges in Subdivision Surface meshes. 


Current File Asset Library 


Asset library that is not a directory on drive, but only 
reflects the assets in the current blend-file. This library is 
available regardless of the location of the blend-file. See 


The Current File Asset Library. 


Curve 
A type of object defined in terms of a line interpolated 
between Control Vertices. Available types of curves 
include Bézier, NURBS and Polly. 


Curve Segment 


The part of a curve connecting two adjacent control 
points. 


Cyclic 
Often referring to an object being circular. This term is 
often associated with Curve. 


Data User 


An existing Blender object, which is using its own data, or 
linked data (data owned and controlled by another 
Blender object). 


Diffuse Light 


Even, directed light coming off a surface. For most 
things, diffuse light is the main lighting we see. Diffuse 
light comes from a specific direction or location and 
creates shading. Surfaces facing towards the light source 
will be brighter, while surfaces facing away from the light 
source will be darker. 


Directional Light 


The light that has a specific direction, but no location. It 
seems to come from an infinitely far away source, like 


the sun. Surfaces facing the light are illuminated more 
than surfaces facing away, but their location does not 
matter. A directional light illuminates all objects in the 
scene, no matter where they are. 


Displacement Mapping 


A method for distorting vertices based on an image or 
texture. Similar to Bump Mapping, but instead operates 
on the mesh’s actual geometry. This relies on the mesh 
having enough geometry to represent details in the 


image. 


Display Referenced 


Refers to an image whose Luminance channel is limited 
to a certain range of values (usually 0-1). The reason it is 
called display referenced is because a display cannot 
display an infinite range of values. So, the term Scene 
Referenced must go through a transfer function to be 
converted from one to the other. 


DOF 
Depth of Field 


The distance in front of and behind the subject which 
appears to be in focus. For any given lens setting, there 
IS Only one distance at which a subject is precisely in 
focus, but focus falls off gradually on either side of that 
distance, so there is a region in which the blurring is 
tolerable. This region is greater behind the point of focus 
than it is in front, as the angle of the light rays change 
more rapidly; they approach being parallel with 
increasing distance. 


Double Buffer 


Technique for rendering and displaying content on the 
screen. Blender uses two buffers (images) to render the 
interface, the content of one buffer is displayed while 
rendering occurs on the other buffer. When rendering is 
complete, the buffers are switched. 


Edge 
Straight segment (line) that connects two Vertices, and 
can be part of a Face. 


Edge Loop 


Chain of Edges belonging to consecutive Quads. An edge 
loop ends at a pole or a boundary. Otherwise, it is cyclic. 


Edge Ring 
Path of all Edges along a Face Loop that share two faces 
belonging to that loop. 


Elastic 


Objects that are able to spontaneously return to their 
original shape after all outside forces are removed from 
the object. 


Elasticity 


The amount a material is elastic versus inelastic. 


Empty 


An Object without any Vertices, Edges or Faces. 


Euler 
Euler Rotation 


Rotation method where rotations are applied to each of 
the X, Y, Z axes in a specific order. 


Euler orders in Blender are most intuitive when read 
backwards: XYZ Euler is similar to rotating around Local Z 
using the Rotate tool in the 3D Viewport, followed by 
Local Y and then Local x. 


F-Curve 


A curve that holds the animation values of a specific 
property. 


Face 


Mesh element that defines a piece of surface. It consists 
of three or more Edges. 


Face Loop 
Chain of consecutive Quads. A face loop stops ata 
Triangle or N-gon (which do not belong to the loop), or at 
a boundary. Otherwise, it is cyclic. 


Face Normal 


The normalized vector perpendicular to the plane that a 
Face lies in. Each face has its own normal. 


Fake User 
A special Data User, a program construct that is used to 
mark an object (e.g. material) to be saved in a blend-file, 
even when no Real User is using the object. Objects that 


are not used by any Data User are not included in saved 
blend-files. 


Field of View 


The area in which objects are visible to the camera. Also 
see Focal Length. 


Fireflies 


Rendering artifacts encountered with path tracing 
resulting from improbable samples that contribute very 
high values to pixels. 


FK 
Forward Kinematics 


The process of determining the movement of 
interconnected segments or bones of a body or model in 
the order from the parent bones to the child bones. Using 
forward kinematics on a hierarchically structured object, 
you can move the upper arm then the lower arm and 
hand go along with the movement. Without forward 
kinematics the lower arm and hand would disconnect 
from upper arm and would move independently in space. 


See also Inverse Kinematics. 


Focal Length 
The distance required by a lens to focus collimated light. 


Defines the magnification power of a lens. Also see Field 
of View. 


Frame Types 
In video compression, a frame can be compressed by 
several different algorithms. These algorithms are known 
as picture types or frame types and there are three major 
types: I, P, and B frames. 


l-frames 
The least compressible but don’t require other video 
frames to decode. 


P-frames 
Use data from previous frames to decompress and are 
more compressible than I-frames. 


B-frames 
Use both previous and forward frames for data 
reference to get the highest amount of compression. 


Gamma 
An operation used to adjust the brightness of an image. 


See also Gamma correction on Wikipedia. 


Geodesic 


Relating to the shortest possible path between two points 
on a curved surface. 


Geometric Center 


The mean average of the positions of all vertices making 
up the object. 


Gimbal 


A pivoted support that allows the rotation of an object 
about a single axis. 


See also Gimbal on Wikipedia. 


Gimbal Lock 
The limitation where axes of rotation can become 
aligned, losing the ability to rotate on an axis (typically 
associated with Euler Rotation). 


e See also Gimbal lock on Wikipedia. 
e See also Gimbal lock on Stack Exchange. 


Global Illumination 


A superset of Radiosity and ray tracing. The goal is to 
compute all possible light interactions in a given scene, 
and thus, obtain a truly photorealistic image. All 


combinations of diffuse and specular reflections and 
transmissions must be accounted for. Effects such as 
color bleeding and caustics must be included in a global 
illumination simulation. 


Global Space 


See World Space. 


Glossy Map 


See Roughness Map. 


HDRI 

High Dynamic Range Image 
A set of techniques that allow a far greater dynamic 
range of exposures than normal digital imaging 
techniques. The intention is to accurately represent the 
wide range of intensity levels found in real scenes, 
ranging from direct sunlight to the deepest shadows. 


See also HDRI on Wikipedia. 


Head 


A subcomponent of a Bone. The point of rotation for the 
bone has X, Y, and Z coordinates measured in the Local 
Space of the Armature object. Used in conjunction with 
the Tail to define the local Y axis of the bone in Pose 
Mode. The larger of the two ends when displayed as an 
Octahedron. 


Hue 
A shade of light out of the color spectrum. 


IK 
Inverse Kinematics 


The process of determining the movement of 
interconnected segments or bones of a body or model in 
the order from the child bones to the parent bones. Using 
inverse kinematics on a hierarchically structured object, 
you can move the hand then the upper and lower arm 
will automatically follow that movement. Without inverse 
kinematics the hand would come off the model and 
would move independently in space. 


See also Forward Kinematics. 


Interpolation 


The process of calculating new data between points of 
known value, like Keyframes. 


IOR 
Index of Refraction 


A property of transparent materials. When a light ray 
travels through the same volume it follows a straight 
path. However, if it passes from one transparent volume 
to another, it bends. The angle by which the ray is bent 
can be determined by the IOR of the materials of both 
volumes. 


Keyframe 


A frame in an animated sequence drawn or otherwise 
constructed directly by the animator. In classical 
animation, when all frames were drawn by animators, the 
senior artist would draw these frames, leaving the “in 
between” frames to an apprentice. Now, the animator 
creates only the first and last frames of a simple 
sequence (keyframes); the computer fills in the gap. 


Keyframing 


Inserting Keyframes to build an animated sequence. 


Lattice 


A type of object consisting of a non-renderable three- 
dimensional grid of vertices. 


See also Lattice Modifier. 


Light Bounces 


Refers to the reflection or transmission of a light ray 
upon interaction with a material. See also Light Paths. 


Local Space 


A 3D coordinate system that originates (for Objects) at 
the Object Origin. or (for Bones) at the Head of the Bone. 


Compare to World Space. 


Luminance 


The intensity of light either in an image/model channel, 
or emitted from a surface per square unit in a given 
direction. 


Manifold 


Manifold meshes, also called ‘water-tight’ meshes, define 
a closed non-self-intersecting volume (see also Non- 
manifold). A manifold mesh is a mesh in which the 
structure of the connected faces in a closed volume will 
always point the normals (and their surfaces) to the 
outside or to the inside of the mesh without any overlaps. 
If you recalculate those normals, they will always point at 
a predictable direction (to the outside or to the inside of 
the volume). When working with non-closed volumes, a 
manifold mesh is a mesh in which the normals will always 
define two different and non-consecutive surfaces. A 
manifold mesh will always define an even number of non- 
overlapped surfaces. 


MatCap 


Stands for “material capture”, using an image to 
represent a complete material including lighting and 
reflections. 


Matte 
Mask 


A grayscale image used to include or exclude parts of an 
image. A matte is applied as an Alpha Channel, or it is 
used as a mix factor when applying Color Blend Modes. 


Mesh 


Type of object consisting of Vertices, Edges and Faces. 


Micropolygons 
A polygon roughly the size of a pixel or smaller. 


MIP 

Mip-map 

Mip-mapping 
‘MIP’ is an acronym of the Latin phrase ‘multum in 
parvo’, meaning ‘much in little’. Mip-maps are 
progressively lower resolution representations of an 
image, generally reduced by half squared interpolations 
using Anti-Aliasing. Mip-mapping is the process used to 
calculate lower resolutions of the same image, reducing 
memory usage to help speed visualization, but increasing 
memory usage for calculations and allocation. Mip- 
mapping is also a process used to create small anti- 
aliased samples of an image used for texturing. The mip- 
mapping calculations are made by CPUs, but modern 
graphic processors can be selected for this task and are 
way faster. 


See the mip-map option present in the System 
Preferences. 


MIS 
Multiple Importance Sampling 


A process of estimating the direction of light rays to 
improve sampling quality. 


sampling on Wikipedia. 


Modifiers 


A non-destructive operation that is applied on top of 
some sort of data. 


Motion Blur 


The phenomenon that occurs when we perceive a rapidly 
moving object. The object appears to be blurred because 
of our persistence of vision. Simulating motion blur 
makes computer animation appear more realistic. 


Multisampling 


Rendering multiple samples per pixel, for Anti-Aliasing. 


N-gon 


A Face that contains more than four Vertices. 


NDOF 

3D Mouse 
A general term used to describe a 3D mouse, or any 
input devices which supports more degrees of freedom 


than a conventional 2D input device, see: NDOF (3D 
Mouse). 


Non-manifold 
Non-Manifold meshes essentially define geometry which 
cannot exist in the real world. This kind of geometry is 
not suitable for several types of operations, especially 
those where knowing the volume (inside/outside) of the 
object is important (refraction, fluids, Boolean operations, 
or 3D printing, to name a few). A non-manifold mesh is a 
mesh in which the structure of a non-overlapped surface 
(based on its connected faces) will not determine the 
inside or the outside of a volume based on its normals, 
defining a single surface for both sides, but ended with 
flipped normals. When working with non-closed volumes, 
a non-manifold mesh will always determine at least one 
discontinuity in the normal directions, either by an 
inversion of a connected loop, or by an odd number of 
surfaces. A non-manifold mesh will always define an odd 
number of surfaces. 


There are several types of non-manifold geometry: 


e Some borders and holes (edges with only a single 
connected face), as faces have no thickness. 

Edges and vertices not belonging to any face (wire). 
Edges connected to three or more faces (interior 
faces). 

Vertices belonging to faces that are not adjoining 
(e.g. two cones sharing the vertex at the apex). 


See also: Select Non-Manifold tool. 


Nonlinear Animation 


Animation technique that allows the animator to edit 
motions as a whole, not just the individual keys. 
Nonlinear animation allows you to combine, mix, and 
blend different motions to create entirely new 
animations. 


Normal 
The normalized vector perpendicular to a surface. 


Normals can be assigned to vertices, faces and 
modulated across a surface using Normal Mapping. 


See also Normals on Wikipedia. 


Normal Mapping 


Is similar to Bump Mapping, but instead of the image 
being a grayscale heightmap, the colors define in which 
direction the normal should be shifted, the three color 

channels being mapped to the three directions X, Y and 


Z. This allows more detail and control over the effect. 


NURBS 
Non-uniform Rational Basis Spline 


A computer graphics technique for generating and 
representing curves and surfaces. 


Object 
Container for a type (mesh, curve, surface, metaball, 
text, armature, lattice, empty, camera, light) and basic 
3D transform data (Object Origin). 


Object Center 

Object Origin 
A reference point used to position, rotate, and scale an 
Object and to define its Local Space coordinates. 


Octahedron 


An eight-sided figure commonly used to depict the Bones 
of an Armature. 


OpenGL 


The graphics system used by Blender (and many other 
graphics applications) for rendering 3D graphics, often 
taking advantage of hardware acceleration. 


See also OpenGL on Wikipedia. 


Operator 


An executable action that is completed the moment 
they’re initiated. See Operators as described in the user 
interface section. 


Overscan 


The term used to describe the situation. when not all of a 
televised image is present on a viewing screen. 


See also Overscan on Wikipedia. 


Panel 


A user interface element that contains buttons. Panels 
are collapsible to hide there contents and can often be 
rearranged. See Panels as described in the user interface 
section. 


Parent 
An Object that affects its Child objects. 


Parenting 
Creating a Parent-Child relationship between two objects. 


Particle System 
Technique that simulates certain kinds of fuzzy 
phenomena, which are otherwise very hard to reproduce 
with conventional rendering techniques. Common 


examples include fire, explosions, smoke, sparks, falling 
leaves, clouds, fog, snow, dust, meteor tails, stars, and 
galaxies, or abstract visual effects like glowing trails, 
magic spells. Also used for things like fur, grass or hair. 


Phong 
Local illumination model that can produce a certain 
degree of realism in three-dimensional objects by 
combining three elements: diffuse, soecular and ambient 
for each considered point on a surface. It has several 
assumptions - all lights are points, only surface geometry 
is considered, only local modeling of diffuse and 
specular, specular color is the same as light color, 
ambient is a global constant. 


Pivot Point 


The pivot point is the point in space around which all 
rotation, scaling and mirror transformations are centered. 


See also the Pivot Point docs. 


Pixel 


The smallest unit of information in a 2D raster image, 

representing a single color made up of red, green, and 
blue channels. If the image has an Alpha Channel, the 
pixel will contain a corresponding fourth channel. 


Point Cloud 


A list of points in 3D space. 


Pole 


Vertex where three, five, or more edges meet. A vertex 
connected to one, two, or four edges is not a pole. 


Pose Mode 


Constraining and Parenting the Bones of an Armature. 


Posing 


Moving, Rotating and Scaling the Bones of an Armature 
to achieve an aesthetically pleasing pose for a character. 


Premultiplied Alpha 
See Alpha Channel. 


Primaries 


In color theory, primaries (often known as primary colors) 
are the abstract lights, using an absolute model, that 
make up a Color Space. 


Primitive 
A basic object that can be used as a basis for modeling 
more complicated objects. 


Procedural Texture 


Computer generated (generic) textures that can be 
configured via different parameters. 


Projection 


In computer graphics, there are two common camera 
projections used. 


Perspective 
A perspective view is geometrically constructed by 
taking a scene in 3D and placing an observer at point 
O. The 2D perspective scene is built by placing a 
plane (e.g. a sheet of paper) where the 2D scene is to 
be rendered in front of point O, perpendicular to the 
viewing direction. For each point P in the 3D scene a 


PO line is drawn, passing by O and P. The intersection 
point S between this PO line and the plane is the 
perspective projection of that point. By projecting all 
points P of the scene you get a perspective view. 


Orthographic 
In an orthographic projection, you have a viewing 
direction but not a viewing point O. The line is then 
drawn through point P so that it is parallel to the 
viewing direction. The intersection S between the line 
and the plane is the orthographic projection of the 
point P. By projecting all points P of the scene you get 
the orthographic view. 


Proxy 


For video editing, a proxy is a smaller version of the 
Original file, typically using an optimized video codec and 
lower resolution version (faster to load) that stands in for 
the main image or video. 


When proxies are built, editing functions like scrubbing 
and scrolling and compositing is much faster but gives 
lower resolution and slightly imprecise result. 


Quad 
Quadrilateral 
Quadrangle 
Face that contains exactly four Vertices. 


Quaternion 
Quaternion Rotation 


Rotation method where rotations are defined by four 
values (X, Y, Z, and W). X, Y, and Z also define an Axis, 
and W an angle, but it is quite different from Axis Angle. 


Quaternion values can be interpreted geometrically as 
defining a point on a unit sphere in 4D space. Moving 
along any great circle of the sphere represents rotating 
around a fixed axis, with one full circle matching two full 
rotations. 


Radiosity 
A global lighting method that calculates patterns of light 
and shadow for rendering graphics images from three- 
dimensional models. One of the many different tools 
which can simulate diffuse lighting in Blender. 


Random Seed 
Seed 


Blender uses pseudo random number generators, which 
produce numbers that appear to be random, but given 
the same initial condition, they will always produce the 
exact same sequence of numbers. 


This is a critical feature to get reproducible and/or stable 
effects (otherwise e.g. your hair simulation would change 
every time you re-run it, without any way to control the 
outcome). 


The seed is a number that represents the initial 
condition of a random generator, if you change its seed, 
it will produce a new sequence of pseudo-random 
numbers. 


See also Random seed on Wikipedia. 


Ray Tracing 


Rendering technique that works by tracing the path 
taken by a ray of light through the scene, and calculating 
reflection, refraction, or absorption of the ray whenever it 
intersects an object in the world. More accurate than 
Scanline, but much slower. 


Real User 


A Blender object, which is a Data User. Opposite of Fake 
User, which is only a program construct. 


Refraction 
The change in direction of a wave due to a change in 
velocity. It happens when waves travel from a medium 
with a given Index of Refraction to a medium with 
another. At the boundary between the media, the wave 
changes direction; its wavelength increases or decreases 
but frequency remains constant. 


Render 


The process of computationally generating a 2D image 
from 3D geometry. 


Resource 


External files such as images, sounds, fonts and volumes 
files that can be packed into a blend-file. 


RGB 


A color model based on the traditional primary colors, 
Red/Green/Blue. RGB colors are also directly broadcasted 
to most computer monitors. 


Rig 
A system of relationships that determine how something 
moves. The act of building of such a system. 


Roll 

Roll Angle 
The orientation of the local X and Z axes of a Bone. Has 
no effect on the local Y axis as local Y is determined by 
the location of the Head and Jail. 


Rolling Shutter 


In real CMOS cameras the sensor is read out with 
scanlines and hence different scanlines are sampled at a 
different moment in time. This, for example, make 
vertical straight lines being curved when doing a 
horizontal camera pan. See also Rolling Shutter on 
Wikipedia. 


Roughness Map 


A grayscale texture that defines how rough or smooth 
the surface of a material is. This may also be known as a 


Glossy Map. 


Saturation 


Also known as colorfulness, saturation is the quantity of 
hue in the color (from desaturated - a shade of gray - to 
saturated - brighter colors). 


Scanline 
Rendering technique. Much faster than Ray Tracing, but 
allows fewer effects, such as reflections, refractions, 
motion blur and focal blur. 


Scene Referenced 
An image whose Luminance channel is not limited. 


See also Display Referenced. 


Shading 
Process of altering the color of an object/surface in the 
3D scene, based on its angle to lights and its distance 
from lights to create a photorealistic effect. 


Smoothing 
Defines how Faces are shaded. Faces can be either solid 
(faces are rendered flat) or smooth (faces are smoothed 
by interpolating the normal on every point of the face). 


Specular Light 


A light which is reflected precisely, like a mirror. Also 
used to refer to highlights on reflective objects. 


SSS 
Subsurface Scattering 


Mechanism of light transport in which light penetrates 
the surface of a translucent object, is scattered by 
interacting with the material, and exits the surface ata 
different point. All non-metallic materials are translucent 
to some degree. In particular, materials such as marble, 
Skin, and milk are extremely difficult to simulate 
realistically without taking subsurface scattering into 
account. 


Straight Alpha 
See Alpha Channel. 


Subdiv 
Subdivision Surface 


A method of creating smooth higher poly surfaces which 
can take a low polygon mesh as input. 


See also Catmull-Clark subdivision surface on Wikipedia. 


Subdividing 
Technique for adding more geometry to a mesh. It 
creates new vertices on subdivided edges, new edges 
between subdivisions and new faces based on new 
edges. If new edges cross a new vertex is created at their 
crossing point. 


Swing 

Swing and Twist 
Refers to decomposition of an arbitrary rotation into a 
sequence of two single axis rotations: a swing rotation 
that aims a chosen axis in its final direction using the 
shortest possible rotation path, followed by a twist 
rotation around that axis. 


This decomposition is available through Driver Variables 
and inputs of the Transformation constraint. The Damped 
Track constraint produces a pure swing rotation. 


In the Quaternion representation the swing rotation 
always has 0 as the X/Y/Z component corresponding to 
the selected axis, while twist always has O as the other 
two components. 


Tail 
A subcomponent of a Bone. Has X, Y and Z coordinates 
measured in the Local Space of the armature object. 
Used in conjunction with the Head to define the local Y 
axis of a bone in Pose Mode. The smaller of the two ends 
when displayed as an Octahedron. 


Tangent 


A line that intersects a surface at exactly one point, a 
tangent is perpendicular to a Normal. 


Tessellation 


The tiling of a plane using one or more geometric shapes 
usually resulting in Micropolygons. 


Texture 


Specifies visual patterns on surfaces and simulates 
physical surface structure. 


Texture Space 


The bounding box to use when using Generated mapping 
to add a Texture to an image. 


Timecode 
A coded signal on videotape or film giving information 
about the frame number and time the frame was 
recorded. Timecodes are used to sync media between 
different recording devices, including both audio and 
video. 


Title Safe 


Area of the screen visible on all devices. Place text and 
graphics inside this area to make sure they do not get cut 
off. 


Topology 


The arrangement of Vertices, Edges, and Faces which 
define the shape of a mesh. See Vertex, Edge, and Face. 


Transform 


The combination of location, rotation, and scale. Can be 
expressed in World Space or Local Space. 


Triangle 
Face with exactly three Vertices. 


UV Map 


Defines a relation between the surface of a mesh anda 
2D texture. In detail, each face of the mesh is mapped to 
a corresponding face on the texture. It is possible and 
often common practice to map several faces of the mesh 
to the same or overlapping areas of the texture. 


Value 
The brightness of the color (dark to light). 


Vertex 
Vertices 


A point in 3D space containing a location. Vertices are 
the terminating points of Edges. 


Vertex Group 


Collection of Vertices. Vertex groups are useful for 
limiting operations to specific areas of a mesh. 


Voxel 
A cubic 3D equivalent to the square 2D pixel. The name 
is a combination of the terms “Volumetric” and “Pixel”. 
Used to store smoke and fire data from physics 
simulations. 


Walk Cycle 
In animation, a walk cycle is a character that has just the 
walking function animated. Later on in the animation 
process, the character is placed in an environment and 
the rest of the functions are animated. 


Weight Painting 
Assigning Vertices to a Vertex Group with a weight of 0.0 
- 1.0. 


White Point 


A reference value for white light when all primaries of a 
color model are combined evenly. 


A white point is defined by a set of CIE illuminates which 
correspond to a color temperature. For example, D65 
corresponds to 6500 K light and D70 corresponding to 
7000 K. 


World Space 


A 3D coordinate system that originates at a point at the 
origin of the world. Compare to Local Space. 


Z-buffer 


Raster-based storage of the distance measurement 
between the camera and the surface points. Surface 
points which are in front of the camera have a positive Z 
value and points behind have negative values. The Z- 
depth map can be visualized as a grayscale image. 


Contribute Documentation 


The Blender Manual is a community driven effort to which 
anyone can contribute. Whether you like to fix a tiny 
spelling mistake or rewrite an entire chapter, your help with 
the Blender manual is most welcome! 


If you find an error in the documentation, please report the 
problem. 


Get involved in discussions through any of the project 
Contacts. 


Getting Started 


The following guides lead you through the process. 


e Installing Dependencies 
Building the Manual 
Editing the Manual 
Patch & Commit 


Release Cycle 
Todo List 


Guidelines 


Writing Style Guide 
Markup Style Guide 
Templates 
Maintenance 


Translations 


¢ Contribute 
e Style Guide 


Contacts 


Project Page 
An overview of the documentation project. 


Mailing List 
A mailing list for discussing ideas, and keeping track of 
progress. 


Devtalk 
A forum based discussions on writing and translating 
documentation. This includes the user manual, Wiki, 
release notes, and code docs. 


Blender Chat 
#docs Channel for informal discussions in real-time. 


Project Workboard 
Manage tasks such as bugs, todo lists, and future plans. 


Installing Dependencies 


This section documents how to install the software used to 
generate the manual. The installation is different for each 
operating system, instructions have been written for: 


Installation on Linux 


This guide covers the following topics: 


1. Installing Dependencies 
2. Downloading the Repository 
3. Setting up the Build Environment 


Installing Dependencies 


Below are listed the installation commands for popular Linux 
distributions. 


For the appropriate system, run the command in a terminal: 
Debian/Ubuntu: 

sudo apt-get install python3 python3-pip subversion 
Redhat/Fedora: 

sudo yum install python python-pip 

Arch Linux: 


sudo pacman -S python python-pip subversion 


Downloading the Repository 


Simply check out the Blender Manual’s repository using: 


cd ~ 
svn checkout https://svn.blender.org/svnroot/bf - 
manual/trunk/blender docs 


The repository will now be downloaded which may take a 
few minutes depending on your internet connection. 


Setting up the Build 
Environment 


e Open a Terminal window. 


e Enter the blender docs folder which was just added by 
the SVN checkout: 


cd ~/blender_ docs 


Inside that folder is a file called requirements.txt which 
contains a list of all the dependencies we need. To 
install these dependencies, we can use the pip3 
command: 


sudo pip3 install -r requirements.txt 
Note 


Every now and then you may want to make sure your 
dependencies are up to date using: 


sudo pip3 install -r requirements.txt --upgrade 


Installation on macOS 


This guide covers the following topics: 


1. Installing Dependencies 
2. Downloading the Repository 
3. Setting up the Build Environment 


Note 


This guide relies heavily on command-line tools. It 
assumes you are the least familiar with the macOS 


Terminal application. 


Installing Dependencies 


Install those packages or make sure you have them in your 
system. 
e Python 


° PIP 
e Subversion 


Downloading the Repository 


Simply check out the Blender Manual’s repository using: 


cd ~ 
svn checkout https://svn.blender.org/svnroot/bf - 


manual/trunk/blender docs 


The repository will now be downloaded which may take a 
few minutes depending on your internet connection. 


Setting up the Build 
Environment 


e Open a Terminal window. 


e Enter the blender docs folder which was just added by 
the SVN checkout: 


cd ~/blender_ docs 


Inside that folder is a file called requirements.txt which 
contains a list of all the dependencies we need. To 
install these dependencies, we can use the pip 
command: 


sudo pip install -r requirements.txt 
Note 


Every now and then you may want to make sure your 
dependencies are up to date using: 


sudo pip install -r requirements.txt --upgrade 


Installation on Windows 


This guide covers the following topics: 


1. Installing Python (used to “convert” the source files to 
HTML) 

2. Installing SVN and Downloading the Repository 

3. Setting_up the Build Environment 


Installing Python 


1. Download the Python installation package for Windows. 
In this guide version 3.9.x is used. 


2. Install Python with the installation wizard. Please make 
sure that you enable the “Add Python to PATH” option: 
nicixi 

Install Python 3.6.2 (64-bit) 


Select Install Now to install Python with default settings, or choose 
Customize to enable or disable features. 


> Install Now 
C:\Users\gaia\AppData\Local\Programs\Python\Python36 
Indudes IDLE, pip and documentation 
= Creates shortcuts and file associations 
i Canine cialis make sure to enable 
Choose location and features th i so pti on | 


python 


M Install launcher for all users (recornmended) 


for 
windows 


The option must be enabled so you can build 
the manual with the make script. 


All other settings can remain as set by default. 


Installing SVN and Downloading 
the Repository 


In this guide, we will use TortoiseSVN though any Subversion 
client will do. 


1. Download TortoiseSVN for Windows. 

2. Install TortoiseSVN with the installation wizard. When 
choosing which features will be installed, it is 
recommended that you enable command line client 
tools to give you access to SVN from the command line 
(there is no harm in doing this, and it may be helpful if 
you ever run into any trouble). 

3. Once the installation has finished, create a new folder 
that will contain everything related to the Blender 
Manual. In this guide, we will use C:\blender_docs. 

4. Open the new folder, right-click and choose SVN 
Checkout... from the context menu. 

5. In the URL of repository field, enter: 
https://svn.blender.org/svnroot/bf - 
manual/trunk/blender docs. 

6. In the Checkout directory field, enter: C:\blender docs. 
7. Click OK - the repository will now be downloaded which 
may take a few minutes depending on your internet 

connection. 


Setting up the Build 
Environment 


e Open a Command Prompt. (Run as Administrator) 


e Enter the blender docs folder which was just added by 
the SVN checkout: 


cd C:\blender docs 


e Inside that folder is a file called requirements.txt which 
contains a list of all the dependencies we need. Install 
all the dependencies using Python’s pip command: 


pip install -r requirements.txt 


e If all goes well, you should see the following message 
when it is finished: 


Successfully installed Jinja2 MarkupSafe Pygments Sphinx 
docutils sphinx-rtd-theme Cleaning up... 


During the setup, some warnings may be shown, but do not 
worry about them. However, if any errors occur, they may 
Cause some problems. 


Note 


Every now and then you may want to make sure your 
dependencies are up to date using: 


pip install -r requirements.txt --upgrade 


Building the Manual 


Converting the RST-files into pretty HTML pages is simple. 


Open a terminal or Command Prompt in the ~/blender docs 
directory and simply run: 


make 
Tip 


On Microsoft Windows you can simply open the make. bat file 
to easily run the command without having to open the 
Command Prompt and typing commands. 


This is the command you should use when building the 
docs, however, other commands are available by typing make 
help. This command will convert the RST-files into HTML 
pages and automatically open your default web browser to 
view the result. The command will continue to run and 
watch for changes made to the RST-files and refresh the 
HTML pages as necessary. 


Note 


The converted pages can also be viewed manually by 
browsing the build directory: ~/blender_docs/build/html. For 
example to open the home page, open 
build/html/index.html to read the manual. 


The building process may take several minutes the first time 
(or after any major changes), but for subsequent changes it 


should only take a few seconds. 


Editing the Manual 


You can modify the manual by editing local text files. These 
files are kept in sync with those online via a repository, 
based on this the server will update the online manual. 


The manual is written in the reStructuredText (RST) markup 
language and can be edited using a plain text editor. Fora 
local preview, you convert (build) the manual source files 
from RST into HTML web pages. 


Update 
Firstly, make sure that your local copy of the manual is up to 
date with the online repository using: 


svn update 
Writing 


You can now edit the documentation files, which are the .rst 
files inside the manual folder using a text editor of your 
choice. 


Be sure to check the Writing Style Guide for conventions 
and Markup Style Guide to learn how to write in the 
reStructuredText markup language. 


Happy writing! 


Bigger Changes 


If you are going to add or overhaul a section, be sure to 
check carefully that it does not already exist. In some 
places, the docs are so disorganized that sections may be 
duplicated or in a strange location. In the case that you find 
a duplicate or out of place section, create a task explaining 
the issue, and optionally include a revision (actual changes). 


Before you make any edits that are not simple and plainly 
justified (for example, moving folders around), you should 
verify with a manual maintainer that your contribution is 
along the community’s vision for the manual. This ensures 
the best use of your time and good will as it is otherwise 
possible that, for some reason, your changes will conflict 
and be rejected or need time-consuming review. For 
example, another person may be already working on the 
section you wish to change, the section may be scheduled 
for deletion or to be updated according to a planned change 
to Blender. 


Communicating early and frequently is the key to have a 
productive environment, to not waste people’s effort and to 
attain a better Blender manual as a result. 


Getting Help/Answers 


If you are in doubt about functionality that you wish to 
document, you should pose your questions to the Blender 
developers responsible for that area or ask at the unofficial 
user Support channel in the #docs or #blender-coders channel 
in Blender Chat. 


Blender itself has a system of module owners with 
developer and artist members who are responsible for the 
design and maintenance of the assigned Blender areas. See 
the module owners page for more information. 


Preview 


To view your changes, build the manual as instructed. Keep 
in mind that you can also build only the chapter you just 
edited to view it quickly. Open the generated .htm1 files 
inside the build/htmlt folder using your web browser, or 
refresh the page if you have it open already. 


Upload 


When you are happy with your changes, you can upload 
them, so that they will be in the online manual. At first, this 
is done by submitting patches so that someone can review 
your changes and give you feedback. After, you can commit 
your changes directly. This process is described in detail in 
the next section. 


Patch & Commit 
Submit Patches 


The first few times you make changes to the manual, you 
will need to submit them as patches for an administrator to 
review. This is just to make sure that we maintain a quality 
user manual, and that you do not accidentally break 
anything vital before you get used to the system. 


In order to submit a patch, follow this process: 
1. Make any changes that you want. 


2. Create a patch file by running: 


svn diff > filename. diff 


This creates a simple text file that shows what text was 
added, removed or changed between your working files 
and the central repository. 


If you have created or deleted files, you will need to run 
svn add /path/to/file Or svn rm /path/to/file before 
creating the diff. To see a list of affected files, run svn 
status. 


3. Upload the diff file here. If you do not have an account 
already, you can register for one. 


4. After submitting the diff, you will be asked to “Create a 
new Revision” before you can add a title and description 
of your changes. 


5. Please check if the Documentation project is assigned in 
the tag’s field in order to notify the team of your patch. 
You can also contact the team over the mailing list or 
Blender Chat. 


6. They will review your patch and let you know about any 
changes you could make. If there is no issue, your patch 
will be accepted and then committed by the team of 
your patch. 


Note 


If your patch includes changes to or additional images, 
simply attach them when you are creating the revision. 


Straightforward patches are bound to be accepted very 
quickly. Once you get accustomed to making changes and 
no longer need feedback, we cut out the middle man and 
give you direct access to edit the manual. 


See also 


See Release Cycle for documentation on how to make 
commits to a specific release branch and how to create 


merge commits. 


Commit Directly 


Once you are provided with the direct access to edit the 
manual, you can start committing directly instead of 
creating a patch file. Doing this will submit the change 
directly to our central repository. 


All you need to do now is run: 


svn commit -m "This is what I did" 


If you leave out -m "message", you will be prompted to type 
the message in a text editor. 


Do not forget to always run svn update before committing. 


Then you will be asked for your username and password 
(from developer.blender.org) before the change is committed. 


Note 


Make sure to use your username (case sensitive) and not 
your email. 


Your modified files are uploaded to the central repository for 
others to work with and continue collaborating. Commits are 
tracked in the repositories Diffusion. Soon after your 
changes become visible in the online manual. 


Writing a Good Commit Message 


When making changes to the manual that directly relate to 
a specific commit (change) in Blender, it is helpful to make 
the title of the commit the same as the commit made to 
Blender. It is requested that you include the commit hash of 
the commit made to the Blender source code. 


For example, the commit rBM8473 includes a descriptive 
indicative of the changes made along with the hash 
rBa71d2b260170. The hash can be extracted from the URL 
provided in the Documentation task for a specific upcoming 
release. 


Other more general changes do not have to follow the 
above policy however, it is still important to make the 
description clear about what changes you made and why. It 
can be helpful to prefix the commit title with a prefix word 
such aS Cleanup: or Fix: when you are making general 
cleanups or fixes respectively. 


Writing good commit messages helps administrators keep 
track of changes made and ensures all new features are 
properly documented. 


Release Cycle 


A new Blender version is targeted to be released every 3 
months. The actual release cycle for a specific release is 
longer, and overlaps the previous and next release cycle. 


Blender Release Cycle 


Bconl Bcon3 Bcon4 
New features and changes Bug fixing only Prepare release 


Following Release 


Bcon2 Bcon5 
Improve and stabilize Release 


Branches 


Work is done in two branches: 


e blender-v{VERSION}-release branch: fixes and other 
incremental improvements. 

¢ master branch: documentation for new features and 
improvements for the release after that. 


The blender-v{VERSION}- release branch will be available for 5 
weeks prior to the release date. At the same time master will 
be open for the next release, giving 2 months to add 
documentation for new features of the next release, and 
another month to make improvements. 


Switching Branches 


To switch to the release branch use: 


svn switch https://svn.blender.org/svnroot/bf - 
manual/branches/blender- {VERSION} -release/blender docs/ 


To switch back to the development branch use: 


svn switch https://svn.blender.org/svnroot/bf - 
manual/trunk/blender_ docs/ 


Updating Branches 


To merge changes from the release branch to the 
development branch, first switch to the development branch 
and use: 


svn merge https://svn.blender.org/svnroot/bf - 
manual/branches/blender- {VERSION} -release/blender docs/ 
Svn ci -m "Merge branch 'blender-{VERSION}-release'" 


Bcon Phases 


Each Blender version has its own Bcon phase, indicating 
which types of changes are allowed to be committed and 
what writers are focusing on. 


That means for example that Blender 2.90 can be in Bcon3 
(wrapping up), while Blender 2.91 is in Bconl (new features 
and changes). 


Phase Description Duration Details Branch 


Phase Description Duration Details 


New 
Bconl features and 
changes 


4-5 
weeks 


The first 5 
weeks overlap 
with the Bcon3 
and Bcon4 
phases of the 
previous 
release, 
Writing focus 
will be split on 
fixes for the 
previous 
release and 
writing 
documentation 
for features 
already added 
or likely to be 
added to 
Blender. This is 
also the 
perfect time to 
make any 
larger or more 
disruptive 
improvements 
to the manual. 


Branch 


master 


Phase Description Duration Details Branch 


Work to 
improve, 
optimize and 
fix bugs in new 
and existing 

Improve and features. All 

oe 4 weeks 

stabilize big or 
disruptive 
changes must 
be finished at 
the end of this 
stage. 


Bcon2 master 


Focus should 
be on fixes 
and other 
incremental 
improvements. 
All new 
Blender 
features 
should be 
documented 
by the end of 
this stage. 


blender - 
v{VERSION}- 
release 


Bcon3 Wrapping up 4 weeks 


Phase Description Duration Details 


Bcon4 


Bcon5 


Bcon6 


Prepare 
release 


Release 


Long-term 
release 


1 week 


1-2 days 


2 years 


Focus should 
be wrapping 
up fixes and 
other 
incremental 
improvements. 


The manual is 
archived on 
the server and 
redirects / 
symlinks are 
updated. See 
the Release 
Guide for more 
information. 


In casea 
major error is 
found in the 
manual the 
patch will be 
committed to 
the release 
branch. 


Branch 


blender - 
v{VERSION}- 
release 


blender - 
v{VERSION}- 
release 


Todo List 


This page provides a list of changes that need to be made to 
the manual. This is a great place for new contributors to 
start but also check the documentation workboard. 


Todo 


The documentation here is incomplete, you can help by 
contributing. 


(The original entry is located in 


/nhome/blender/svn/blender_docs/manual/addons/import_exp 
ort/anim_bvh.rst, line 35.) 


Writing Style Guide 


Primary Goals 


The main goals for this manual are as follows: 


User Focused 
The manual is written for people educated in computer 
graphics, who understand the basics of 3D and/or know 
other 3D software. While some areas of computer 
graphics are highly technical, this manual shall be kept 
understandable by non-technical users. 


Complete 
The manual provides detailed functional description of all 
features, tools and options in Blender. While there is a 
canonical source of truth for each of Blender’s key areas, 
this does not mean we have to document every small 
detail. The manual should provide information on what a 
feature is, how to use it, and its purpose. More 
background information should be provided when 
necessary to give deeper understanding of a 3D pipeline. 


Concise 
Computer graphics is an incredibly interesting field, there 
are many rules, exceptions to the rules, and interesting 
details. Expanding into details can add unnecessary 
content, so keep the text concise and relevant to the 
topic at hand. 


Maintainable 
Keep in mind that Blender has frequent releases, so try 
to write content that will not have to be redone the 


moment some small change is made. This also helps a 
small documentation community to maintain the manual. 


Content Guidelines 


In order to maintain a consistent writing style within the 
manual, please keep this page in mind and only deviate 
from it when you have a good reason to do so. 


Rules of thumb: 


Spell checking is strongly recommended. 

Use American English (e.g: modeling and not modelling, 

color and not colour) also for formatting numbers (e.g: 

2,/18.28 and not 2 718,28). 

e Take care about grammar, appropriate wording and use 
simple English. 

e Keep sentences short and clear, resulting in text that is 

easy to read, objective and to the point. 

Including why or how an option might be useful is a 

good idea. 

e If you are unsure about how a feature works, ask 

someone else or find out who developed it and ask 

them. 


To be avoided: 


e Avoid writing in first person perspective, about yourself 
or your Own opinions. 


e Avoid weasel! words and being unnecessarily vague, e.g: 


“Reloading the file will probably fix the problem” 
“Most people do not use this option because ...” 


e Avoid including specific details such as: 


“Blender has 23 different kinds of modifiers.” 
“Enabling previews adds 65536 bytes to the size of each 
blend-file (unless it is compressed).” 


These details are not useful for users to memorize and 
they become quickly outdated. 


Avoid documenting bugs. 


Blender often has 100’s of bugs fixed between releases, 
So it is not realistic to reference even a fraction of them 
from the manual, while keeping this list up to date. 


Issues that are known to the developers and are not 
going to be resolved before the next release can be 

documented as Known Limitations. In some cases, it 
may be best to include them in the troubleshooting 

section. 


Avoid product placements, i.e. unnecessarily promoting 
software or hardware brands. Keep content vendor- 
neutral where possible. 


Avoid technical explanations about the 
mathematical/algorithmic implementation of a feature if 
there is a simpler way to explain it. 


(E.g. explaining how mesh smoothing algorithms work is 
unnecessary, but the blending types of a Mix node do 
need a mathematical explanation.) 


Avoid repetition of large portions of text. Simply explain 
it once, and from then on refer to that explanation. 


For general terminology, consider defining a :term: in 
the glossary. 


Avoid enumerations of similar options, such as listing 
every preset or every frame rate in a select menu. 


Their contents may be summarized or simply omitted. - 
Such lists are only showing what is already obvious in 
the interface and end up being a lot of text to read and 
maintain. 


Avoid documenting changes in Blender between 
releases, that is what the release notes are for. We only 
need to document the current state of Blender. 


Unless the unit a value is measured in is obScure and 
unpredictable, there is no need to mention it. 


Do not simply copy the tooltips from Blender. - People 
will come to the manual to learn more than is provided 
by the UI. 


As a last resort you can add comment (which is not 
shown in the HTML page, but useful for other editors): 


. TODO, how does this tool work? ask Joe Blogg's. 


Glossary 


This section is specifically about the Glossary section, where 
we define common terms in Blender and computer graphics. 


Rules of thumb: 


e Define the term before providing any further 
information. 


e Avoid using constructs such as “it is” or “xyz is” before 
the definition. 


e Avoid repeating the term immediately or using it in the 
definition. 


e Avoid adding terms not found in Blender’s interface or 
the manual. 


e Avoid overly long entries. If an explanation of a complex 
term is needed, supplement with external links. 


e Avoid duplicating documentation; if explaining the term 
is the primary focus of another section of the manual 
(e.g. if the term is the name of a tool), either just link to 
that section, or avoid creating a glossary entry entirely. 


e URL references are to be added at the end, formatted as 
follows, e.g: 


See also “OpenGL <https://en.wikipedia.org/wiki/OpenGL> _ 
on Wikipedia. 


Examples 


This entry: 


Displacement Mapping 

Uses a grayscale heightmap, like Bump Mapping, 

but the image is used to physically move the vertices of the 
mesh at render time. 

This is of course only useful if the mesh has large amounts 
of vertices. 


Would be written like this instead, putting a definition first: 


Displacement Mapping 

A method for distorting vertices based on an image. 

Similar to Bump Mapping, but instead operates on the mesh's 
actual geometry. 

This relies on the mesh having enough geometry. 


This entry: 


Doppler Effect 
The Doppler effect is the change in pitch that occurs 
when a sound has a velocity relative to the listener. 


Would be written more like this, avoiding the immediate 
repetition of the term: 


Doppler Effect 

Perceived change in pitch that occurs 

when the source of a sound is moving relative to the 
listener. 


This entry: 


Curve 
It is a class of objects. 
In Blender there are Bézier curves and NURBS curves. 


Would be written more like this, avoiding the “it is”: 


Curve 

A type of object defined in terms of a line interpolated 
between Control Vertices. 

Available types of curves include Bézier and NURBS. 


Markup Style Guide 


This page covers the conventions for writing and use of the 
reStructuredText (RST) markup syntax. 


Conventions 


e Three space indentation. 
e Lines should be less than 120 characters long. 
e Use italics for button/menu names. 


Other loose conventions: 


e Avoid Unicode characters. 
e Avoid heavily wrapped text (i.e. sentences can have 
their own lines). 


Headings 


HHHHHHHHHHHHHHHHH 
Document Part 
HHHHHHHHHHHHHHHHH 


3K OK 2K KOK 2K 2K 2K OK OK 2K 2K OK 2 OK OK 


Document Chapter 
OK 2K 2K 2K 2K 2K OK 2K OK 2K OK 2K 2K OK OK OK 


Document Section 


Document Subsubsection 


ARRAARAAARAAAAAAARAARAARAAAM 


Document Paragraph 


Note 


Parts should only be used for contents or index pages. 


Note 


Each .rst file should only have one chapter heading (*) per 
file. 


Text Styling 


See the overview on ReStructuredText for more information 
on how to style the various elements of the documentation 
and on how to add lists, tables, pictures and code blocks. 
The Sphinx reference provides more insight additional 
constructs. 


The following are useful markups for text styling: 


*italic* 
*kbhoLd** 
> literal 


Interface Elements 


e :kbd:*LMB* - keyboard and mouse shortcuts. 

e *Mirror* — interface labels. 

e :menuselection: 3D Viewport --> Add --> Mesh --> Monkey~ - 
menus. 


Code Samples 


There is support for syntax highlighting if the programming 
language is provided, and line numbers can be optionally 
Shown with the :linenos: option: 


. code-block:: python 
: Linenos: 


import bpy 
def some function(): 


Images 


Figures should be used to place images: 
. figure:: /images/interface window-system splash current.png 


Image caption. 


For consistency, and since it would be good to ensure 
screenshots are all a similar size when floated next to text, 
writers should take screenshots in the following manner: 


1. Prepare the area you would like to capture making sure 
to use the default theme and setting. (In some cases 
you may not want to use the default settings e.g. if 
some options are hidden behind a checkbox.) 

2. Zoom to the maximum zoom level (hold NumpadPlus or 
Ctrl-MMB or similar). 

3. Zoom out eight zoom levels (NumpadMinus - eight times). 

4. In some cases you will want to leave a small margin 
around the thing you are trying to capture. This should 
be around 30px but does not have to be exact. 


This can be applied to several parts of the interface but 
might not work for all cases. 


Files 


No Caps, No Gaps 
Lower case filenames underscore between words. 


Sort Usefully 
Order naming with specific identifiers at the end. 


Format 


Use .png for images that have solid colors such as 
screenshots of the Blender interface, and .jpg for images 
with a high amount of color variance, such as sample 
renders and photographs. 


Do not use animated .gif files, these are hard to 
maintain, can be distracting and are usually large in file 
size. Instead use a video if needed (see Videos below). 


Location 


Place the image in the manual/images folder. Use no other 
subfolders. 


Naming 
For naming files use underscores to separate chapters 
and sections, and use dashes to separate sections that 
are two or more words. So for image files should look 
like: chapter subsection sub-subsection id.png, e.g: 


e interface splash current.png 
e interface undo-redo last.png 
e interface undo-redo repeat-history-menu.png 


Do not use special characters or spaces! 


Usage Guides 


e Avoid specifying the resolution of the image, so that the 
theme can handle the images consistently and provide 
the best layout across different screen sizes. 


e When documenting a panel or section of the UI, it is 
better to use a single image that shows all of the 
relevant areas (rather than multiple images for each 
icon or button) placed at the top of the section you are 
writing, and then explain the features in the order that 
they appear in the image. 


Note 


It is important that the manual can be maintained long 
term, UI and tool options change so try to avoid having 
a lot of images (when they are not especially 
necessary). Otherwise, this becomes too much of a 
maintenance burden. 


Videos 


Videos can be embedded from Blender’s self-hosted 
Peerlube instance which can be found at video.blender.org. 
To embed a video using the following directive: 


. peertube:: ID 
The ID is found in the video’s URL, e.g: 


The ID for https://video.blender.org/videos/watch/47448bc1- 
OccO-4bd1-b6c8-9115d8f7e08c IS 47448bc1-OccO-4bd1-b6c8- 
9115d8f7e08c. 


To get a new video uploaded, contact a Documentation 
Project Administrator or include the uploaded video in your 
Patch description. 


Usage Guides 


e Avoid adding videos that rely on voice or words, as this 
is difficult to translate. 

e Do not embed video tutorials as a means of explaining a 
feature, the writing itself should explain it adequately. 
(Though you may include a link to the video at the 
bottom of the page under the heading Tutorials). 


Useful Constructs 


e |BLENDER VERSION| - Resolves to the current Blender 
version. 

e :abbr:°SSAO (Screen Space Ambient Occlusion)* - 
Abbreviations display the full text as a tooltip for the 
reader. 

e :term: Manifold’ - Links to an entry in the Glossary. 


Cross References and Linkage 


You can link to another document in the manual with: 
:doc: The Title </section/path/to/file> 


To link to a specific section in another document (or the 
same one), explicit labels are available: 


. _Sample-Label: 


[section or image to reference] 


Some text :ref: Optional Title <sample-label> 


Linking to a title in the same file: 


Titles are Targets 


Body text. 


Implicit references, like “Titles are Targets” 


Linking to the outside world: 


“Blender Website <https://www.blender.org> _ 


Context Sensitive Manual Access 


It is possible to link to a specific part of the manual from in 
Blender by opening the context menu (right click) of a 
property or operator and selecting Online Manual. In order 
for this to work, this needs to be accounted for in the 
documentation. To link a property or operator to a specific 
part of the manual you need to add an external reference 
link tag whose ID matches Blender’s RNA tag. The easiest 
way to find out what the tag for a property is to open the 
context menu of the property/operator and select Online 
Python Reference to extract the tag from the URL. Some 
examples of how this looks in the RST document are given 
below: 


. _bpy.types.FluidDomainSettings.use fractions: 
Fractional Obstacles 
Enables finer resolution in fluid / obstacle regions (second 


order obstacles)... 


. _bpy.types.FluidDomainSettings. fractions distance: 


Obstacle Distance 
Determines how far apart fluid and obstacles are... 


For an operator: 
. _bpy.ops.curve. subdivide: 


Subdivide 


Further Reading 


To learn more about reStructuredText, see: 


Sphinx RST Primer 
Good basic introduction. 


Docutils reStructuredText Reference 
Links to reference and user documentation. 


Templates 


The following guide provides patterns for interface elements 
and directories. 


Operator Menus 


Each operator should receive its own heading or page based 
on the length of the content. At the start should be a 
reference admonition documenting the context of the 
operator: 


. admonition:: Reference 
:class: refbox 


:Mode: Edit Mode 
:Menu: :menuseLlection: Curve --> Snap- 
:Shortcut: :kbd: Shift-S° 


Panels 


Panels should be documented by their own heading, nested 
panels should use decreasing heading levels. Each panel 
could have its own page based on the length of 
documentation and/or the amount of panels. Expanded 
menus that toggle what properties are presented to the user 
should be treated like subpanels: 


Panel Title 


Properties 


Properties should be documented using definition lists. 
Properties that are hidden based on other properties should 
used nested definitions: 


Property 
Property description. 


Hidden Property 
Hidden property description. 


Select menus should be documented using the following 
syntax: 


Menu Label 
General description of the menu. 


:Menu Item: Menu Item Definition. 
:Menu Item: Menu Item Definition. 
:Menu Item: Menu Item Definition. 


Nodes 


Nodes should always have three headings inputs, properties 
and outputs with a note of absence if the node has none. At 
the end of the page can be an optional example(s) section: 


OK OK 2K OK OK 2K KK KK 


World Node 


3K OK 2K OK OK 2K KK KK 


. figure:: /images/render shader-nodes output world node.png 
:align: right 


The World node. 


Introduction and general use case(s). 


This node has no inputs. 


Properties 


This node has no properties. 


Outputs 


This node has no outputs. 


Example 


Directory Layout 


Sections should be generally structured as follows: 


e directory name/ 
o index.rst (contains links to internal files) 
o introduction.rst 
o section l.rst 
o section 2.rst 


For example: 


e rendering/ 
o index.rst 
°o cycles/ 
= index.rst 


# introduction.rst 

= materials/ 
= index.rst 
# introduction.rst 
=» volumes.rst 


The idea is to enclose all the content of a section inside of a 
folder. Ideally every section should have an index. rst 
(containing the TOC for that section) and an introduction. rst 
(introducing) to the contents of the section. 


Table of Contents 


By default, a table of contents should show two levels of 
depth: 


. toctree:: 
:maxdepth: 2 


introduction. rst 
perspective.rst 
depth of field.rst 


Maintenance 


Adding/Removing/Moving Files 


When RST-files are added or removed the corresponding 
locale files are added or removed automatically by the 
update script. However, if files need to be moved please use 
this Python script: 


python tools rst/rst_remap.py start 


RST-files can then be freely moved and the remap script will 
move the locale file after: 


python tools rst/rst_remap.py finish 


It is best to avoid moving/renaming files as this breaks URLs 
and without this script translators will lose all their work in 
these files. Please ask an administrator if you think 
something should be renamed/moved. 


Note 


This script also works for image file names. 


Release Checklist 


e Create a release branch (blender-3.2-release/) 
e Update the splash image: interface splash current.png in 
the release branch. 


e Increase the conf.py: blender version variable in the 
trunk version. 


Contribute 


On this page French (fr) is used for examples. However, it 
can be replaced with other languages codes. So, be sure to 
change the /fr suffixes in this guide to the language you are 
translating! 


To see which languages are currently available, you can 
browse the repository: 


https://developer.blender.org/diffusion/BMT/browse/trunk/ble 
nder_docs/locale 


Note 


First of all, it is assumed that you have the manual already 
building. If you have not done this already go back too the 
Getting Started section. 


Installing 


Language Files 


From the directory containing your checkout of the manual 
run: 


svn checkout https://svn.blender.org/svnroot/bf -manual - 
translations/trunk/blender docs/locale/fr locale/fr 


This will create a locale/fr Subdirectory. 


You should have a directory layout like this: 


blender docs 
|- locale/ 
| |- fr/ 
| |  |- LC _MESSAGES/ 
|- manual/ 


Note 


When running subversion from the command line (Such as 
updating or committing), you will need to change directory 
to locale/fr first. 


Otherwise you will get a warning: 'locale' is not under 
version control 


A PO Editor 


To make edit the PO files you will need to install a PO editor. 
We recommended that you use Poedit however, any PO 
editor will do. 


Note 


For Linux users, you will have to check with your 
distribution’s software center for a version of Poedit. This 
editor is only a recommendation. There are others, such as 
Kate and Kwrite, that could offer syntax highlighting and 
basic tools for text editing, e.g. letter case transposes. 
Other platforms can use some text editors supporting the 
syntax highlighting for PO files, or allowing you to create a 
custom one (such as Notepad++ on Windows). 


Building with Translations 


Now you can build the manual with the translation applied: 


On Linux and macOS run: 


make -e BF_LANG=fr 


On Windows run: 


set BF_LANG=fr 
make html 


Now you will have a build of the manual with translations 
applied. 


Editing Translation Files 


Now you can edit the PO translation files, in the LC_MESSAGES 
folder you have two files: 


e blender manual.po - This is the main translation file that 
you will be editing. 

e sphinx.po - This translation file is much smaller and 
contains translations for the website theme. 


To edit these files open them up in your translation editor, 
i.e. Poedit. Once in your editor you will see a list of texts, 
each of these items represent some part of the user 
manual. You may need to adjust your editor to sort the list in 
a way that makes sense for example “by source”. 


You can now select an untranslated string and your editor 
will have an input box to add the translation. The modified 
.po files can now submitted as a patch or committed back to 
SVN. 


Tip 


Make sure that you Building with Translations to catch any 
syntax errors you may make while translating. These 
errors will be displayed as warnings while building the 
manual. 


Commit Translation Files 


See Submit Patches. 


Maintenance 


Keeping Track of Fuzzy Strings 


When the manual is updated, those translations which are 
outdated will be marked as fuzzy. To keep track with that, 
you can use a tool we created for that task. 


You can do this by running: 
make report po progress 


This will only give a quick summary however, you can get 
more information by running: 


python tools report/report translation progress.py locale/fr/ 


You should get a list of all the files with information about 
the number of empty and fuzzy strings. For more options 
see: 


python tools report/report translation progress.py --help 


Updating PO Files 


As the original manual changes, the templates will need 
updating. Note, doing this is not required, as administrator 
usually update the files for all languages at once. This 
allows all languages to be on the same version of the 
manual. However, if you need to update the files yourself, it 
can be done as follows: 


make update po 


The updated templates can then be committed to svn. 


See also 


A guide how to add a new language can be found in the 
Adding_a Language. 


Style Guide 


This page covers conventions concerning the translations. 


Note 


e We expect our readers to use the English version of 
Blender, not a translated one. 

e The translations are licensed under the same License 
as the original. 


Should | Translate... ? 


Maybe 


Hyperlinks 
Can be translated, but only as an addition, not as a 
replacement. See also Adding Text. 


Technical Terms 
Only translate these, when the localized expression is 
common! See also Technical Terms. 


Text you are not sure you understood 
Simply mark the text as fuzzy and/or add a comment. 
The next translator might understand it. 


Never 


Images 


You probably will not find the original scene if it is a 
screenshot of a file and it is too much load on the server 
(and too much work for you). 


Menu and button names 
We expect our readers to use the English UI. 


Text you do not understand 
Do not translate it! It will do more harm than good! 


Technical Terms 


In general, the technical terms used in computer graphics 
are quite new or even downright neologisms invented for 
the needs, so they do not always have a translation in your 
language. Moreover, a large part of Blender users use its 
English interface. 


As a result, unless a term has an evident translation, you 
should preferably use the English one, putting it in italic. You 
can then find a translation for it, which you will use from 
times to times (e.g. to avoid repetitions...). This is also valid 
in the other way: even when a term has a straightforward 
translation, do not hesitate to use its English version from 
times to times, to get the reader used with it... 


If a term is definitively not translatable, simply use the 
English one, but make sure its glossary entry is translated. 


In the glossary, the English term is written first (to maintain 
alphabetic order) with the translated entry following in 
parenthesis, when appropriate. 


Adding Text 


Generally, you should always translate exactly what is 
in the text, and avoid providing updates or extra 
information. 


But sometimes that is necessary, for example when talking 
about the manual itself: To a foreign reader it is not clear, 
that they can contribute English text only, whereas this is 
obvious to an English reader. 


In these (rare) cases you can and should provide extra 
information. 


Keeping Pages Up To Date 


When the manual is updated, those translations which are 
outdated will be marked as fuzzy. To keep track with that, 
you can use a tool we created for that task, see How to 
install it. 
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Not Found (404) 


It seems the page you are trying to find has been either 
moved or deleted. 
You can try one of the following things: 


Quick search 


Cr 


License 


Blender itself is released under the GNU General Public 
License. More info blender.org/about/license. 


Except where otherwise noted, the content of the Blender 
Manual is available under a Creative Commons Attribution- 
ShareAlike 4.0 International License or any later version. 
Excluded from the CC-BY-SA are also the used logos, 
trademarks, icons, source code and Python scripts. 


Please attribute the “Blender Documentation Team” and 
include a hyperlink (online) or URL (in print) to manual. For 
example: 


The Blender 3.4 Manual 


by the Blender Documentation Team 
is licensed under a CC-BY-SA v4.0. 


See Best practices for attribution for further explanation. 


It means, that when contributing to the manual you do not 
hold exclusive copyright to your text. You are, of course, 
acknowledged and appreciated for your contribution. 
However, others can change and improve your text in order 
to keep the manual consistent and up to date. 


If you have questions about the license, feel free to contact 
the Blender Foundation: foundation (at) blender (dot) org 


Previous versions of the Blender Manual are made available 
under an Open Content License v2.26 - v2.77. 


Adding a Language 


Preparations 


If the language you want to translate has not been started 
by someone else already and you wish to create a set of 
new files for the desired language, say ‘fr’ (French), then 
you must first use the environment you have created, as 
guided in Getting Started, in particular Installing 
Dependencies and Building the Manual sections. 


This will give you a foundation environment for: 


e Creating a new set of translation language from English 
source. 

e Perform make command to turn translated texts in po 
files into html files for testing locally. 

e Update changes in English texts which have been added 
by other contributors. 


Below examples show the process to create a new Set of 
files for French, language code fr, on Linux platform. Other 
platforms might vary slightly but should be mainly the 
same. 


1. Goto https://developer.blender.org to create an account 
for yourself and become a developer/translator for the 
Blender organization. 

2. Login the account and create a task with todo type, 
addressing an administrator in the Subscribers field, 
requesting for a committer right in order to transfer 
changes to the central repository of the translation 
team. 


3. Open an instance of the console application, such as 
Gnome-Terminal emulator. 

4. Change the current working directory to the directory of 
blender docs, where the instance of Makefile resides. 


Trying the Make Process to 
Create HTML Files in English 


1. Ensure the previous instance of build directory is 
removed, if any exists: 


make clean 

2. Convert all the rst files into pot translation files: 
make gettext 

3. Create htm files: 
make html 


4. After this, you can actually view the created html files 
locally following the prompted instruction, such as: 


xdg-open <path to your English 
manual>/blender_ docs/build/html/index.html 


Creating the Language Entry in 
the HTML Menu 


1. Create an entry for the language in the htm! menu by 
opening file ./resources/theme/js/version switch.js 
(assuming you are at the blender docs subdirectory). 


2. Find the table for the languages in var all_langs = {..};. 


3. Enter the entry: "fr": "Fran&ccedil;ais",, ("fr": 
"Francais"). (Notice the Unicode characters.) 


4. To find out about changes in the local repository: 
svn status 
5. Enter your password: 
Svn commit --username <your username> -m “your comment" 


6. Bring your local repository up to the most recent version 
of changes, including the one you have just done: 


Svn update . 


Setting the Local Configuration 
File 
1. Open a text editor to enter the following texts, change 


the language code to whatever the language you will be 
translating: 

1 Language = '‘fr' 

2 locale dirs = ['locale/'] 

3 gettext compact = True 


2. Save this file aS conf.py in the blender docs directory, 
where Makefile resides. 


3. Tells svn to ignore this file when performing operations 
by executing this shell command: 


Svn propset svn:ignore conf.py . 


Generating the Set of Files for 
the Target Language 


1. Check out the current translation repository using the 
command: 


svn checkout https://svn.blender.org/svnroot/bf -manual - 
translations/trunk/blender docs/locale 


This will download all language sets available in the 
repository into the locale directory of your drive. You can 
go to the locale directory to see the hidden subdirectory 
.svn within it, together with directories of languages. 
You'll need to add your own set of files for the language 
you are trying to translating to. 


2. From the blender docs directory to generate a set of files 
for fr language: 


make gettext 
sphinx-intl update -p build/gettext -l fr 


These files are still in English only, with all msgstr entries 
blank. 


3. Submit new set of files to the central repository: 


cd locale 

svn add fr 

svn commit --username <your username> -m "Initial commit 
language set of files for French" 


4. You don’t need all other languages being there, so 
remove the locale directory for the time being: 


rm -fr locale 


We will download this new set of language as guided in 
the next section. 


Note 


e It is recommended you make two environment 
variables for these directories, in the .bashrc to make it 
more convenient for changing or scripting batch/shell 
commands for the process of translation and reviewing 
results: 


export BLENDER MAN EN=$HOME/<directory to make file 
directory above>/blender docs 
export BLENDER MAN FR=$BLENDER MAN EN/locale 


e Newly generated files will contain some placeholders 
for authors and revision dates etc. If you find the job of 
replacing them repetitive, make use of the script 
change _placeholders.sh in the subdirectory 
~/blender_docs/toos maintenance, make a copy of that to 
your local bin directory and replace all values that were 
mentioned in the file with your specific details, then 
after each change to a file, you would do following 
commands to update the file with your personal 
details, revision date and time, plus generating the 
html files for your language, which you can view using 
your Internet browser: 


$HOME/bin/change placeholders.sh $BLENDER MAN FR 
make -d --trace -w -B -e SPHINXOPTS="-D language='fr'" 
2>&1 


Getting Started 


e About Blender 
o Introduction 


o Blender’s History 
o About Free Software and the GPL 


o The Blender Community 
Installing Blender 

o System Requirements 

o Download Blender 
Configuring_Blender 

o Introduction 

o Configuring_Peripherals 

o Defaults 
e Help System 
Tooltips 
Context-Sensitive Manual Access 
Help Menu 
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Important 


This feature is currently experimental and not available in 
current releases. 


Point Cloud 


Point clouds can be used to represent 3D scans and in the 
future can represent particles. Each point can store data ina 


set of Attributes. 


Example of a monkey object represented as a point 
cloud. 


Properties 


Attributes 


The Attributes panel contains different point cloud 
characteristics such as the position and size of points. Use 
the List View to manage attributes. 


Attribute Types 


See also 


See Built-In Attributes for information about common 


attributes. 


Name Type Domain Notes 


position Vector Point 


radius Float Point 


color Color Point 


id Integer Point 


velocity Vector Point 


Custom Attributes 


Built-in attribute describing 
vertex or point locations, in the 
modifier object’s transform 
Space. 


The radius of each point. 


The color of each point. 


A unique identifier given to 
each particle. 


The speed and direction that 
the particle is traveling. 


Custom attribute can be given to particles to hold a 
custom characteristic. 


Name 
The name of the attribute. 


Data Type 
The type of data to store in the attribute. 
Float: Floating-point value 
Integer: 32-bit integer 
Vector: 3D vector with floating-point values 
Color: RGBA color with floating-point 
precision 
Byte Color: RGBA color with 8-bit precision 
String: Text string 
Domain 


The type of element the attribute is stored in. 
Currently, attributes can only be stored per Point. 


Custom Properties 


See the Custom Properties page for more information. 


Editing 


Currently, not much can be done with point clouds; 
however, they can be converted to/from meshes. 
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Geometry 


2D Offset 
2D Transform 
Backbone Stretcher 
Bezier Curve 
Blueprint 
Guiding Lines 
Geometry Modifiers 
o 2D Offset 
2D Transform 
Backbone Stretcher 
Bézier Curve 
Blueprint 
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Polygonization 
Sampling 
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On macOS graphics drivers are built into the operating 
system and the only way to get newer drivers is to upgrade 
macOS as a whole to the latest version. 


Blender uses of OpenGL for the 3D Viewport and user 
interface. The graphics card (GPU) and driver have a big 
impact on Blender’s behavior and performance. 


This section lists possible solutions for graphics glitches, 
problems with Eevee and Cycles, and crashes related to 
your GPU. 


Drivers 


Upgrading to the latest graphics drivers often solves 
problems. Newer drivers have bug fixes that help Blender 
function correctly. 


Laptops 


Laptops often have two GPUs for power saving purposes. 
One slower onboard GPU (typically Intel) and one faster 
dedicated GPU for a better performance (AMD or Nvidia). 


For the best performance the dedicated GPU should be used 
for Blender. Which GPU to use for which application can be 
configured in your graphics driver settings. 


If there is a graphics glitch or crash specific to the onboard 
GPU, then using the dedicated GPU can help avoid that. Or 
vice versa, if the dedicated GPU causes issues, then using 

the onboard graphics can help. 


Common Problems 


Unsupported Graphics Driver 
Error 


This means your graphics card and driver do not have the 
minimum required OpenGL 3.3 version needed by Blender. 


Installing the latest driver can help upgrade the OpenGL 
version, though some graphics cards are simply too old to 
run the latest Blender. Using Blender 2.79 or earlier is the 
only option then. 


Crash on Startup 


Try running Blender from the command line, to see if any 
helpful error messages are printed. 


On Windows, graphics drivers can sometimes get corrupted. 
In this case it can help to uninstall all graphics drivers (there 
may be multiple from Intel, AMD and Nvidia) and perform a 
clean installation with drivers from the manufacturer’s 
website. 


Poor Performance 


e Update your graphics drivers (see above). 
e On laptops, make sure you are using a dedicated GPU 
(see above). 


e Try lowering quality settings in Preferences » System » 
Memory & Limits. 

e Try undoing settings in your graphics drivers, if you 
made any changes there. 


Render Errors 


See Eevee and Cycles documentation respectively. 


Wrong Selection in 3D Viewport 


See Invalid Selection, Disable Anti-Aliasing. 


Virtual Machines 


Running Blender inside a virtual machine is known to have 
problems when OpenGL drawing calls are forwarded to the 
host operating system. 


To resolve this, configure the system to use PCI 
passthrough. 


Information 


To find out which graphics card and driver Blender is using, 
use Help > Save System Info inside Blender. The OpenGL 
section will have information about your graphics card, 
vendor and driver version. 


